> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Langdock Agent MCP Server

> Greife von jedem MCP-kompatiblen KI-Client auf deine Langdock-Agenten zu. Der Langdock MCP Server stellt deine Workspace-Agenten als MCP-Tools bereit.

Der Langdock MCP Server stellt deine Langdock-Agenten als MCP-Tools bereit, sodass jeder MCP-kompatible KI-Client mit deinen Workspace-Agenten interagieren kann.

<Info>
  **Anwendungsfälle**

  Mit 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.
</Info>

## 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.

<Warning>
  Stelle sicher, dass dein API-KEy den **Agent API** Scope aktiviert hat. Workspace-Admins können API-Keys in deinen [Workspace-Einstellungen](https://app.langdock.com/settings/workspace/products/api) erstellen oder verwalten.
</Warning>

### Unterstützte Authentifizierungsmethoden

| Header-Typ | Header-Format                     |
| ---------- | --------------------------------- |
| Bearer     | `Authorization: Bearer <api-key>` |
| X-API-Key  | `x-api-key: <api-key>`            |

## Verfügbare Tools

Der Langdock MCP Server stellt drei Tools bereit:

| Tool               | Beschreibung                                                       |
| ------------------ | ------------------------------------------------------------------ |
| `find_agent`       | Suche nach einer Agenten-ID anhand des Namens                      |
| `ask_agent`        | Sende einen Prompt an einen Agenten mit seiner ID                  |
| `ask_custom_agent` | Konfiguriere 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.

```json theme={null}
{
  "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:

<Steps>
  <Step title="Zu Integrationen navigieren">
    Gehe zu **Integrationen** in deinen Workspace-Einstellungen.
  </Step>

  <Step title="MCP-Integration hinzufügen">
    Klicke auf **Integration hinzufügen** und wähle **MCP** als Integrationstyp.
  </Step>

  <Step title="Server-Details eingeben">
    * **Server URL:** `https://api.langdock.com/mcp`
    * **Authentifizierungsmethode:** API Key
  </Step>

  <Step title="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
  </Step>
</Steps>

***

## Ebenfalls relevante Dokumentation

* [Model Context Protocol (MCP)](/de/using-langdock/guides/integrations/mcp/mcp) - Erfahre mehr über MCP und wie du andere MCP-Server verbindest
* [MCP Server-Verzeichnis](/de/using-langdock/integrations/mcp-directory) - Durchsuche offizielle MCP-Server
* [Agents API Guide](/de/developer/agents-api/agent-api-guide) - Nutze die Agents API direkt

## FAQ

<AccordionGroup>
  <Accordion title="Wann sollte ich den Langdock Agent MCP Server nutzen?">
    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.
  </Accordion>

  <Accordion title="Was sollte ich prüfen, wenn der MCP-Server nicht wie erwartet funktioniert?">
    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.
  </Accordion>
</AccordionGroup>