Zum Hauptinhalt springen
Der Langdock MCP Server stellt deine Langdock-Agenten als MCP-Tools bereit, sodass jeder MCP-kompatible KI-Client mit deinen Workspace-Agenten interagieren kann.
AnwendungsfälleMit diesem MCP server können externe KI-Tools (wie Claude Desktop, Cursor oder andere MCP-Clients) deine Langdock-Agenten direkt aufrufen. Deine Agenten werden zu Tools, die jede MCP-kompatible Anwendung nutzen kann.

​
MCP Base URL

Der Langdock MCP server ist verfügbar unter https://api.langdock.com/mcp. Wenn deine Organisation ein dediziertes Langdock Deployment (eigene Domain) nutzt, verwende stattdessen den Endpunkt deines Deployments: https://<deine-domain>/api/public/mcp. Ersetze https://api.langdock.com/mcp in diesem Guide überall durch diese URL.

​
Authentifizierung

Der MCP-Endpunkt erfordert einen gültigen Langdock-API-Keys mit dem Agent API-Scope.
Stelle sicher, dass dein API-KEy den Agent API Scope aktiviert hat. Workspace-Admins können API-Keys in deinen Workspace-Einstellungen erstellen oder verwalten.

​
Unterstützte Authentifizierungsmethoden

Header-TypHeader-Format
BearerAuthorization: Bearer <api-key>
X-API-Keyx-api-key: <api-key>

​
Verfügbare Tools

Der Langdock MCP Server stellt drei Tools bereit:
ToolBeschreibung
find_agentSuche nach einer Agenten-ID anhand des Namens
ask_agentSende einen Prompt an einen Agenten mit seiner ID
ask_custom_agentKonfiguriere und befrage einen benutzerdefinierten Agenten spontan

​
find_agent

Nutze dieses Tool, um die ID eines Agenten nachzuschlagen, wenn du nur dessen Namen kennst. Das ist hilfreich, um die richtige Agenten-ID auf Basis des Agenten Namens zu finden, damit du anschließend ask_agent auzufrufen kannst.

​
ask_agent

Sende einen Prompt an einen bestimmten Agenten unter Verwendung seiner ID. Der Agent verarbeitet deine Anfrage mit seinem konfigurierten Modell, seinen Anweisungen und verbundenen Integrationen. Für mehrstufige Konversationen kannst du vorherige Turns über den optionalen Parameter messageHistory übergeben. Jeder Eintrag hat eine role (user oder assistant) und ein content-Feld. Sortiere die Einträge vom ältesten zum neuesten; der aktuelle prompt wird als letzter User-Turn angehängt. 
{
  "agentId": "agent_123",
  "prompt": "Und wie sieht es in Berlin aus?",
  "messageHistory": [
    { "role": "user", "content": "Wie ist das Wetter in München?" },
    { "role": "assistant", "content": "In München sind es aktuell 18 °C und sonnig." }
  ]
}

​
ask_custom_agent

Erstelle einen temporären Agenten mit benutzerdefinierten Einstellungen für eine einzelne Anfrage. Nützlich, wenn du ein bestimmtes Verhalten benötigst, ohne einen permanenten Agenten in Langdock zu erstellen.

​
Verbindung von Langdock aus

Wenn du diesen MCP-Server als Integration innerhalb von Langdock hinzufügen möchtest:
1

Zu Integrationen navigieren

Gehe zu Integrationen in deinen Workspace-Einstellungen.
2

MCP-Integration hinzufügen

Klicke auf Integration hinzufügen und wähle MCP als Integrationstyp.
3

Server-Details eingeben

  • Server URL: https://api.langdock.com/mcp
  • Authentifizierungsmethode: API Key
4

Speichern & Testen

  • Klicke auf Erstellen und verbinden
  • Füge eine Verbindung mit einem gültigen Langdock-API-Key hinzu (muss den AGENT_API-Scope haben)
  • Setze den API Key Header Typ auf Authorization: Bearer
  • Klicke auf Verbindung testen, um den Zugriff auf die verfügbaren Tools zu überprüfen

​
Ebenfalls relevante Dokumentation

​
FAQ

Nutze den Langdock Agent MCP Server, wenn ein externer MCP-kompatibler Client auf Langdock-Agenten als Tools zugreifen soll. Das ist nützlich, wenn Teams ihre Langdock-Agenten außerhalb der Langdock-Oberfläche wiederverwenden möchten.
Prüfe die Konfiguration des MCP-Clients, die Authentifizierung, die Freigabe des Agenten, die verfügbaren Tools und ob der Ziel-Agent veröffentlicht und zugänglich ist. Prüfe außerdem, ob der externe Client das erforderliche MCP-Verhalten unterstützt.