> ## 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. # Model Context Protocol (MCP) > Langdocks Implementierung des Model Context Protocol (MCP) ermöglicht nahtlose Integration mit externen Tools und Diensten und bietet leistungsstarke Erweiterbarkeit für KI-Agenten und Chat-Interaktionen. ## Was ist MCP? MCP ist ein offenes Protokoll, das standardisiert, wie Anwendungen Kontext für LLMs bereitstellen. Stelle dir MCP wie einen USB-C-Anschluss für KI-Anwendungen vor. So wie USB-C eine standardisierte Möglichkeit bietet, deine Geräte mit verschiedenen Peripheriegeräten und Zubehör zu verbinden, bietet MCP eine standardisierte Möglichkeit, KI-Modelle mit verschiedenen Datenquellen und Tools zu verbinden. > [!NOTE] > > MCP-Integrationen in Langdock verwenden die bestehende Integrationsarchitektur mit MCP-spezifischen Erweiterungen, sodass dasselbe Aktionsausführungssystem sowohl für traditionelle Integrationen als auch für MCP-Server funktioniert. ## Langdock MCP Hauptfunktionen ### Transport-Typen * **STREAMABLE\_HTTP**: HTTP-basierter Transport mit optionaler Streaming-Unterstützung * **SSE (Server-Sent Events)**: Echtzeit-Kommunikationstransport für Streaming-Daten ### Authentifizierungsmethoden * **Keine:** Für öffentliche MCP-Server, die keine Identifikation erfordern * **API Key:** Vereinfachte schlüsselbasierte Authentifizierung mit auswählbaren Header-Formaten, inklusive HTTP Basic * **OAuth 2.0 (CIMD):** OAuth 2.0 für Server, die Client ID Metadata Documents angeben, ohne Client-ID und ohne Client-Secret * **OAuth 2.0 (dynamische Client-Registrierung):** Vollständiges OAuth 2.0 mit DCR-Unterstützung für sichere Autorisierungsabläufe * **OAuth 2.0 Manual (Authorization Code + PKCE):** Vollständiges OAuth 2.0 ohne DCR-Unterstützung ### Authentifizierungsdetails * **Benutzerdefinierte Header:** Füge statische Werte oder die Platzhalter `{{ access_token }}`, `{{ refresh_token }}` und `{{ api_key }}` hinzu. In Dedicated Deployments mit aktiviertem Benutzer-OAuth-Login kannst du außerdem `{{ user_oauth_access_token }}` verwenden, um das Langdock-Login-Token des Nutzers an den MCP-Server weiterzuleiten. * **OAuth-Erkennung:** Langdock erkennt unterstützte OAuth-Metadaten und Scopes automatisch, wenn sie verfügbar sind. * **MCP Apps:** Einige MCP Apps stellen Verbindungsmetadaten für eine schnellere Einrichtung bereit. * **OAuth 2.0 (CIMD):** Wähle diese Methode, wenn der Server Client ID Metadata Documents angibt. Du registrierst keinen Client. Du gibst keine Client-ID und kein Client-Secret ein. * **OAuth 2.0 Manual (Authorization Code + PKCE):** Nutze diese Option, wenn der Server kein CIMD angibt und keine dynamische Client-Registrierung unterstützt. ### Tool-Integration **Automatische Erkennung:** Langdock erkennt Tools und Ressourcen vom MCP-Server während der Einrichtung. Du kannst pro Integration bis zu 60 Tools und 50 Ressourcen aktivieren. Tools werden in Langdock-Aktionen konvertiert und behalten dabei dieselben Vorschauen bei, die du gewohnt bist. * **Tools:** Wähle die Tools aus, die Agenten aufrufen sollen. * **Verwendung:** Die Markierung am Tool zeigt, wer es verwenden kann: LLMs, MCP Apps, beide oder keines. Agenten und Action-Nodes in Workflows können nur Tools aufrufen, die für LLMs markiert sind. Klicke auf **Server-Funktionen auflisten** und danach auf **Speichern**, um die aktuelle Verwendung zu speichern. * **Beschreibungen:** Agenten entscheiden anhand der Tool- und Parameterbeschreibungen des MCP-Servers, wann ein Tool aufgerufen wird und wie die Eingaben befüllt werden. Klare und vollständige Beschreibungen helfen dem Modell, in jeder Situation das richtige Tool zu wählen. Wenn du den Server selbst betreibst, verbessere dort unklare Beschreibungen. * **Bestätigung:** Neu gespeicherte Tools und Ressourcen erfordern standardmäßig **keine** Bestätigung vor der Ausführung. Du kannst die Bestätigung pro Tool nach dem Speichern aktivieren, falls du einen Bestätigungsschritt benötigst. ![Server-Funktionen entdecken nach dem Auflisten, mit Markierungen für nur das Modell, nur MCP Apps und beide](https://mintcdn.com/langdock-34/MNx24jjFccv5s63E/de/images/mcp-tool-audiences.png?fit=max\&auto=format\&n=MNx24jjFccv5s63E\&q=85\&s=23fef1100fb4b8dbbe7cb496aa4d806f) ### MCP-Ressourcen MCP-Ressourcen stellen Kontextdaten vom Server bereit. Langdock erkennt Ressourcen während der Einrichtung und lässt dich speichern, was du verfügbar machen möchtest. Für Dateiressourcen siehe [MCP-Dateiausgaben](https://docs.langdock.com/de/using-langdock/guides/integrations/mcp/mcp-file-outputs.md). ### Langdock als MCP-Server Langdock bietet auch einen eigenen MCP-Server-Endpunkt, über den externe KI-Clients deine Langdock-Agenten aufrufen können. > [card] [Langdock Agent MCP Server](https://docs.langdock.com/de/using-langdock/guides/integrations/mcp/langdock-agent-mcp-server.md) > > Verbinde externe KI-Clients mit deinen Langdock-Agenten über MCP ## Erste Schritte Verschiedene Authentifizierungsmethoden haben leicht unterschiedliche Verbindungsabläufe. 1. **URL eingeben** Gib die Endpunkt-URL deines MCP-Servers ein. > [!NOTE] > > Langdock validiert MCP-Server-URLs und blockiert standardmäßig private und > interne Netzwerkadressen. Wenn du ein dediziertes Deployment betreibst, setze > `URL_VALIDATION_ENABLED=false`, um interne MCP-Server zu erreichen. Bei > deaktivierter Validierung müssen URLs weiterhin gültig sein und HTTP oder > HTTPS verwenden. ![Oauth Mcp Config 1](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-1.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=acd800d2e2814c13cf45fbecc264a50f) 2. **Authentifizierungsmethode wählen** Wähle einen der fünf Authentifizierungstypen. Folge der jeweiligen Anleitung unten: ### **Keine & API Key** Für öffentliche oder API-Schlüssel-geschützte Server gibst du einfach die Server-URL (und API-Schlüssel, falls erforderlich) ein. Wenn du API-Schlüssel auswählst, legst du unter **API-Key Header Typ** fest, in welchem Header dein Server den Schlüssel erwartet: * **X-API-Key**, **API-Key** und **X-Auth-Token** senden den Schlüssel im gleichnamigen Header * **Authorization: Bearer** und **Authorization: Token** senden den Schlüssel im `Authorization`-Header mit dem passenden Präfix * **Authorization: Basic (base64-encoded)** kodiert den Schlüssel in Base64 und sendet ihn als `Authorization: Basic`. Für Server, die HTTP Basic Authentication erfordern, gibst du den Schlüssel als `username:password` ein. * **X-API-Key & Bearer (Legacy)** sendet den Schlüssel sowohl im `X-API-Key`-Header als auch als Bearer-Token. Das ist der Standard, wenn kein Header-Typ ausgewählt ist. ### OAuth 2.0 (CIMD) Wähle **OAuth 2.0 (CIMD)**, wenn der Server Client ID Metadata Documents angibt. Du registrierst keinen Client. Das Formular fragt nicht nach Client-ID, Client-Secret, Autorisierungs URL oder Token URL. ![Geöffnetes Menü Authentifizierungsmethode mit ausgewähltem OAuth 2.0 (CIMD)](https://mintcdn.com/langdock-34/KsaE0K8QwtKvt6ml/de/images/mcp-oauth-cimd.png?fit=max\&auto=format\&n=KsaE0K8QwtKvt6ml\&q=85\&s=94427bae386d424f380cab50c455395d) 1. Gib die Server-URL ein und wähle **OAuth 2.0 (CIMD)**. 2. Klicke auf **Verbindung hinzufügen**, um die Anmeldung zu starten. 3. Wenn der Server kein CIMD angibt, zeigt Langdock: „Dieser Server gibt in seinen Metadaten keine CIMD-Unterstützung an. Wähle die dynamische Client-Registrierung oder die manuelle OAuth-Konfiguration.“ Wähle dann **OAuth 2.0 (dynamische Client-Registrierung)** oder **OAuth 2.0 Manual (Authorization Code + PKCE)**. 4. Wenn die Verbindung steht, klicke auf **Server-Funktionen auflisten**. Wähle die Tools aus, die du verwenden möchtest, und klicke dann auf **Speichern**. ### OAuth 2.0 (dynamische Client-Registrierung) Für Server, die OAuth mit PKCE unterstützen, ist der Verbindungsprozess unkompliziert: ![Oauth Mcp Config 2](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-2.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=f12e00f6a4fb96d22934d5cac3498b90) 1. Gib die Server-URL ein und wähle **OAuth 2.0 (dynamische Client-Registrierung)**. 2. Klicke auf **Verbindung hinzufügen**, um den OAuth-Ablauf zu initiieren. ![Oauth Mcp Config 3](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-3.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=4edf0597c042e5149ab294fb40b93d8e) 3. Sobald verbunden, bestätigt ein Erfolgs-Popup die Verbindung. 4. Klicke auf **Server-Funktionen auflisten**, um den Zugriff zu verifizieren und verfügbare Tools zu sehen. Wenn der Test fehlschlägt, zeigt Langdock den Fehler des Servers an. ![Oauth Mcp Config 4](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-4.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=61411bdb0bfb0fa72239578f39edc0df) 5. Wähle die Tools aus, die du verwenden möchtest, und klicke dann auf **Speichern**. Nutze `CMD` + `S` auf Mac oder `Ctrl` + `S` auf Windows zum Speichern. Nutze `CMD` + `Enter` auf Mac oder `Ctrl` + `Enter` auf Windows zum Testen. ### OAuth 2.0 Manual (Authorization Code + PKCE) Für Server, die kein CIMD angeben und keine dynamische Client-Registrierung unterstützen, gibst du die Client-Daten selbst ein: ![Oauth Mcp Config 5](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-5.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=c64a7618d9d121b5ab67e69a53ec426f) 1. Gib die Server-URL ein und wähle **OAuth 2.0 Manual (Authorization Code + PKCE)**. 2. Kopiere die OAuth-Redirect-URL in die API- oder Entwicklereinstellungen deiner App. ![Oauth Mcp Config 6](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-6.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=2f43dd82e01e48945c5d3e0048fa412b) 3. Kopiere Client-ID und Client-Secret aus deiner App in Langdock 4. Füge Autorisierungs-URL (für Berechtigungen) und Token-URL (für Token-Austausch) hinzu 5. Definiere erforderliche OAuth-Bereiche (durch Leerzeichen oder Komma getrennt gemäß der Dokumentation deines Servers) 6. Lass **Resource-Parameter senden** aktiviert, um die MCP-Server-URL als OAuth-Resource-Parameter zu senden. Deaktiviere die Option für Server, die die Resource im Scope übergeben, wie Entra ID. ![Oauth Mcp Config 8](https://mintcdn.com/langdock-34/xbzAyg08zXujRLuD/images/oauth-mcp-config-8.png?fit=max\&auto=format\&n=xbzAyg08zXujRLuD\&q=85\&s=67cb5a9592b4339b92656eb17a652226) 7. Klicke auf **Server-Funktionen auflisten**, um den Zugriff zu verifizieren und verfügbare Tools zu sehen. Wenn der Test fehlschlägt, zeigt Langdock den Fehler des Servers an. 8. Wähle die Tools aus, die du verwenden möchtest, und klicke dann auf **Speichern**. Nutze `CMD` + `S` auf Mac oder `Ctrl` + `S` auf Windows zum Speichern. Nutze `CMD` + `Enter` auf Mac oder `Ctrl` + `Enter` auf Windows zum Testen. *** ### Zapier MCP-Konfiguration Für Zapier MCP-Server hat die URL dieses Format: `https://mcp.zapier.com/api/mcp/s/[dein-api-schlüssel]/mcp` Teile deine URL wie folgt auf: * **Server-URL:** [https://mcp.zapier.com/api/mcp/mcp](https://mcp.zapier.com/api/mcp/mcp) * **API-Schlüssel:** Die kodierte Zeichenfolge nach /s/ in deiner ursprünglichen URL *** ## Verwandte Dokumentation * [Integrationen-Übersicht](https://docs.langdock.com/de/using-langdock/integrations/introduction.md) - Lerne über Langdocks Integrationssystem * [Datei-Input in MCP-Tools](https://docs.langdock.com/de/using-langdock/guides/integrations/mcp/mcp-file-input.md) - Lerne, wie du Dateien an MCP-Tools übergibst * [Agenten-Aktionen](https://docs.langdock.com/de/using-langdock/guides/integrations/using-integrations.md) - Verstehe, wie Aktionen mit Agenten funktionieren > [card] [MCP Server Verzeichnis](https://docs.langdock.com/de/using-langdock/integrations/mcp-directory.md) > > 30+ offizielle MCP-Server, die du direkt verbinden kannst > [card] [MCP Apps](https://docs.langdock.com/de/using-langdock/integrations/mcp-ui.md) > > Baue MCP-Server mit interaktiven UIs direkt in Langdock ## Zusätzliche Ressourcen * [Langdock Cookbook](https://docs.langdock.com/de/developer/overview/cookbook.md) - Ausführbare MCP-Rezepte, unter anderem zu OAuth- und DCR-Authentifizierung und Dateiverarbeitung * [Allgemeine Einführung in MCP](https://modelcontextprotocol.io/docs/getting-started/intro) * [Vertiefung in die Protokollspezifikation](https://modelcontextprotocol.io/specification/2025-06-18) ## FAQ > [accordion] Wann sollte ich MCP nutzen? > > Nutze MCP, wenn Langdock über das Model Context Protocol mit externen Tools oder Diensten verbunden werden soll. MCP eignet sich vor allem, um Agenten und Chats mit standardisiertem Tool-Zugriff zu erweitern. > [accordion] Was sollte ich prüfen, wenn MCP nicht wie erwartet funktioniert? > > Prüfe die Server-Konfiguration, die Authentifizierung, die Tool-Definitionen, die Berechtigungen und ob der MCP-Server erreichbar ist. Wenn ein Tool angezeigt wird, aber zur Laufzeit fehlschlägt, sieh dir das Input-Schema des Tools und die Fehlermeldung des Servers an. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.