Skip to content

[ Konzepte / mcp ]

MCP-Server ​

Diese Seite ist für Entwickler, die Agents mit externen Systemen wie einem CMS, Shop oder Analytics-Dienst verbinden. devkit richtet zwei Standardverbindungen in deinem User-Scope ein und speichert keine Zugangsdaten.

Scopes ​

ScopeSichtbarkeit
local (Standard)privat für dich und dieses Projekt
projectgeteilt über die .mcp.json des Repositories
userprivat, in jedem Projekt verfügbar

Bei gleichem Namen gilt local → project → user. Nutze project nur für team-sichere Konfiguration ohne eingebettete Secrets.

bash
bash
claude mcp add <name> --scope <local|project|user> -- <befehl>
claude mcp list
claude mcp remove <name>

Standardprüfungen ​

Während devkit sync prüft devkit diese Verbindungen für Claude und den Codex-Adapter und trägt einen fehlenden über das eigene mcp add --scope user des Clients ein. Ein gleichnamiger Eintrag, der vom Manifest abweicht, gehört dir: devkit lässt ihn stehen und bietet am Ende des Syncs im Terminal den Fix (entfernen und neu anlegen) an, vorausgewählt ist Nein. Von sich aus entfernt devkit nie einen Eintrag.

ServerTransportVoraussetzung
codegraphstdio (codegraph serve --mcp)codegraph installiert
context7HTTP mit OAutheinmal anmelden mit claude mcp login context7 oder /mcp

Ein context7-Eintrag in der .mcp.json des Projekts mit eigener URL, eigenem Key oder Versions-Pin gehört dir: devkit sync schreibt Projekt-MCP-Dateien nie um, und devkit init stoppt, statt ihn anzufassen.

Abschalten ​

  • Pro Projekt: /mcp schreibt disabledMcpServers in ~/.claude.json; claude mcp remove löscht diesen Eintrag nicht, also aktiviere ihn wieder in /mcp.
  • Session-Hinweis: OD_SKIP_MCP_AWARENESS=1 blendet den SessionStart-Hinweis zu projektlokalen Servern aus; devkit switches listet jeden Schalter.
  • Ganze Session: claude --bare.

Verwalte OAuth-Connectors von claude.ai über claude.ai → Settings → Connectors oder /mcp, nicht als handgeschriebene Projekt-Server, und halte nur aktuelle Verbindungen aktiv: Jedes Tool-Schema kostet Session-Kontext.

Schreibzugriffe über MCP ​

Ein MCP-Schreibzugriff hat keinen Datei-Diff zum Prüfen, also nutze diese Schleife: Alle Ziele aufzählen und zählen, idempotent mutieren, damit eine Wiederholung sicher ist, jeden Wert aus seiner Quelle zurücklesen statt der Erfolgsmeldung zu trauen, und wiederholen, bis null übrig sind oder jedes hängende Element namentlich melden.

Interne Doku — onedot-devkit · devkit

devkitdevkit syncdevkit statusdevkit doctordevkit helpInterne Doku · ONEDOT digital crew