Controlar Restorm por MCP

Restorm expone un servidor MCP (Model Context Protocol). Un agente de IA —Claude Code, Cursor o cualquier cliente MCP— puede, por tanto, leer su proyecto, crear y ejecutar peticiones y manejar la interfaz.

Es lo que permite pedir «importa este Swagger, crea un escenario que pruebe el recorrido de pedido y ejecútalo» y obtener un resultado verificable, en una aplicación que usted mantiene a la vista.

Activación

El servidor está activado por defecto. Dos gobernanzas:

• el ajuste Ajustes ▸ MCP ▸ Activar el servidor MCP;
• una regla absoluta: en una máquina sin pantalla, el servidor MCP nunca arranca, sea cual sea el ajuste. Un servidor de CI no acaba, por tanto, exponiendo un punto de entrada.

El indicador MCP de la barra de estado parpadea con cada llamada entrante. Su menú emergente permite suspender o reanudar el servidor durante la sesión y abrir los registros MCP.

Conectar su asistente de IA

Al arrancar, Restorm elige un puerto libre, genera un token de acceso propio del proceso y escribe un archivo de descubrimiento en el directorio temporal del sistema. El servidor JSON-RPC escucha en 127.0.0.1:<port>/mcp, solo en bucle local: cualquier llamante externo recibe un 403.

Usted nunca copia ese puerto ni ese token. Un pequeño lanzador hace de puente entre la entrada y la salida estándar de su cliente MCP y el servidor HTTP de Restorm: encuentra la instancia en ejecución, inyecta el token y reenvía sus llamadas. Responde al instante a initialize y tools/list desde un manifiesto integrado, de modo que su cliente arranca rápido sin esperar a que Restorm se inicie, y luego sirve la lista de herramientas real en cuanto pasa una llamada. Nunca arranca Restorm en silencio: una instancia en la que usted haya cortado el servidor MCP permanece cortada, con un mensaje de error claro.

Lo que concede conectar una IA

Conectar un asistente a Restorm le concede acceso completo a sus herramientas de Restorm en su nombre: ejecutar peticiones contra objetivos reales, leer y escribir su proyecto y (en Pro) las herramientas de automatización y de git. Las peticiones usan sus secretos resueltos, exactamente igual que cuando usted mismo maneja Restorm. El token de descubrimiento es propio de la instancia y solo lo puede leer su usuario local. Conecte únicamente asistentes de confianza y mantenga activadas las solicitudes de aprobación de su cliente MCP.

Lo más sencillo — desde la aplicación

La vía más rápida no necesita ninguna configuración manual. Abra el menú emergente del indicador MCP (barra de estado) y haga clic en «Añadir Restorm a su asistente de IA». Un cuadro de diálogo presenta, cliente por cliente, la única línea que hay que copiar:

• Claude Code — el comando claude mcp add …, acompañado de un botón «Añadir a Claude Code» que lo ejecuta por usted cuando se detecta la CLI claude en su PATH;
• Claude Desktop y Cursor — el bloque mcpServers que hay que pegar, con la ubicación del archivo de configuración.

Restorm nunca escribe el archivo de configuración de otra aplicación: el botón de ejecución solo maneja su propia CLI claude. Para los demás clientes, pega usted mismo el fragmento.

El plugin de Claude Code

Claude Code también puede instalar Restorm como plugin, desde nuestro marketplace autoalojado:

/plugin marketplace add Monsieur-Dev/restorm
/plugin install restorm@restorm-marketplace

El plugin registra el servidor MCP restorm (se apoya en npx -y restorm-mcp): nada más que configurar.

La configuración manual

¿Prefiere escribir usted mismo la configuración o usa otro cliente? Las opciones de más abajo cubren todos los casos.

Requisitos previos

• El servidor MCP está activado: lo está de forma predeterminada (Ajustes ▸ MCP). En una máquina sin pantalla nunca arranca, diga lo que diga el ajuste.
• Hay una instancia de Restorm en ejecución: el lanzador se conecta a su aplicación en ejecución, no crea ninguna.
• Node.js ≥ 18 para el método npx de más abajo.

Opción A — npx restorm-mcp (recomendado)

Sin instalación, sin ruta que gestionar, funciona con cualquier cliente y en cualquier sistema operativo. Apunte su cliente a él:

{
  "mcpServers": {
    "restorm": {
      "command": "npx",
      "args": ["-y", "restorm-mcp"]
    }
  }
}

Dónde va ese fragmento depende de su cliente:

• Claude Desktop — Ajustes ▸ Desarrollador ▸ Editar configuración, o el archivo claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).
• Cursor — Ajustes ▸ MCP ▸ Añadir, o ~/.cursor/mcp.json.
• Claude Code — claude mcp add restorm -- npx -y restorm-mcp, o un .mcp.json en su proyecto.

macOS: no se encuentra node desde una app con interfaz gráfica

En macOS, las aplicaciones con interfaz gráfica (Claude Desktop, Cursor…) no heredan el PATH de su terminal. Si node no está instalado en una ubicación estándar, el cliente no consigue iniciar el servidor y muestra env: node: No such file or directory, incluso con una ruta absoluta a npx, porque npx vuelve a lanzar node a través del PATH. La solución más fiable es la Opción B de más abajo: apunte node —con una ruta absoluta si hace falta— directamente al lanzador incluido, evitando npx.

Opción B — el lanzador incluido en la aplicación (sin npm)

Cada instalación de Restorm incluye el mismo lanzador como recurso empaquetado, de modo que puede apuntar node directamente a él, sin npm:

{
  "mcpServers": {
    "restorm": {
      "command": "node",
      "args": ["<path-to>/restorm-resources/mcp-launcher.mjs"]
    }
  }
}

<path-to> es el directorio de recursos de la aplicación:

• macOS — /Applications/Restorm.app/Contents/Resources/restorm-resources/mcp-launcher.mjs
• Windows — %LOCALAPPDATA%\Programs\restorm\resources\restorm-resources\mcp-launcher.mjs
• Linux — /opt/Restorm/resources/restorm-resources/mcp-launcher.mjs (.deb/.rpm); dentro de la imagen montada para un AppImage; $SNAP/resources/restorm-resources/mcp-launcher.mjs para el Snap.

Opción C — HTTP directo

Lea el puerto y el token en el archivo de descubrimiento y después envíe sus peticiones JSON-RPC con una cabecera Authorization: Bearer <token>.

Dónde busca el lanzador

El lanzador y la aplicación deben coincidir en el directorio de descubrimiento. Ambos usan de forma predeterminada restorm-mcp bajo el directorio temporal del sistema; si define la variable de entorno RESTORM_MCP_DIR, asígnele el mismo valor en ambos lados (solo hace falta si Restorm se ejecuta bajo un gestor de servicios con un directorio temporal distinto).

Varias instancias

Pueden ejecutarse varios Restorm en paralelo. Cada llamada acepta una clave reservada __session para designar la instancia a la que se dirige. Las herramientas list-instances, create_instance y terminate_instance completan el cuadro.

Las familias de herramientas

Lectura · navegación · proyecto · escritura · entornos y secretos · importación · ejecución · escenarios · instancias · automatización de la interfaz (captura de pantalla, consulta del DOM, entrada de texto, atajos, temas, disposición).

También se exponen cuatro recursos: restorm://project, restorm://tree, restorm://active-tab y restorm://request/{id}.

Inventario completo: Herramientas MCP.

Qué es gratuito y qué es Pro

El servidor MCP en sí nunca está restringido. Cada herramienta comprueba su propia capacidad en el momento de la llamada.

• Edición Community — todo el control de las peticiones: ejecutar, cancelar, leer las respuestas y el historial, leer flujos, enviar mensajes, importar desde una URL, abrir y cerrar pestañas, gestionar los proyectos, escribir en el árbol, gestionar los entornos y las variables, los ajustes rápidos, los favoritos y las seis herramientas de cortafuegos.
• Edición Pro — el dominio de los escenarios (incluida la lectura), las capturas, toda la automatización de la interfaz, los temas, el mininavegador, la disposición del workbench, las instancias múltiples y las herramientas git.

Una herramienta restringida sigue apareciendo en la lista —su título lleva el sufijo (Restorm Pro)— y devuelve un error explícito y legible por la máquina en lugar de desaparecer.

Seguridad

• Bucle local y token: el servidor solo escucha en 127.0.0.1, y el token se compara en tiempo constante.
• Secretos: un agente recibe el valor resuelto de un secreto, igual que el resto de la aplicación: pilota Restorm en su nombre, con sus propios secretos. Lo que garantiza el tipo Secreto sigue siendo cierto: el valor no viaja ni al proyecto, ni a una exportación, ni a un servicio de terceros no autorizado.
• Efectos de red reales: run_request llama de verdad al destino. Es el flujo de aprobación de su cliente MCP el que desempeña el papel de barrera de seguridad: manténgalo activo.
• El cortafuegos se aplica: una llamada desencadenada por un agente hacia un origen desconocido provoca la misma solicitud de autorización que la suya.
• Registro: cada llamada aparece en los registros MCP, con su petición y su respuesta.