MCP, REST y el Agente integrado

Eidograph ofrece tres vías para agentes, todas terminando en la misma superficie de herramientas:

Vía	Ideal para	Disponible en
Agente integrado	Cambios en lenguaje natural sobre el proyecto actual	Aplicaciones de Windows y Android
MCP Streamable HTTP	Plataformas de agentes con soporte de MCP remoto por HTTP	Aplicación de Windows
API REST JSON	Scripts, flujos de trabajo y agentes personalizados	Aplicación de Windows

Antes de que una herramienta cambie un script, Eidograph compila el candidato. Una edición con errores de compilación o con una advertencia de comando omitido se rechaza y el script actual queda sin cambios. Las ediciones exitosas se guardan, se vuelven a dibujar y entran de inmediato en el historial de deshacer normal.

Habilitar el servidor nativo

1. En la aplicación instalada, abre Ajustes › Servidor MCP / REST.
2. Activa el servidor y confirma que su estado es en ejecución. El puerto predeterminado es 14159.
3. Habilita solo las herramientas que el cliente necesite.
4. En Figuras, revisa el punto de exposición junto a cada figura. Un punto relleno significa que los clientes externos pueden acceder a ella.
5. Mantén el enlace de solo bucle local predeterminado salvo que estés en una red de confianza.

Endpoints predeterminados:

MCP   http://127.0.0.1:14159/mcp
REST  http://127.0.0.1:14159/api/v1

DANGER

El modo LAN se enlaza a 0.0.0.0 y no tiene retransmisión por internet. Los clientes nativos de esa red pueden invocar las herramientas que hayas habilitado, así que activa un token de acceso antes de activar el modo LAN, úsalo solo en una red de confianza y desactívalo después.

Exigir un token de acceso

El servidor no exige autenticación de forma predeterminada, algo bastante seguro mientras se mantiene en loopback: solo pueden alcanzarlo los programas que ya se ejecutan en tu PC. Activa Configuración › Servidor MCP / REST › Exigir un token de acceso —siempre antes de habilitar el modo LAN— y Eidograph genera un secreto que toda solicitud debe llevar:

Authorization: Bearer <token>

Las solicitudes sin esa cabecera reciben 401. La configuración muestra el token con un botón de copia, Sustituir el token lo rota y desactivar el interruptor lo borra. Ambas cosas surten efecto de inmediato, así que actualiza todos los clientes que hayas configurado.

Encontrar el servidor desde otro programa

El puerto es una opción, de modo que nada fuera de la aplicación puede darlo por supuesto. Mientras el servidor escucha, Eidograph publica un archivo de descubrimiento y lo elimina cuando el servidor se detiene o la aplicación se cierra:

Plataforma	Ruta
Windows	%LOCALAPPDATA%\eidograph.metaphor.projects\server.json
macOS	~/Library/Application Support/eidograph.metaphor.projects/server.json
Linux	$XDG_DATA_HOME/eidograph.metaphor.projects/server.json

{
  "version": "0.2.19",
  "pid": 24680,
  "updatedAt": 1757000000000,
  "bindAddress": "127.0.0.1",
  "port": 14159,
  "mcp": "http://127.0.0.1:14159/mcp",
  "api": "http://127.0.0.1:14159/api/v1",
  "token": "3f9c…",
  "lanAddresses": []
}

Lee mcp o api y envía token como token bearer; es null cuando no se exige ninguno. Las URL publicadas permanecen en loopback incluso en modo LAN, porque todo lector de este archivo está en la misma máquina. Configuración › Servidor MCP / REST muestra y copia la ruta exacta. Trata la ausencia del archivo como «el servidor no está en marcha» en lugar de recurrir a un puerto adivinado.

Claude Desktop

Claude Desktop instala los servidores MCP como procesos stdio locales, así que no admite pegar una URL HTTP. Instala la extensión eidograph-mcpb para unir ambos mundos: no necesita configuración, encuentra por sí sola el puerto y el token de acceso, y los relee en cada solicitud. Consulta Claude Desktop para la instalación paso a paso con capturas de pantalla, y cómo apuntarla a un Eidograph que se ejecuta en otro dispositivo.

Conectar una plataforma MCP

Para un cliente compatible con Streamable HTTP —incluida la configuración de Trae / WorkBuddy que copia la aplicación—, añade este servidor:

{
  "mcpServers": {
    "Eidograph": {
      "url": "http://127.0.0.1:14159/mcp",
      "transport": "streamable-http",
      "disabled": false
    }
  }
}

Las plataformas difieren en la ubicación del archivo de configuración y en el esquema externo, pero los valores esenciales son el nombre del servidor, la URL y el transporte Streamable HTTP. Si una plataforma solo admite un proceso MCP local stdio, no pongas esta URL en su campo command; usa un conector HTTP o un puente compatible con esa plataforma.

Tras conectar, deja que el cliente descubra las herramientas y luego lea el script actual o el registro de comandos. Una secuencia fiable para un agente es:

1. list_figures para confirmar el objetivo;
2. get_script y list_objects para entender la figura actual;
3. list_commands para inspeccionar la sintaxis válida del dialecto 2D/3D activo;
4. append_commands para cambios aditivos, y set_script solo cuando haya que reescribir líneas existentes;
5. list_diagnostics para verificar el resultado y corregir cualquier problema.

Llamar a la API REST

Comprueba primero el estado y el descubrimiento de herramientas:

curl http://127.0.0.1:14159/api/v1/status
curl http://127.0.0.1:14159/api/v1/tools

Crea dos puntos y un segmento:

curl -X POST http://127.0.0.1:14159/api/v1/tools/append_commands \
  -H "Content-Type: application/json" \
  -H "X-Eidograph-Client: my-agent" \
  -d '{"commands":"point A -2 0\npoint B 2 0\nsegment s A B"}'

Las respuestas usan un único envoltorio: {"ok":true,"result":...} en caso de éxito o {"ok":false,"error":...} en caso de fallo. La cabecera opcional X-Eidograph-Client proporciona al llamador un nombre legible en la actividad de Ajustes.

La superficie actual puede leer y listar figuras, crear figuras, añadir o reemplazar scripts, listar objetos/diagnósticos/comandos, seleccionar un objeto en el lienzo y exportar una figura expuesta como SVG, PNG, GIF o MP4. Los permisos de herramientas y la exposición de figuras se aplican en cada llamada.

Configurar el Agente integrado

Guarda varios modelos en Ajustes › Agente y luego cambia entre ellos desde la cabecera del Agente. Eidograph admite tres familias de protocolo:

• endpoints de Chat Completions compatibles con OpenAI;
• Anthropic Messages;
• Google Gemini / Vertex generateContent.

Cada modelo guardado tiene un nombre visible, proveedor, URL base, clave de API e ID de modelo. Puedes introducir un ID manualmente si falla el descubrimiento de modelos. Endpoints locales como Ollama y LM Studio también pueden funcionar, pero el endpoint debe permitir solicitudes de origen cruzado desde el WebView de la aplicación (CORS).

El Agente integrado admite imágenes adjuntas o pegadas, lo que resulta útil para convertir la foto de un libro de texto o un boceto en una construcción. El soporte de visión depende del endpoint del modelo; una solicitud no admitida aparece como un error en la conversación.

Permisos y límites de datos

• El Agente integrado y los agentes externos no tienen ninguna vía privilegiada oculta; ambos usan las mismas definiciones de herramientas.
• Las ediciones externas se aplican al proyecto activo y respetan el estado de exposición de cada figura.
• Las claves de API nunca se escriben en .eido. Las aplicaciones de Windows y Android usan el almacenamiento de credenciales protegido del sistema operativo.
• Los chats del Agente se excluyen de .eido de forma predeterminada y solo se comparten cuando se activa explícitamente Incluir chats del agente.