Zum Hauptinhalt springen
Ein Plugin kann MCP-Server enthalten (zum Beispiel für einen Issue-Tracker), sodass alle, die es installieren, dieselbe Server-Konfiguration erhalten, ohne sie selbst von Grund auf einrichten zu müssen. Nach der Installation hinterlegen Sie die Berechtigungsnachweise, die der Server benötigt, etwa einen API-Schlüssel oder eine OAuth-Anmeldung. Ob eine Verbindung persönlich oder gemeinsam genutzt wird, hängt davon ab, wo das Plugin installiert ist und wie die Einstellung Zugriff der Installation konfiguriert ist.

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.

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

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

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

  1. Beides in einem Plugin

Liefern Sie beide Einträge wie in der obigen Deklaration aus und stellen Sie das Plugin bereit. Jede Organisation, die es installiert, erhält zwei Zeilen: eine, bei der sich Mitglieder anmelden, und eine, die der Organisationsadministrator verbindet. Dank unterschiedlicher Servernamen können die Fähigkeiten des Plugins angeben, welcher Server verwendet werden soll.