Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

MCP-Server

Erfahre, wie ein MCP-Server einem Plugin Tools bereitstellt und Zugriff auf externe Systeme ermöglicht.

Das Model Context Protocol (MCP) ist eine offene Spezifikation für die Anbindung von KI-Clients an externe Tools und Datenquellen. Ein Plugin kann einen MCP-Server enthalten, wenn es aktuelle Daten abrufen, Aktionen ausführen oder mit einem anderen Dienst zusammenarbeiten muss.

Der MCP-Server ist optional. Ein Plugin, das nur Anweisungen und Ressourcen bereitstellt, kann allein aus Skills bestehen.

Was ein MCP-Server bereitstellt

Ein MCP-Server kann Folgendes bereitstellen:

  • Tools: Funktionen, die das Modell mit strukturierten Eingaben aufrufen kann.
  • Ressourcen: Daten oder Inhalte, die der Client lesen kann.
  • Prompts: Wiederverwendbare Prompt-Vorlagen.
  • Anweisungen: Serverweit geltende Hinweise zur Nutzung der Serverfunktionen.

Plugins nutzen vor allem Tools. Jedes Tool hat einen Namen, eine Beschreibung und ein Eingabeschema. Zusätzlich kann es ein Ausgabeschema haben. Anhand dieser Felder entscheidet das Modell, wann es das Tool aufruft und wie es das Ergebnis verwendet.

So funktionieren Tool-Aufrufe

Wenn jemand eine Anfrage stellt, für die es ein passendes Tool gibt, läuft der Aufruf so ab:

  1. Der Client ermittelt, welche Tools der MCP-Server bereitstellt.
  2. Das Modell wählt ein Tool aus und übergibt Argumente, die dem Eingabeschema entsprechen.
  3. Der Server prüft die Anfrage, führt die Operation aus und gibt ein Ergebnis zurück.
  4. Das Modell nutzt das Ergebnis, um das Gespräch fortzusetzen.

Tool-Ergebnisse sollten sich auch ohne eigens entwickelte Benutzeroberfläche nutzen lassen. Gib knappen Text oder strukturierte Inhalte zurück, die dem Modell genug Informationen liefern, um die Anfrage zu beantworten. Für Clients, die MCP Apps unterstützen, kann ein MCP-Server zusätzlich eine UI-Ressource zurückgeben.

Transport und Autorisierung

Stelle MCP-Server im Produktivbetrieb unter stabilen HTTPS-Endpunkten bereit und verwende den Transportmechanismus Streamable HTTP. Wenn Tools auf private Daten zugreifen oder im Auftrag einer Person Aktionen ausführen, schütze den Server mit dem in der MCP-Spezifikation festgelegten Autorisierungsverfahren.

Details zum Protokoll findest du in der MCP-Spezifikation. Die SDKs für Python und TypeScript enthalten Serverimplementierungen und Hilfsfunktionen.

Nächster Schritt

Sobald du die Tools definiert hast, die dein Plugin benötigt, erstelle den MCP-Server.