MCP-Konfiguration

MCP-Server hinzufügen

Über die Befehlszeile

Der schnellste Weg, einen MCP-Server hinzuzufügen:

# stdio-Server — Befehl einfach nach -- angeben
devin mcp add <name> -- <command> [args...]

# HTTP-Server — URL als Positionsargument übergeben
devin mcp add <name> <URL>

# HTTP-Server — oder das Flag --url verwenden
devin mcp add <name> --url <URL>

Der Transporttyp wird automatisch erkannt: Eine URL weist auf HTTP (Streamable HTTP) hin, nachgestellte Argumente (oder --command) auf stdio.

Remote-MCP-Server verwenden standardmäßig Streamable HTTP. Wenn der Server mit einem HTTP-4xx-Fehler wie 404 oder 405 antwortet, fällt die CLI unter derselben URL auf SSE zurück. Authentifizierungsfehler (ein 401 oder ein 403 wegen unzureichenden Geltungsbereichs mit einer WWW-Authenticate-Challenge) lösen den Fallback nicht aus — sie werden direkt gemeldet, damit du dich authentifizieren kannst. Setze "transport": "sse" bei Bedarf explizit — siehe unten Legacy-SSE-Fallback.

Standardmäßig werden Server im lokalen Geltungsbereich gespeichert (.devin/mcp_config.local.json, von Git ignoriert). Verwende -s/--scope, um das zu ändern:

devin mcp add -s project <name> <URL>   # geteilt über .devin/mcp_config.json
devin mcp add -s user <name> <URL>      # global (~/.config/devin/mcp_config.json; %APPDATA%\devin\mcp_config.json unter Windows)

Sie können Server auch über die Befehlszeile verwalten:

devin mcp list              # Alle konfigurierten Server auflisten
devin mcp get <name>        # Details zu einem bestimmten Server anzeigen
devin mcp remove <name>     # Einen konfigurierten Server entfernen
devin mcp login <name>      # Bei einem Server via OAuth authentifizieren
devin mcp logout <name>     # Gespeicherte OAuth-Anmeldedaten entfernen
devin mcp enable <name>     # Einen deaktivierten Server aktivieren
devin mcp disable <name>    # Einen Server deaktivieren, ohne ihn zu entfernen

Über die Konfigurationsdatei

Fügen Sie Server direkt im Abschnitt mcpServers Ihrer MCP-Konfigurationsdatei hinzu:

Der Speicherort der MCP-Konfigurationsdatei wurde mit v3000.3 (dem Local-3.6-Release) geändert. Ältere Versionen (vor v3000.3) speichern MCP-Server im Schlüssel mcpServers der Hauptkonfigurationsdateien (~/.config/devin/config.json, .devin/config.json, .devin/config.local.json). Neuere Versionen speichern sie in separaten Dateien an denselben Speicherorten: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json unter Windows), .devin/mcp_config.json und .devin/mcp_config.local.json. Beim Start werden alle in den Hauptkonfigurationsdateien gefundenen mcpServers-Einträge automatisch in die separaten Dateien migriert.

Projektkonfiguration
Nutzerkonfiguration
Lokale Überschreibung

// .devin/mcp_config.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

Server auf Projektebene werden über die Versionsverwaltung mit Ihrem Team geteilt.

// ~/.config/devin/mcp_config.json
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {}
    }
  }
}

Server auf Nutzerebene gelten für alle Ihre Projekte.

// .devin/mcp_config.local.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "my-personal-key"
      }
    }
  }
}

Lokale Konfigurationen werden von Git ignoriert – verwenden Sie sie für persönliche API keys.

Optionen für die Serverkonfiguration

MCP-Server können auf zwei Arten konfiguriert werden: als lokaler Befehl (stdio-Transport) oder als Remote-Server (HTTP-Transport).

Lokaler Befehl (stdio)

Feld	Typ	Erforderlich	Beschreibung
`command`	string	Ja	Das auszuführende Programm
`args`	string[]	Nein	Befehlszeilenargumente
`env`	object	Nein	Zu setzende Umgebungsvariablen
`disabled`	boolean	Nein	Auf `true` setzen, um diesen Server zu überspringen (siehe Aktivieren und Deaktivieren von Servern)

Remote-Server (Streamable HTTP)

Feld	Typ	Erforderlich	Beschreibung
`url`	string	Ja	Die URL des Endpunkts des MCP-Servers
`transport`	string	Nein	`"http"` (Streamable HTTP, Standard für URL-basierte Server) oder `"sse"` (Legacy SSE). Wenn `"http"` festgelegt ist oder weggelassen wird, versucht die CLI zuerst Streamable HTTP und fällt bei 4xx-Fehlern, die nicht mit der Authentifizierung zusammenhängen (z. B. 404 oder 405), auf SSE zurück (gemäß Spezifikation); 401-Antworten sowie 403-Antworten wegen unzureichenden Geltungsbereichs mit einer `WWW-Authenticate`-Challenge werden direkt gemeldet, damit Sie sich authentifizieren können. Legen Sie `"sse"` explizit fest, wenn sich der SSE-Endpunkt des Servers unter einem anderen Pfad befindet.
`headers`	object	Nein	Benutzerdefinierte HTTP-Header, die in Anfragen gesendet werden
`oauthClientId`	string	Nein	Vorregistrierte OAuth-Client-ID für Server, die keine dynamische Client-Registrierung (DCR) unterstützen, z. B. GitHub. Siehe den Abschnitt „Vorregistrierte OAuth-Clients“ weiter unten.
`oauthClientSecret`	string	Nein	OAuth-Client-Secret für vertrauliche Clients. Zusammen mit `oauthClientId` verwenden.
`oauthResource`	string	Nein	Überschreibt den in OAuth-Anfragen gesendeten RFC-8707-Parameter `resource` (Standard: die URL des MCP-Servers). Auf eine leere Zeichenfolge (`""`) setzen, um den Parameter für Anbieter, die ihn ablehnen, vollständig wegzulassen. Siehe OAuth-Ressourcenüberschreibung.
`disabled`	boolean	Nein	Auf `true` setzen, um diesen Server zu überspringen (siehe Aktivieren und Deaktivieren von Servern)

Beispiele

GitHub (stdio)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Notion (HTTP mit OAuth)

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp",
      "transport": "http"
    }
  }
}

Führen Sie nach dem Hinzufügen eines OAuth-basierten Servers devin mcp login notion aus, um die Authentifizierung durchzuführen. Weitere Informationen finden Sie unten unter Authentifizierung.

Linear (HTTP mit OAuth)

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp",
      "transport": "http"
    }
  }
}

Atlassian / Jira (HTTP mit OAuth)

{
  "mcpServers": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v1/mcp",
      "transport": "http"
    }
  }
}

Führen Sie nach dem Hinzufügen devin mcp login atlassian aus, um die Authentifizierung durchzuführen. Jeder MCP-Client (Windsurf, Claude Code, Devin CLI) verwaltet seine eigene OAuth-Sitzung. Sie müssen sich also separat anmelden, auch wenn Sie sich bereits in einem anderen Tool authentifiziert haben.

Eigener Server (stdio)

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["./scripts/mcp-server.py"],
      "env": {
        "DB_URL": "postgres://localhost/mydb"
      }
    }
  }
}

Authentifizierung

Einige Remote-MCP-Server erfordern eine OAuth-Authentifizierung. Nachdem du deiner Konfiguration einen OAuth-basierten Server hinzugefügt hast, melde dich mit dem Befehl login an:

devin mcp login <server-name>

Zum Beispiel:

devin mcp login notion    # Mit Notion authentifizieren
devin mcp login linear    # Mit Linear authentifizieren

Dadurch öffnet sich ein Browserfenster, in dem du den Zugriff autorisieren kannst. Die OAuth-Token werden lokal gespeichert und automatisch erneuert. Du kannst optional bestimmte OAuth-Geltungsbereiche anfordern:

devin mcp login notion --scopes read,write

So entfernen Sie gespeicherte Anmeldedaten für einen Server:

devin mcp logout <server-name>

Wenn der Server OAuth unterstützt, werden Sie bei der ersten Verwendung des Servers außerdem automatisch zur Authentifizierung aufgefordert.

Erneute Authentifizierung

Gespeicherte OAuth-Anmeldedaten sind nicht dauerhaft gültig — sie laufen ab, und ein Administrator kann sie beim Anbieter widerrufen. In diesem Fall meldet der Server statt eine Verbindung herzustellen den Status auth-required, und seine Tools (sowie Prompts) sind erst wieder verfügbar, nachdem Sie sich erneut angemeldet haben. Um sich erneut zu authentifizieren, löschen Sie die gespeicherten Anmeldedaten und führen Sie den Browser-Ablauf erneut aus:

devin mcp logout <server-name>
devin mcp login <server-name>

logout löscht die gespeicherten Tokens für diesen Server; login startet den OAuth-Ablauf erneut und speichert neue Tokens. Gehen Sie nach Änderungen an oauthClientId, oauthClientSecret oder oauthResource genauso vor — Anmeldedaten, die mit den alten Settings ausgestellt wurden, werden nicht wiederverwendet.

Editor-Integrationen, die Devin CLI über ACP steuern, zeigen denselben Status „Authentifizierung erforderlich“ mit einer Aktion zur erneuten Authentifizierung an. Diese löscht die gespeicherten Anmeldedaten und öffnet den Browser-Ablauf erneut — dies entspricht dem obigen Paar aus logout und login.

Vorregistrierte OAuth-Clients

Die meisten OAuth-basierten MCP-Server unterstützen die dynamische Client-Registrierung (DCR), sodass Devin CLI sich automatisch registriert und Sie keine Client-Zugangsdaten angeben müssen. Einige Anbieter (z. B. GitHub) unterstützen DCR nicht und erfordern stattdessen einen vorregistrierten OAuth-Client. Geben Sie für diese die Client-ID an — und ein Client-Secret, falls es sich um einen vertraulichen Client handelt — über oauthClientId / oauthClientSecret:

{
  "mcpServers": {
    "my-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http",
      "oauthClientId": "Iv1.abc123def456",
      "oauthClientSecret": "${env:MY_MCP_CLIENT_SECRET}"
    }
  }
}

Wenn oauthClientId gesetzt ist, überspringt Devin CLI die dynamische Client-Registrierung und verwendet während des OAuth-Ablaufs Ihren vorregistrierten Client. Führen Sie devin mcp login <name> aus (oder authentifizieren Sie sich bei der ersten Verwendung), um sich wie gewohnt zu authentifizieren. Sie können diese Werte auch über die Befehlszeile festlegen, wenn Sie einen Server hinzufügen oder sich bei einem Server anmelden:

devin mcp add my-server <URL> --oauth-client-id <ID> --oauth-client-secret <SECRET>
devin mcp login my-server --oauth-client-id <ID> --oauth-client-secret <SECRET>

oauthClientId / oauthClientSecret sind OAuth-Client-Anmeldedaten, die während des Autorisierungsflusses verwendet werden. Sie sind keine allgemeinen Anmeldedaten für einzelne Requests — wenn ein Server ein statisches Token erwartet, verwende stattdessen headers (HTTP) oder env (stdio).

Checke kein Client-Secret in eine gemeinsam genutzte Konfiguration ein. Referenziere es über eine Umgebungsvariable (${env:VAR}), lies es aus einer Datei (${file:/path}) oder speichere es in .devin/mcp_config.local.json (von Git ignoriert). Siehe unten den Abschnitt “Secrets verwalten”.

OAuth-Ressourcenüberschreibung

Während der OAuth-Autorisierung und des Token-Austauschs sendet Devin CLI einen RFC 8707-resource-Parameter, damit der Autorisierungsserver auf eine Zielgruppe beschränkte Tokens ausstellen kann. Standardmäßig ist der Wert die URL des MCP-Servers. Überschreiben Sie ihn mit oauthResource:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "transport": "http",
      "oauthResource": ""
    }
  }
}

Das Feld kann sich auf drei Arten verhalten:

Nicht festgelegt (Standard): resource wird auf die URL des MCP-Servers gesetzt.
Nicht leerer Wert: ersetzt den Standard durch Ihren Wert (z. B. eine bestimmte Anwendungs-ID-URI).
Leere Zeichenfolge (""): lässt den Parameter resource sowohl aus der Autorisierungs-URL als auch aus dem Token-Austausch vollständig weg.

Sie können es auch über die Befehlszeile festlegen, wenn Sie einen Server hinzufügen oder sich bei einem Server anmelden:

devin mcp add my-server <URL> --oauth-resource ""
devin mcp login my-server --oauth-resource ""

Wie andere OAuth-Felder unterstützt oauthResource die Auflösung von ${env:VAR} und ${file:/path}.

Aktivieren und Deaktivieren von Servern

Sie können einen MCP-Server vorübergehend deaktivieren, ohne seine Konfiguration zu entfernen. Ein deaktivierter Server wird bei der Tool-Erkennung übersprungen — seine Tools werden nicht angezeigt, und der Serverprozess wird nicht gestartet.

devin mcp disable <name>    # Einen Server deaktivieren
devin mcp enable <name>     # Wieder aktivieren

Dies setzt das Flag "disabled": true für den Server-Eintrag in der Konfigurationsdatei. Verwenden Sie -s/--scope, um einen bestimmten Geltungsbereich festzulegen:

devin mcp disable -s project my-server
devin mcp enable -s user my-server

Sie können das Flag auch direkt in Ihrer Konfigurationsdatei setzen:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "disabled": true
    }
  }
}

Das Deaktivieren ist nützlich, wenn Sie die Konfiguration eines Servers (einschließlich Umgebungsvariablen und OAuth-Anmeldedaten) beibehalten, ihn aber vorübergehend nicht verwenden möchten — zum Beispiel, um die Startzeit zu verkürzen oder ein Problem zu isolieren.

Secrets verwalten

Committe niemals API keys oder Secrets in die Versionsverwaltung. Verwende .devin/mcp_config.local.json für sensible Werte.

Für Teamprojekte wird folgendes Vorgehen empfohlen:

Definiere den Server in .devin/mcp_config.json mit Platzhaltern oder ohne Umgebungsvariablen
Jedes Teammitglied fügt seine persönlichen Keys in .devin/mcp_config.local.json hinzu

Die lokale Konfigurationsdatei wird automatisch von Git ausgeschlossen.

MCP-Berechtigungen

Sie können in Ihrer Berechtigungskonfiguration bestimmte MCP-Tools vorab genehmigen, ablehnen oder jedes Mal eine Rückfrage erzwingen:

{
  "permissions": {
    "allow": [
      "mcp__github__list_issues",
      "mcp__github__create_issue"
    ],
    "deny": [
      "mcp__github__delete_repo"
    ],
    "ask": [
      "mcp__linear__*"
    ]
  }
}

Muster für den Berechtigungsabgleich:

Pattern	Entspricht
`mcp__server__tool`	Ein bestimmtes Tool auf einem bestimmten Server
`mcp__server__*`	Alle Tools auf einem bestimmten Server
`mcp__*`	Alle MCP-Tools auf allen Servern

Prompts

Prompts benötigen keine eigene Konfiguration: Jeder verbundene Server, der die MCP-Fähigkeit prompts deklariert, stellt automatisch Slash-Befehle im Format /mcp__<server>__<prompt> bereit. Da der Befehlsname den Servernamen enthält, werden beim Umbenennen eines Servers in mcpServers auch dessen Prompt-Befehle umbenannt. Siehe MCP Overview — Prompts als Slash-Befehle.

Einschränkungen auf Organisationsebene

Wenn Sie Teil eines Enterprise-Teams sind, kann Ihr Admin einschränken, mit welchen MCP-Servern Sie eine Verbindung herstellen können. Ein von Ihnen konfigurierter Server kann blockiert werden, wenn MCP für Ihr Team deaktiviert ist oder wenn er weder auf der Allowlist Ihres Teams noch in einer erzwungenen MCP Registry enthalten ist — in diesem Fall wird keine Verbindung hergestellt und seine Tools sind nicht verfügbar. Weitere Informationen finden Sie unter Team Settings — MCP Registry.

Fehlerbehebung

Authentifizierung erforderlich / OAuth-Fehler bei Remote-Servern

Wenn beim Verbinden mit einem Remote-MCP-Server Fehler wie Auth required oder AuthRequired angezeigt werden, erfordert der Server eine OAuth-Authentifizierung.Führen Sie Folgendes aus:

devin mcp login <server-name>

Jeder MCP-Client authentifiziert sich unabhängig. Selbst wenn Sie sich bereits in Windsurf oder Claude Code authentifiziert haben, müssen Sie devin mcp login für Devin CLI separat ausführen.Um Ihren Authentifizierungsstatus zu prüfen, versuchen Sie, die Anmeldedaten zu entfernen und erneut hinzuzufügen:

devin mcp logout <server-name>
devin mcp login <server-name>

Server startet nicht

Prüfen Sie, ob der Befehl außerhalb von Devin CLI funktioniert:

npx -y @modelcontextprotocol/server-github

Prüfen Sie, ob alle erforderlichen Umgebungsvariablen gesetzt sind.

Tools werden nicht angezeigt

Bitten Sie den Agenten, die MCP-Server und Tools aufzulisten. Möglicherweise braucht der Server einen Moment für die Initialisierung.

Zugriff verweigert

Prüfen Sie Ihre Berechtigungskonfiguration. MCP-Tools fragen standardmäßig nach einer Bestätigung. Fügen Sie sie zu permissions.allow hinzu, um sie automatisch zu genehmigen.

OAuth-Fehler durch den resource-Parameter

Einige Autorisierungsserver lehnen OAuth-Anfragen ab, die den RFC-8707-Parameter resource enthalten. Setzen Sie oauthResource auf eine leere Zeichenfolge, um den Parameter wegzulassen:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "oauthResource": ""
    }
  }
}

Authentifizieren Sie sich dann erneut:

devin mcp logout my-server
devin mcp login my-server

Unter OAuth-Ressourcenüberschreibung finden Sie die vollständige Übersicht über das Verhalten von oauthResource.

Legacy-SSE-Fallback

Beim Verbinden mit einem HTTP-Server versucht Devin CLI zuerst Streamable HTTP. Wenn der Server mit einem HTTP-4xx-Fehler antwortet, der nicht die Authentifizierung betrifft (z. B. 404 oder 405), wird automatisch auf Legacy SSE unter derselben konfigurierten URL zurückgegriffen. Dies entspricht den Hinweisen zur Abwärtskompatibilität in der MCP-Spezifikation.Der Fallback wird nur bei 4xx-Antworten ausgelöst, die nicht die Authentifizierung betreffen. Verbindungsfehler, Timeouts und 5xx-Antworten werden direkt gemeldet, ohne einen SSE-Versuch. Antworten, die eine Authentifizierung erfordern — also ein 401 oder ein 403 wegen unzureichenden Geltungsbereichs mit einer WWW-Authenticate-Challenge —, werden ebenfalls direkt gemeldet. So können Sie gleich devin mcp login <server-name> ausführen (oder den erforderlichen Geltungsbereich gewähren), statt einen SSE-Versuch zu sehen. Siehe Authentifizierung erforderlich / OAuth-Fehler bei Remote-Servern.Wenn sich der SSE-Endpunkt Ihres Servers unter einem anderen Pfad befindet (z. B. /sse statt /mcp), setzen Sie "transport": "sse" mit der SSE-URL, um direkt eine Verbindung herzustellen, ohne es zuerst über Streamable HTTP zu versuchen.Wenn beide Transportarten fehlschlagen, enthält die Fehlermeldung Details aus beiden Versuchen, um die Fehlerbehebung zu erleichtern.

Erste Schritte

Editor-Integrationen

Erweiterbarkeit

Enterprise

Referenz

Changelog

MCP-Server hinzufügen

Über die Befehlszeile

Über die Konfigurationsdatei

Optionen für die Serverkonfiguration

Lokaler Befehl (stdio)

Remote-Server (Streamable HTTP)

Beispiele

Authentifizierung

Erneute Authentifizierung

Vorregistrierte OAuth-Clients

OAuth-Ressourcenüberschreibung

Aktivieren und Deaktivieren von Servern

Secrets verwalten

MCP-Berechtigungen

Prompts

Einschränkungen auf Organisationsebene

Fehlerbehebung

​MCP-Server hinzufügen

​Über die Befehlszeile

​Über die Konfigurationsdatei

​Optionen für die Serverkonfiguration

​Lokaler Befehl (stdio)

​Remote-Server (Streamable HTTP)

​Beispiele

​Authentifizierung

​Erneute Authentifizierung

​Vorregistrierte OAuth-Clients

​OAuth-Ressourcenüberschreibung

​Aktivieren und Deaktivieren von Servern

​Secrets verwalten

​MCP-Berechtigungen

​Prompts

​Einschränkungen auf Organisationsebene

​Fehlerbehebung

MCP-Server hinzufügen

Über die Befehlszeile

Über die Konfigurationsdatei

Optionen für die Serverkonfiguration

Lokaler Befehl (stdio)

Remote-Server (Streamable HTTP)

Beispiele

Authentifizierung

Erneute Authentifizierung

Vorregistrierte OAuth-Clients

OAuth-Ressourcenüberschreibung

Aktivieren und Deaktivieren von Servern

Secrets verwalten

MCP-Berechtigungen

Prompts

Einschränkungen auf Organisationsebene

Fehlerbehebung