MCP, REST et l'agent intégré

Eidograph propose trois voies pour les agents, toutes aboutissant à la même surface d'outils :

Voie	Idéale pour	Disponible dans
Agent intégré	Modifications en langage naturel du projet actuel	Applications Windows et Android
MCP Streamable HTTP	Plateformes d'agents prenant en charge le MCP HTTP distant	Application Windows
API REST JSON	Scripts, flux de travail et agents personnalisés	Application Windows

Avant qu'un outil ne modifie un script, Eidograph compile le candidat. Une modification contenant des erreurs de compilation ou un avertissement de commande ignorée est rejetée et le script actuel reste inchangé. Les modifications réussies sont persistées, redessinées et entrent immédiatement dans l'historique d'annulation normal.

Activer le serveur natif

Dans l'application installée, ouvrez Paramètres › Serveur MCP / REST.
Activez le serveur et vérifiez que son statut est en cours d'exécution. Le port par défaut est 14159.
N'activez que les outils dont le client a besoin.
Dans Figures, examinez le point d'exposition à côté de chaque figure. Un point plein signifie que les clients externes peuvent y accéder.
Conservez la liaison en boucle locale par défaut sauf si vous êtes sur un réseau de confiance.

Points de terminaison par défaut :

txt

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

DANGER

Le mode réseau local se lie à 0.0.0.0 et n’a pas de relais internet. Les clients natifs sur ce réseau peuvent invoquer les outils que vous avez activés : activez donc un jeton d’accès avant d’activer le mode réseau local, utilisez-le uniquement sur un réseau de confiance et désactivez-le ensuite.

Exiger un jeton d’accès

Le serveur n’est pas authentifié par défaut, ce qui reste sûr tant qu’il écoute uniquement en local : seuls les programmes déjà lancés sur ce PC peuvent l’atteindre. Activez Paramètres › Serveur MCP / REST › Exiger un jeton d’accès — toujours avant d’activer le mode réseau local — et Eidograph génère un secret que chaque requête doit transporter :

txt

Authorization: Bearer <token>

Les requêtes dépourvues de cet en-tête reçoivent 401. Les paramètres affichent le jeton avec un bouton de copie, Remplacer le jeton le renouvelle et désactiver l’interrupteur l’efface. Les deux prennent effet immédiatement : mettez à jour tous les clients configurés.

Trouver le serveur depuis un autre programme

Le port est un paramètre : rien à l’extérieur de l’application ne peut le présumer. Tant que le serveur écoute, Eidograph publie un fichier de découverte, puis le supprime à l’arrêt du serveur ou à la fermeture de l’application :

Plateforme	Chemin
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`

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": []
}

Lisez mcp ou api et envoyez token comme jeton bearer ; il vaut null lorsqu’aucun n’est exigé. Les URL publiées restent sur la boucle locale même en mode réseau local, car tout lecteur de ce fichier se trouve sur la même machine. Paramètres › Serveur MCP / REST affiche et copie le chemin exact. Considérez un fichier absent comme « le serveur ne tourne pas » plutôt que de vous rabattre sur un port deviné.

Claude Desktop

Claude Desktop installe les serveurs MCP comme des processus stdio locaux : on ne peut donc pas y coller une URL HTTP. Installez l'extension eidograph-mcpb pour faire le pont : elle ne nécessite aucune configuration, trouve seule le port et le jeton d'accès, et les relit à chaque requête. Consultez Claude Desktop pour l'installation pas à pas avec captures d'écran, et pour savoir comment la pointer vers un Eidograph exécuté sur un autre appareil.

Connecter une plateforme MCP

Pour un client prenant en charge le Streamable HTTP — y compris la configuration Trae / WorkBuddy copiée par l'application — ajoutez ce serveur :

json

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

Les plateformes diffèrent par l'emplacement du fichier de configuration et le schéma externe, mais les valeurs essentielles sont le nom du serveur, l'URL et le transport Streamable HTTP. Si une plateforme ne prend en charge qu'un processus MCP stdio local, ne placez pas cette URL dans son champ command ; utilisez un connecteur HTTP ou un pont pris en charge par cette plateforme.

Une fois connecté, laissez le client découvrir les outils, puis lire le script actuel ou le registre de commandes. Une séquence d'agent fiable est :

list_figures pour confirmer la cible ;
get_script et list_objects pour comprendre la figure actuelle ;
list_commands pour inspecter la syntaxe valide du dialecte 2D/3D actif ;
append_commands pour les modifications additives, et set_script uniquement lorsque les lignes existantes doivent être réécrites ;
list_diagnostics pour vérifier le résultat et corriger tout problème.

Appeler l'API REST

Vérifiez d'abord le statut et la découverte des outils :

bash

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

Créer deux points et un segment :

bash

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"}'

Les réponses utilisent une seule enveloppe : {"ok":true,"result":...} en cas de succès ou {"ok":false,"error":...} en cas d'échec. L'en-tête facultatif X-Eidograph-Client donne à l'appelant un nom lisible dans l'activité des Paramètres.

La surface actuelle peut lire et lister les figures, créer des figures, ajouter ou remplacer des scripts, lister les objets/diagnostics/commandes, sélectionner un objet sur le canevas, et exporter une figure exposée en SVG, PNG, GIF ou MP4. Les permissions d'outils et l'exposition des figures sont appliquées à chaque appel.

Configurer l'agent intégré

Enregistrez plusieurs modèles dans Paramètres › Agent, puis basculez entre eux depuis l'en-tête de l'agent. Eidograph prend en charge trois familles de protocoles :

points de terminaison Chat Completions compatibles OpenAI ;
Anthropic Messages ;
Google Gemini / Vertex generateContent.

Chaque modèle enregistré a un nom d'affichage, un fournisseur, une URL de base, une clé API et un ID de modèle. Vous pouvez saisir un ID manuellement si la découverte des modèles échoue. Des points de terminaison locaux tels qu'Ollama et LM Studio peuvent également fonctionner, mais le point de terminaison doit autoriser les requêtes cross-origin depuis la WebView de l'application (CORS).

L'agent intégré accepte les images jointes ou collées, ce qui est utile pour transformer une photo de manuel scolaire ou un croquis en une construction. La prise en charge de la vision dépend du point de terminaison du modèle ; une requête non prise en charge apparaît comme une erreur dans la conversation.

Permissions et limites des données

L'agent intégré et les agents externes n'ont aucun chemin privilégié caché ; les deux utilisent les mêmes définitions d'outils.
Les modifications externes ciblent le projet actif et respectent l'état d'exposition de chaque figure.
Les clés API ne sont jamais écrites dans .eido. Les applications Windows et Android utilisent le stockage d'identifiants protégé du système d'exploitation.
Les conversations avec l'agent sont exclues de .eido par défaut et ne sont partagées que lorsque Inclure les conversations avec l'agent est explicitement activé.

MCP, REST et l'agent intégré ​

Activer le serveur natif ​

Exiger un jeton d’accès ​

Trouver le serveur depuis un autre programme ​

Claude Desktop ​

Connecter une plateforme MCP ​

Appeler l'API REST ​

Configurer l'agent intégré ​

Permissions et limites des données ​