Zum Hauptinhalt springen

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

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

​
Langdock als MCP-Server

Langdock bietet auch einen eigenen MCP-Server-Endpunkt, über den externe KI-Clients deine Langdock-Agenten aufrufen können.

Langdock Agent MCP Server

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.
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
  1. 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)
  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
  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
  1. Sobald verbunden, bestätigt ein Erfolgs-Popup die Verbindung.
  2. 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
  1. 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
  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
  1. Kopiere Client-ID und Client-Secret aus deiner App in Langdock
  2. Füge Autorisierungs-URL (für Berechtigungen) und Token-URL (für Token-Austausch) hinzu
  3. Definiere erforderliche OAuth-Bereiche (durch Leerzeichen oder Komma getrennt gemäß der Dokumentation deines Servers)
  4. 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
  1. 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.
  2. 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:

​
Verwandte Dokumentation

MCP Server Verzeichnis

30+ offizielle MCP-Server, die du direkt verbinden kannst

MCP Apps

Baue MCP-Server mit interaktiven UIs direkt in Langdock

​
Zusätzliche Ressourcen

​
FAQ

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