Die Deklaration
Deklarieren Sie Server in einer.mcp.json im Stammverzeichnis als mcpServers-Map. Das Inline-Feld mcpServers des Manifests nimmt dieselbe Map ohne den umschließenden Wrapper auf.
Platzhalter.
${NAME} in url oder headers wird bei der Installation über das Connect-Fenster des Servers ausgefüllt. ${NAME:-default} liefert einen Ausweichwert, falls nichts gespeichert ist. Ein plugin-Server liest nur Werte, die in seiner Installation gespeichert sind, nicht gleichnamige Sitzungs-Secrets. Schreiben Sie niemals einen echten token in eine Deklaration: Er wird unverändert gespeichert.
Alternativ kann ein Server einen lokalen Befehl ausführen (command, args, env); dann gelten die oben genannten HTTP-Berechtigungsnachweisfelder nicht.
Auf der Seite MCP-Server ist das Formular unter Anpassen für einen eigenständigen Server beschrieben. Der Server eines plugins verwendet die oben genannten Feldnamen; URL, transport und headers werden in der Zeile der Installation schreibgeschützt angezeigt.
Wer die Berechtigungsnachweise verwaltet
Setups
Jedes Setup verknüpft einen Eintrag aus der obigen Deklaration mit dem Installationsort des plugin und der Art seiner Verteilung: Erforderlich installiert es für alle im Geltungsbereich, bei Angeboten kann jede Organisation bzw. jedes Mitglied es selbst installieren. Beide Optionen legen Sie am plugin unter Anpassen fest.
- OAuth pro Nutzer für alle
Verwenden Sie für einen Server, der OAuth unterstützt, den Eintrag example-mcp und installieren Sie das Plugin auf Enterprise- oder Organisationsebene als Erforderlich.
tokenScope: "user" setzt den Zugriff standardmäßig auf Persönlich. Jedes Mitglied meldet sich also einmalig an – entweder unter Anpassen → MCPs oder in der ersten Sitzung, die den Zugriff benötigt.
- Ein Dienstkonto für die Organisation
Verwenden Sie den Eintrag example-mcp-service-account und installieren Sie das Plugin auf Organisationsebene.
- Der
Authorization-Header enthält einen Platzhalter, daher zeigt die Zeile Connect an. Ein Organisationsadministrator gibt das Token ein; Mitglieder sehen es nie. - Lehnt der Server das Token ab (401), zeigt die Zeile Berechtigungsnachweis prüfen an. Unterstützt der Server zusätzlich OAuth, zeigt die Zeile außerdem Sign in with OAuth instead an.
- Für ein Dienstkonto, das sich über OAuth anmeldet, entfernen Sie den Header, setzen Sie
tokenScope: "org"und verknüpfen Sie die Anmeldung dieses Kontos.
- Ein Schlüssel pro Organisation
Fügen Sie den Eintrag example-mcp-service-account in ein Enterprise-Plugin ein und setzen Sie es auf Für Organisationen angeboten.
- Jede Organisation, die das Plugin installiert, besitzt ihre eigene Installation. Ihr Administrator trägt daher für
${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}den Schlüssel dieser Organisation ein. - Auf Enterprise-Ebene wird nichts verbunden, und keine Organisation sieht den Schlüssel einer anderen.
- Ein als Erforderlich festgelegtes Enterprise-Plugin erstellt stattdessen eine einzige Installation, die der Enterprise gehört: ein Schlüssel für alle Organisationen.

