> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Didit MCP installieren: Claude, Cursor, VS Code, Windsurf > Richten Sie den gehosteten Didit MCP-Server in Claude, Cursor, VS Code und weiteren Clients oder selbstgehostet ein. Ohne API-Schlüssel. Wählen Sie unten Ihren Client aus. Der **gehostete** Server (`https://mcp.didit.me/mcp`) benötigt keinen API-Schlüssel — bei der ersten Verbindung öffnet Ihr Client einen Browser und Sie klicken auf **[Mit Didit anmelden](https://docs.didit.me/de/integration/mcp/authentication.md)** und genehmigen die Berechtigungen. > [!TIP] > > **Sie verwenden Claude?** Die Seite [Claude verbinden](https://docs.didit.me/de/integration/mcp/claude.md) enthält den One-Click-Connector-Link, der den Dialog **Add custom connector** mit vorausgefülltem Namen und URL öffnet, sodass Sie nur noch bestätigen und sich anmelden müssen. > [!NOTE] > > Clients, die Remote-/HTTP-MCP noch nicht unterstützen (Windsurf, Zed), verbinden sich über die `mcp-remote`-Bridge, die stdio an die gehostete URL weiterleitet und den OAuth-Handshake für Sie abwickelt. *** ## Gehosteter Server (empfohlen) > [tab] Claude Code > > Fügen Sie den Server über die CLI hinzu und lösen Sie dann die Anmeldung aus: > > ```bash theme={null} > claude mcp add --transport http didit https://mcp.didit.me/mcp > ``` > > Starten Sie Claude Code und führen Sie `/mcp` aus — dies öffnet den Browser für **Mit Didit anmelden**. Nachdem Sie die Genehmigung erteilt haben, sind die `didit`-Tools verfügbar. > [tab] Claude Web und Desktop > > Web: Klicken Sie auf [**Didit zu Claude hinzufügen →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp) und bestätigen Sie den vorausgefüllten Dialog. > > Desktop: **Settings → Connectors → Add custom connector**, benennen Sie ihn `Didit` und setzen Sie die URL auf: > > ```text theme={null} > https://mcp.didit.me/mcp > ``` > > Klicken Sie auf **Verbinden** und schließen Sie **Mit Didit anmelden** im Browser ab. Die Didit-Tools erscheinen anschließend im Tool-Menü des Chats. > [tab] Cursor > > Fügen Sie dies zu `~/.cursor/mcp.json` (global) oder `.cursor/mcp.json` (pro Projekt) hinzu: > > ```json theme={null} > { > "mcpServers": { > "didit": { > "url": "https://mcp.didit.me/mcp" > } > } > } > ``` > > Oder verwenden Sie **Settings → Tools & Integrations → New MCP Server**. Cursor registriert sich über Dynamic Client Registration automatisch bei Didit und öffnet bei der ersten Nutzung den Browser zur Anmeldung. > [tab] VS Code > > Fügen Sie mit dem GitHub Copilot-Agentenmodus `.vscode/mcp.json` hinzu: > > ```json theme={null} > { > "servers": { > "didit": { > "type": "http", > "url": "https://mcp.didit.me/mcp" > } > } > } > ``` > > Oder führen Sie **MCP: Add Server** über die Befehlspalette aus und wählen Sie **HTTP**. Melden Sie sich an, wenn Sie dazu aufgefordert werden. Richten Sie VS Code auf die vollständige `/mcp`-URL aus: Der Server veröffentlicht seine OAuth-Ressourcen-Metadaten für diesen Pfad. > [tab] Windsurf > > Windsurf verbindet sich über die `mcp-remote`-Bridge. Fügen Sie dies zu `~/.codeium/windsurf/mcp_config.json` hinzu: > > ```json theme={null} > { > "mcpServers": { > "didit": { > "command": "npx", > "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"] > } > } > } > ``` > > Öffnen Sie **Settings → Cascade → MCP Servers → Manage**, um zu bestätigen, dass er geladen wurde, und melden Sie sich dann über den Browser an. > [tab] Zed > > Fügen Sie einen Kontext-Server in Zeds `settings.json` hinzu: > > ```json theme={null} > { > "context_servers": { > "didit": { > "source": "custom", > "command": "npx", > "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"] > } > } > } > ``` > > Zed startet die Bridge und öffnet den Browser für **Mit Didit anmelden**. > [tab] Jeder andere Client > > Jeder Client, der MCP über **Streamable HTTP** mit **OAuth 2.1** implementiert, kann sich direkt mit `https://mcp.didit.me/mcp` verbinden. Er ermittelt den Autorisierungsserver über `https://mcp.didit.me/.well-known/oauth-protected-resource/mcp`, registriert sich über Dynamic Client Registration und führt den PKCE-Flow aus. Der Server akzeptiert nur `POST` auf `/mcp`; bei `GET` und `DELETE` antwortet er mit `405`, da er zustandslos ist und keinen vom Server initiierten Stream aufrechterhält. > > Ein Client, der nur stdio unterstützt, kann dieselbe `mcp-remote`-Bridge wie Windsurf und Zed verwenden: > > ```bash theme={null} > npx -y mcp-remote@latest https://mcp.didit.me/mcp > ``` > > Um den Server ohne Client auszuprobieren, verbindet sich der [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) mit derselben URL und führt Sie durch die Anmeldung. > [!NOTE] > > **Kein API-Schlüssel in der Konfiguration.** Der gehostete Server authentifiziert Sie im Browser und handelt in **Ihrem Namen** — für jede Organisation, der Sie angehören, mit den Berechtigungen Ihrer Rolle. Siehe [Authentifizierung](https://docs.didit.me/de/integration/mcp/authentication.md). Der gehostete Server antwortet auf `GET https://mcp.didit.me/healthz` mit seiner Version. *** ## Verbindung überprüfen Fragen Sie Ihren Client nach der Anmeldung: ```text theme={null} Use the Didit MCP server to call didit_context_get and list my organizations and applications. ``` Der Agent sollte `didit_context_get` aufrufen und Ihre Organisationen mit ihren Anwendungen anzeigen. Wenn er meldet, dass er keine Didit-Tools hat, konnte keine Verbindung zum Server hergestellt werden oder die Anmeldung wurde nicht abgeschlossen: siehe [Fehlerbehebung](https://docs.didit.me/de/integration/mcp/advanced.md#fehlerbehebung). ## Self-Hosting Der gehostete Server basiert auf dem Open-Source-Repository [github.com/didit-protocol/mcp](https://github.com/didit-protocol/mcp) (MIT). Jedes Release wird auch auf npm als [`@didit-protocol/mcp-server`](https://www.npmjs.com/package/@didit-protocol/mcp-server) veröffentlicht, sodass Sie den stdio-Server direkt über npm ausführen oder beide Einstiegspunkte aus einem geklonten Repository erstellen können. Eine Codebasis stellt zwei Einstiegspunkte bereit: | Einstiegspunkt | Modus | Transport | Authentifizierung | | - | - | - | - | | `dist/http.js` | Gehostet | Streambares HTTP auf `MCP_PORT` (Standard 3000), `POST /mcp`, `GET /healthz` | OAuth 2.1 Bearer, validiert durch Token-Introspektion | | `dist/index.js` | stdio (Headless) | MCP-stdio | Ein Benutzer-Zugriffstoken in `DIDIT_ACCESS_TOKEN` | Beide Modi agieren als Didit-**Benutzer**. Es gibt keinen Anwendungs-API-Schlüssel-Modus. **1. Klonen und erstellen** ```bash theme={null} git clone https://github.com/didit-protocol/mcp.git && cd mcp npm install && npm run build ``` Oder erstellen Sie den Container: `docker build -t didit-mcp .`. Das Image führt `dist/http.js` als Nicht-Root-Benutzer aus, gibt Port 3000 frei und verfügt über einen Health-Check auf `/healthz`. **2. HTTP-Server ausführen (OAuth)** Kopieren Sie `.env.example` nach `.env` und tragen Sie die Werte für den gehosteten Modus ein, dann: ```bash theme={null} node dist/http.js # or docker run -p 3000:3000 --env-file .env didit-mcp ``` Der Server ist ausschließlich ein OAuth-Ressourcenserver. Er erfordert, dass `MCP_RESOURCE_URI` auf die vollständige öffentliche URL des Transports festgelegt ist (beispielsweise `https://mcp.example.com/mcp`, nicht nur der bloße Origin) sowie die Anmeldedaten, die er zur Introspektion von Tokens (`MCP_OAUTH_CLIENT_ID`, `MCP_OAUTH_CLIENT_SECRET`) gegenüber dem Didit-Autorisierungsserver verwendet. Die vollständige Variablenliste finden Sie unter [Erweitert → Self-Hosting](https://docs.didit.me/de/integration/mcp/advanced.md#self-hosting). **3. Oder über stdio ausführen (Headless)** Für einen lokalen Agenten, der keinen OAuth-Flow ausführen kann, führen Sie das veröffentlichte Paket aus (kein Klonen erforderlich) und übergeben Sie ein Benutzer-Zugriffstoken in der Umgebung: ```bash theme={null} DIDIT_ACCESS_TOKEN= npx -y @didit-protocol/mcp-server ``` Aus einem geklonten Repository bewirkt `DIDIT_ACCESS_TOKEN= node dist/index.js` dasselbe. Ohne Token kann sich der Agent mit `didit_account_login` anmelden, gefolgt von `didit_account_verify_2fa`, wenn für das Konto eine Zwei-Faktor-Authentifizierung eingerichtet ist. Die optionalen Variablen `MCP_DEFAULT_ORG` und `MCP_DEFAULT_APP` fixieren den Scope für Single-Tenant-Setups. Registrieren Sie ihn in Claude Code mit: ```bash theme={null} claude mcp add didit-local -e DIDIT_ACCESS_TOKEN= -- npx -y @didit-protocol/mcp-server ``` Oder in der `mcp.json` von Cursor: ```json theme={null} { "mcpServers": { "didit-local": { "command": "npx", "args": ["-y", "@didit-protocol/mcp-server"], "env": { "DIDIT_ACCESS_TOKEN": "" } } } } ``` Der Open-Source-stdio-Server enthält nicht die Tools des gehosteten Servers für Travel Rule, Marktplatz, Betrugsnetzwerk und Transaktions-SDK-Tokens oder dessen Compliance-Tools mit Ausnahme der Erstellung eines Workflows. Er fügt `didit_org_top_up`, `didit_org_reveal_application_api_key` und fünf Tools zur Kontoeinrichtung hinzu (`didit_account_register`, `didit_account_verify_email`, `didit_account_resend_otp`, `didit_account_login`, `didit_account_verify_2fa`), die Anmeldedaten als Argumente entgegennehmen und daher niemals über einen Remote-Connector bereitgestellt werden. Tools, die Dateien entgegennehmen, akzeptieren über stdio auch `*_path`-Argumente, da der Server Ihr Dateisystem teilt. *** ## Nächste Schritte > [card] [Authentifizierung](https://docs.didit.me/de/integration/mcp/authentication.md) > > Anmeldung, Scopes und Rollen. > [card] [Tools-Referenz](https://docs.didit.me/de/integration/mcp/tools.md) > > Alles, was der Agent aufrufen kann. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.