> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plugin-MCP-Server in Devin

> Deklarieren Sie MCP-Server in einem Devin-Plugin und legen Sie fest, wer die Berechtigungsnachweise hält: jedes Mitglied, ein Dienstkonto der Organisation oder das Enterprise-Konto.

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.

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| Feld | Typ | Funktion |
| - | - | - |
| `url` | string | Der Endpunkt des Servers. Erforderlich. |
| `transport` | string | Setzen Sie `"sse"` für einen veralteten SSE-Endpunkt. Lassen Sie das Feld für Streamable HTTP weg. |
| `headers` | object | HTTP-headers, die mit jeder Anfrage gesendet werden. Werte können Platzhalter enthalten. |
| `oauthClientId` | string | Ein vorregistrierter OAuth-Client für Anbieter ohne dynamische Client-Registrierung. Ist das Feld gesetzt, gilt der Server unabhängig von seinen headers als OAuth-Server. |
| `oauthClientSecret` | string | Wird aus einem plugin nicht akzeptiert: Die Deklaration wird abgelehnt. Der installierende Administrator gibt das Secret in den Settings des Servers ein. |
| `oauthScopes` | string\[] | Anzufordernde Scopes. Erfordert `oauthClientId`. |
| `oauthResource` | string | Überschreibt den RFC-8707-Parameter `resource` (Standard: die Server-URL). `""` lässt ihn weg; jeder andere Wert muss diesen Server identifizieren. |
| `tokenScope` | string | Standard-**Zugriff** für eine Organisations- oder Enterprise-Installation eines OAuth-Servers: `"user"` (jedes Mitglied meldet sich selbst an) oder `"org"` (eine gemeinsame Verbindung). Ohne Angabe gilt der Geltungsbereich des Marketplace-Eintrags, andernfalls eine gemeinsame Verbindung. Ein deklarierter Wert wird bei jedem Abgleich des plugins erneut angewendet. Eine persönliche Installation gehört immer dem jeweiligen Mitglied. |
| `disabled` | boolean | Bei `true` wird der Server übersprungen. |
| `disabledTools` | string\[] | Namen von tools auf diesem Server, die für Devin ausgeblendet werden. |
| `description` | string | Wird zusammen mit dem Server unter Anpassen angezeigt. |

**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](https://docs.devin.ai/de/product-guides/secrets.md). 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.

> [!NOTE]
>
> Auf der Seite [MCP-Server](https://docs.devin.ai/de/work-with-devin/mcp.md#configuration-format) 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

| Installiert von | Berechtigungsnachweise gehören | Wer stellt die Verbindung her |
| - | - | - |
| Einem Mitglied (persönlicher Geltungsbereich) | Diesem Mitglied | Das Mitglied, unter Anpassen → MCPs |
| Einer Organisation | Der Organisation (`Access: Organization`) oder jedem Mitglied (`Access: Personal`) | Ein Organisationsadministrator oder jedes Mitglied |
| Dem Enterprise | Dem Enterprise (`Access: Enterprise`) oder jedem Mitglied in jeder Organisation (`Access: Personal`) | Ein Enterprise-Administrator oder jedes Mitglied |

## 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](https://docs.devin.ai/de/product-guides/plugins.md#mcps) 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.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.