Zum Inhalt springen

MCP-Server

Als Markdown anzeigen

Der MCP-Server ist die Adresse, über die ein externer Agent wie Claude Code oder Cursor per MCP deine endue-Agenten nachschlägt und ihnen Arbeit gibt. Neben einer Unterhaltung, einem Kanal und der Agent API ist das der vierte Weg zum Agenten, und zwar der für andere Agenten.

https://platform.endue.ai/mcp

Wann du ihn nutzt

Wenn ein Coding-Agent, den du schon verwendest, mitten in seiner Arbeit Hilfe von einem deiner endue-Agenten braucht: Claude Code korrigiert gerade Code und bittet deinen Support-Agenten, die Erstattungstickets der letzten Woche zusammenzufassen.

Ruft Code auf, den du selbst geschrieben hast, nimm die Agent API. Sie streamt die Antwort.

Verbinden

  1. Öffne Einstellungen → Konto → MCP-Verbindung und wähle Verbindung erstellen. Im Bereich MCP im Agent Builder gibt es dieselbe Schaltfläche.

  2. Erstelle einen Schlüssel. Lege Namen und Ablaufdatum fest. Seine Berechtigungen sind fest auf Lesen und MCP-Ausführung eingestellt.

  3. Füge die Konfiguration ein. Wähle deinen Client, und das Fenster zeigt eine Konfiguration, in der der Schlüssel schon eingetragen ist. Kopiere sie an die Stelle, die das Fenster nennt. Nach dem Schließen des Fensters lässt sich der Schlüssel nicht noch einmal anzeigen.

  4. Prüfe die Verbindung. Sobald der externe Agent seine erste Anfrage sendet, wechselt das Fenster zu Verbunden.

  5. Schalte MCP für den Agenten ein, den du ausführen lassen willst. Schalte im Bereich MCP im Agent Builder Diesen Agenten über MCP ausführen ein. Ein Agent, bei dem der Schalter aus ist, lässt sich lesen, aber nicht ausführen.

Das sind die Konfigurationen, die das Fenster zeigt. Dein Schlüssel steht dort, wo sk_... steht.

Führe das in deinem Terminal aus.

Terminal-Fenster
claude mcp add --transport http endue https://platform.endue.ai/mcp --header "Authorization: Bearer sk_..."

Soll der Schlüssel nicht in der Konfigurationsdatei stehen, wähle im Fenster Mit Umgebungsvariable anzeigen. Die Konfiguration wechselt dann zu einer, die den Schlüssel aus ENDUE_API_KEY liest.

Tools für den externen Agenten

ToolWas es tutWas es braucht
list_agentsGibt Namen und Beschreibung deiner Agenten zurück und ob sich jeder über MCP ausführen lässt.Die Berechtigung Lesen
get_agentGibt eine Zusammenfassung der Einrichtung eines Agenten zurück: Modell, Skills, Connectors, Kanäle.Die Berechtigung Lesen
invoke_agentGibt dem Agenten Arbeit und liefert seine Antwort zurück.Die Berechtigung MCP-Ausführung und den MCP-Schalter des Agenten
get_sessionGibt Status und Antwort einer früher vergebenen Arbeit zurück.Die Berechtigung MCP-Ausführung

get_agent gibt Namen und Zusammenfassungen zurück. Der Inhalt von Systemprompt und Gedächtnis sowie die Konten, die mit Connectors verknüpft sind, werden nicht gesendet.

Die Antwort von invoke_agent enthält eine Sitzungs-ID. Schick diese ID beim nächsten Aufruf mit, und der Agent macht in derselben Unterhaltung weiter. Ist eine Ausführung nach etwa 50 Sekunden nicht fertig, kommen zuerst der Status running und die Sitzungs-ID zurück, und der externe Agent holt die Antwort mit get_session ab. Die Ausführung läuft zu Ende, auch wenn der externe Agent die Verbindung vorher trennt.

Was du für jeden Agenten festlegst

Der Bereich MCP im Agent Builder hat zwei Schalter. Beide sind anfangs aus.

  • Diesen Agenten über MCP ausführen. invoke_agent funktioniert nur, wenn dieser Schalter an ist. Details wie Name und Beschreibung lassen sich in beiden Fällen lesen.
  • Auch Connectors und Outputs erlauben. Ist der Schalter aus, nutzt Arbeit, die über MCP hereinkommt, weder Connectors noch Outputs. Ist er an, brauchen Senden und Löschen trotzdem jedes Mal deine Freigabe, und Immer erlauben gilt hier nicht.

Letzte Aufrufe im selben Bereich listet die MCP-Aufrufe auf, die diesen Agenten erreicht haben. Abgelehnte Aufrufe stehen dort mit dem Grund, etwa Keine Berechtigung oder Ausgeschaltet.

Sehen, was hereingekommen ist

  • Benachrichtigung. Du bekommst eine Benachrichtigung, wenn ein externer Agent eine neue Unterhaltung beginnt, und keine weitere, solange diese Unterhaltung weiterläuft.
  • Unterhaltung. Sie steht in der Seitenleiste bei diesem Agenten unter MCP. Öffne sie, um zu sehen, welcher Schlüssel und welcher Client aufgerufen hat.
  • Freigabe. Die Ausführung pausiert bei einer Aktion, die eine Freigabe braucht, und die Anfrage kommt zu dir. Nach deiner Freigabe läuft die Ausführung weiter, und der externe Agent holt die Antwort mit get_session ab.

Eine MCP-Unterhaltung ist schreibgeschützt. Sie geht nur über MCP-Aufrufe weiter.

Einschränkungen

  • Ein Client, der kein Token in einem Header senden kann (einer, der sich nur über OAuth verbindet), kann sich nicht verbinden.
  • Arbeit, die über MCP hereinkommt, nutzt keine Geräte. Das lässt sich mit keinem Schalter ändern.
  • Der externe Agent kann weder das Modell noch die Anzahl der Schritte wählen. Die Ausführung nutzt, was beim Agenten eingestellt ist.
  • Die Karten mit Fragen des Agenten werden nicht nach außen gesendet. Muss der Agent etwas fragen, fragt er im Text seiner Antwort.
  • Der externe Aufrufer kann nicht in das Gedächtnis des Agenten schreiben.
  • Eine über MCP gestartete Sitzung wird nur über MCP fortgesetzt und gelesen. Sie vermischt sich nicht mit Sitzungen der Agent API.
  • list_agents gibt bis zu 50 Agenten zurück.
  • Die Berechtigungen eines Schlüssels lassen sich nach dem Ausstellen nicht ändern. Erstelle einen weiteren Schlüssel, wenn du andere brauchst.
  • Ausführungen und Kosten laufen über das Konto, das den Schlüssel erstellt hat.

Siehe auch