Servidor MCP

MCP  es un estándar abierto que los asistentes de IA usan para llamar a herramientas externas. Puede conectarse cualquier cliente MCP compatible con el transporte Streamable HTTP. El asistente trabaja en la aplicación que usted tiene abierta: los proyectos que edita y las ejecuciones que inicia aparecen en el diagrama, y el asistente ve los cambios que usted hace en la ventana.

Algunos ejemplos de peticiones:

Abre ~/Projects/Acme/Acme.babel, activa el proxy dinámico y la generación del archivo map para Acme.exe, ejecuta la ofuscación y dime si hay advertencias.

Añade Acme.Core.dll al proyecto y combínalo con Acme.exe; después muéstrame las estadísticas de renombrado de la siguiente ejecución.

Descodifica la traza de pila de crash.txt con Acme.exe.map.xml y dime cuál de mis métodos lanzó la excepción.

Muéstrame las licencias que caducan en los próximos 30 días y los clientes a los que pertenecen.

Cambia la interfaz al tema Copper Night y haz una captura de pantalla del panel.

¿Qué hace el proxy dinámico? Si tiene sentido para Acme.exe, actívalo y explícame por qué.

Habilitar el servidor

El servidor está desactivado de forma predeterminada y no escucha hasta que se habilita.

Los cambios se aplican de inmediato. Al desmarcar Habilitar el servidor de automatización, el servidor se detiene; al cambiar el puerto o el token, se reinicia y desconecta a los clientes conectados. La paleta de comandos ofrece además MCP: iniciar servidor local (lectura/escritura del proyecto), MCP: detener servidor local, MCP: mostrar estado y MCP: mostrar archivo de configuración del cliente.

Conectar un cliente

La sección Configuración del cliente de los ajustes de MCP genera una configuración para el puerto y el token actuales. Haga clic en Copiar configuración y péguela en la configuración MCP de su cliente:

{
  "mcpServers": {
    "babel-obfuscator": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": {
        "X-Babel-Token": "paste-the-token-from-settings-mcp"
      }
    }
  }
}

Si no se exige un token, el bloque headers se omite. Mostrar archivo… muestra el archivo de configuración que Babel Desktop escribe para el servidor en ejecución.

Para Claude Code, haga clic en Copiar comando de Claude Code y ejecute en un terminal el comando copiado:

claude mcp add --transport http babel-obfuscator http://127.0.0.1:8765/mcp \
  --header "X-Babel-Token: paste-the-token-from-settings-mcp"

Inicie primero Babel Desktop y después el asistente. Para comprobar la conexión, pida al asistente que haga una captura de pantalla de la ventana de Babel Desktop.

Qué puede hacer el asistente

El servidor ofrece las funciones de la aplicación como herramientas MCP, agrupadas de este modo:

Los nombres de los ajustes son los nombres de las opciones de Babel Obfuscator que se muestran en el panel de propiedades, así que el asistente puede usar la referencia de la tarea Babel para elegir los valores. No hace falta nombrar las herramientas. Describa el resultado que quiere y el asistente las elige.

Cambios confirmados

Las operaciones que podrían hacer perder trabajo o sobrescribir archivos se realizan en dos pasos. El asistente prepara primero la operación y recibe una propuesta que describe lo que va a ocurrir, por ejemplo qué archivos de salida reemplazará una ejecución o qué registro quitará una eliminación. El asistente tiene que mostrarle la propuesta y obtener su aprobación antes de confirmar la operación. Una propuesta caduca a los dos minutos y solo puede usarse una vez. Se rechaza si el proyecto, los archivos o el registro han cambiado desde que se creó.

La confirmación en dos pasos se aplica a:

• crear un proyecto nuevo, reemplazar una entrada, quitar un destino, editar el grafo y las dependencias, e iniciar una ejecución (obfuscate_start devuelve una propuesta);
• los comandos de configuración: la combinación en el ensamblado principal, la ofuscación pública y el nivel de protección de un destino;
• instalar y desinstalar extensiones y quitar un perfil de conexión de gestión de licencias;
• crear, editar, revocar y eliminar registros de gestión de licencias (licensing_prepare y licensing_confirm).

Para cambiar ajustes o reglas XML hace falta la revisión actual del proyecto, lo que impide que un asistente sobrescriba cambios que no ha visto.

Ejecuciones de ofuscación

Una ejecución que inicia el asistente no se diferencia de una que inicia usted en la ventana. Escribe la salida en las mismas ubicaciones, informa del progreso en el panel Actividad y puede cancelarse desde cualquiera de los dos lados. El asistente consulta obfuscate_status periódicamente hasta que la ejecución termina y después lee las estadísticas con results_read y results_table. Mientras hay una ejecución activa, el proyecto no puede modificarse.

Gestión de licencias

Las herramientas de gestión de licencias actúan sobre los perfiles de conexión de gestión de licencias, con los roles y los permisos de la clave API del perfil. Solo se pueden crear, editar y eliminar registros mediante un perfil de prueba local con el modo de acceso de gestión local; los perfiles remotos y los de solo lectura rechazan cualquier cambio. Las respuestas omiten los datos secretos, como las claves de licencia, las claves API, los tokens y las direcciones IP. Las herramientas del panel solo devuelven datos agregados.

Lo que queda en la ventana

El asistente no puede hacer lo siguiente, que le corresponde a usted en la ventana:

• introducir credenciales: iniciar sesión con una clave API y generar el token de MCP;
• responder a las solicitudes de contraseña durante una ejecución y descodificar trazas de pila con archivos map protegidos con contraseña;
• iniciar y detener el propio servidor MCP.

Herramientas de documentación de Babel

El servidor también pone a disposición del asistente la documentación que está leyendo. Cuando usted pregunta cómo funciona algo o cómo se hace, el asistente busca en la documentación, lee la sección pertinente y responde con enlaces a las páginas que ha usado, antes de cambiar ningún ajuste. El servidor indica a los clientes conectados que trabajen así, por lo que no hace falta nombrar las herramientas.

Las herramientas de documentación solo leen, y solo se conectan a https://docs.babelfor.net. La búsqueda se ejecuta en su equipo: su pregunta no se envía al sitio de la documentación. Las herramientas descargan el índice de búsqueda y las páginas que leen, que son los mismos archivos públicos que se describen en Uso de la documentación con IA.

Algunos ejemplos de peticiones:

¿Cómo excluyo un tipo del renombrado con reglas XML? Cambia las reglas de este proyecto en consecuencia.

Busca en la documentación de Babel Licensing cómo debe liberar mi aplicación una licencia flotante al cerrarse.

Lee la página Descodificador de pila y explícame qué archivo map necesito para una compilación de release.

Uso sin conexión y actualizaciones

Babel Desktop guarda el índice y las páginas descargados en una carpeta docs-cache de su perfil de usuario.

• Se comprueba si el índice ha cambiado como máximo una vez cada 24 horas. Una página solo se descarga de nuevo cuando ha cambiado en el sitio.
• Para obtener antes la versión más reciente, pida al asistente que actualice la documentación. Las herramientas aceptan refresh: true para ello.
• Sin conexión de red, las herramientas responden con la copia en caché y marcan el resultado como desactualizado, con la fecha de la copia.
• Después de un fallo de conexión o de un error del sitio, las herramientas usan la caché durante 10 minutos antes de volver a intentarlo con el sitio.

Seguridad

• El servidor está desactivado de forma predeterminada y solo escucha después de habilitarlo.
• Se enlaza a 127.0.0.1, de modo que otros equipos no pueden acceder a él.
• Con Exigir un token de acceso activado, se rechaza toda solicitud que no lleve la cabecera X-Babel-Token correcta.
• El tamaño de las solicitudes, las sesiones, las conexiones y los tiempos de espera están limitados, y se validan el host y el origen de cada solicitud.
• Ninguna herramienta ejecuta comandos, SQL ni URL arbitrarios.
• Las herramientas de documentación solo se conectan a https://docs.babelfor.net, sin seguir redirecciones, y solo leen.

El asistente tiene el mismo acceso a sus proyectos y archivos que usted tiene en Babel Desktop. Puede cambiar los ajustes del proyecto, ejecutar ofuscaciones y, previa confirmación, reemplazar archivos de salida. Si deja que un asistente explore libremente, dele una copia del proyecto, y desactive el servidor cuando no lo esté usando.

Solución de problemas

El Babel Licensing Service tiene su propio servidor MCP, que trabaja de forma remota con la API del servicio; consulte Integración con IA para ver una comparación.