MCP, REST und der integrierte Agent

Eidograph bietet drei Wege für Agenten, die alle auf derselben Werkzeugoberfläche enden:

Weg	Am besten geeignet für	Verfügbar in
Integrierter Agent	Änderungen am aktuellen Projekt in natürlicher Sprache	Windows- und Android-Apps
MCP Streamable HTTP	Agent-Plattformen mit Unterstützung für Remote-HTTP-MCP	Windows-App
JSON-REST-API	Skripte, Workflows und benutzerdefinierte Agenten	Windows-App

Bevor ein Werkzeug ein Skript ändert, kompiliert Eidograph den Kandidaten. Eine Bearbeitung mit Compilerfehlern oder einer Warnung zu einem übersprungenen Befehl wird abgelehnt, und das aktuelle Skript bleibt unverändert. Erfolgreiche Bearbeitungen werden sofort gespeichert, neu gezeichnet und in den gewöhnlichen Rückgängig-Verlauf aufgenommen.

Den nativen Server aktivieren

Öffnen Sie in der installierten App Einstellungen › MCP-/REST-Server.
Aktivieren Sie den Server und bestätigen Sie, dass sein Status „läuft“ anzeigt. Der Standardport ist 14159.
Aktivieren Sie nur die Werkzeuge, die der Client benötigt.
Prüfen Sie in Figuren den Freigabepunkt neben jeder Figur. Ein ausgefüllter Punkt bedeutet, dass externe Clients darauf zugreifen können.
Behalten Sie die standardmäßige Loopback-Bindung bei, sofern Sie sich nicht in einem vertrauenswürdigen Netzwerk befinden.

Standard-Endpunkte:

txt

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

DANGER

Der LAN-Modus bindet an 0.0.0.0 und hat kein Internet-Relay. Native Clients in diesem Netzwerk können die von Ihnen aktivierten Werkzeuge aufrufen. Aktivieren Sie deshalb ein Zugriffstoken, bevor Sie den LAN-Modus einschalten, verwenden Sie ihn nur in einem vertrauenswürdigen Netzwerk und deaktivieren Sie ihn danach wieder.

Ein Zugriffstoken verlangen

Der Server ist standardmäßig nicht authentifiziert. Solange er auf Loopback bleibt, ist das sicher genug: Nur Programme, die ohnehin schon auf diesem PC laufen, erreichen ihn. Schalten Sie Einstellungen › MCP-/REST-Server › Zugriffstoken verlangen ein – immer bevor Sie den LAN-Modus aktivieren –, und Eidograph erzeugt ein Geheimnis, das jede Anfrage mitführen muss:

txt

Authorization: Bearer <token>

Anfragen ohne diesen Header werden mit 401 beantwortet. Die Einstellungen zeigen das Token mit einer Kopierschaltfläche, Token ersetzen wechselt es, und das Ausschalten löscht es. Beides wirkt sofort, aktualisieren Sie also jeden eingerichteten Client.

Den Server aus einem anderen Programm finden

Der Port ist eine Einstellung, außerhalb der App darf ihn also nichts voraussetzen. Solange der Listener läuft, veröffentlicht Eidograph eine Discovery-Datei und löscht sie, sobald der Server stoppt oder die App beendet wird:

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

Lesen Sie mcp oder api und senden Sie token als Bearer-Token; ohne Anforderung ist es null. Die veröffentlichten URLs bleiben auch im LAN-Modus auf Loopback, denn jeder Leser dieser Datei sitzt auf demselben Rechner. Einstellungen › MCP-/REST-Server zeigt und kopiert den genauen Pfad. Behandeln Sie eine fehlende Datei als „Server läuft nicht“, statt auf einen geratenen Port auszuweichen.

Claude Desktop

Claude Desktop installiert MCP-Server als lokale stdio-Prozesse; eine HTTP-URL lässt sich dort also nicht direkt eintragen. Installieren Sie die Erweiterung eidograph-mcpb, um beides zu verbinden – sie braucht keine Konfiguration, findet Port und Zugriffstoken selbst und liest beide bei jeder Anfrage neu. Die schrittweise Installation mit Screenshots und die Einrichtung einer benutzerdefinierten Serveradresse für ein Eidograph auf einem anderen Gerät finden Sie unter Claude Desktop.

Eine MCP-Plattform verbinden

Fügen Sie für einen Client, der Streamable HTTP unterstützt — einschließlich der von der App kopierten Trae-/WorkBuddy-Konfiguration — diesen Server hinzu:

json

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

Plattformen unterscheiden sich im Speicherort der Konfigurationsdatei und im äußeren Schema, aber die wesentlichen Werte sind Servername, URL und Streamable-HTTP-Transport. Wenn eine Plattform nur einen lokalen stdio-MCP-Prozess unterstützt, tragen Sie diese URL nicht in deren command-Feld ein; verwenden Sie stattdessen einen von dieser Plattform unterstützten HTTP-Connector oder eine Bridge.

Lassen Sie den Client nach dem Verbinden Werkzeuge erkennen und dann das aktuelle Skript oder die Befehlsregistrierung lesen. Eine zuverlässige Agent-Abfolge lautet:

list_figures, um das Ziel zu bestätigen;
get_script und list_objects, um die aktuelle Figur zu verstehen;
list_commands, um gültige Syntax für den aktiven 2D-/3D-Dialekt zu prüfen;
append_commands für additive Änderungen und set_script nur, wenn bestehende Zeilen umgeschrieben werden müssen;
list_diagnostics, um das Ergebnis zu prüfen und etwaige Probleme zu beheben.

Die REST-API aufrufen

Prüfen Sie zunächst Status und Werkzeugerkennung:

bash

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

Zwei Punkte und eine Strecke erstellen:

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

Antworten verwenden eine Hülle: {"ok":true,"result":...} bei Erfolg oder {"ok":false,"error":...} bei einem Fehler. Der optionale Header X-Eidograph-Client gibt dem Aufrufer einen lesbaren Namen in der Aktivität unter Einstellungen.

Die aktuelle Oberfläche kann Figuren lesen und auflisten, Figuren erstellen, Skripte anfügen oder ersetzen, Objekte/Diagnosen/Befehle auflisten, ein Objekt auf der Zeichenfläche auswählen und eine freigegebene Figur als SVG, PNG, GIF oder MP4 exportieren. Werkzeugberechtigungen und die Freigabe von Figuren werden bei jedem Aufruf durchgesetzt.

Den integrierten Agenten konfigurieren

Speichern Sie mehrere Modelle in Einstellungen › Agent und wechseln Sie dann in der Agent-Kopfzeile zwischen ihnen. Eidograph unterstützt drei Protokollfamilien:

OpenAI-kompatible Chat-Completions-Endpunkte;
Anthropic Messages;
Google Gemini/Vertex generateContent.

Jedes gespeicherte Modell hat einen Anzeigenamen, einen Anbieter, eine Basis-URL, einen API-Schlüssel und eine Modell-ID. Sie können eine ID manuell eingeben, wenn die Modellerkennung fehlschlägt. Lokale Endpunkte wie Ollama und LM Studio können ebenfalls funktionieren, aber der Endpunkt muss Cross-Origin-Anfragen aus der WebView der App (CORS) zulassen.

Der integrierte Agent akzeptiert angehängte oder eingefügte Bilder, was nützlich ist, um ein Foto aus einem Lehrbuch oder eine Skizze in eine Konstruktion zu verwandeln. Die Unterstützung für Bilder hängt vom Modell-Endpunkt ab; eine nicht unterstützte Anfrage erscheint als Fehler im Gespräch.

Berechtigungen und Datengrenzen

Integrierte und externe Agenten haben keinen versteckten privilegierten Pfad; beide verwenden dieselben Werkzeugdefinitionen.
Externe Bearbeitungen zielen auf das aktive Projekt und beachten den Freigabestatus jeder Figur.
API-Schlüssel werden niemals in .eido geschrieben. Die Windows- und Android-Apps verwenden geschützten OS-Anmeldeinformationsspeicher.
Agent-Chats sind standardmäßig von .eido ausgeschlossen und werden nur geteilt, wenn Agent-Chats einschließen explizit aktiviert ist.

MCP, REST und der integrierte Agent ​

Den nativen Server aktivieren ​

Ein Zugriffstoken verlangen ​

Den Server aus einem anderen Programm finden ​

Claude Desktop ​

Eine MCP-Plattform verbinden ​

Die REST-API aufrufen ​

Den integrierten Agenten konfigurieren ​

Berechtigungen und Datengrenzen ​