> ## 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. # Installer MCP Didit : Claude, Cursor, VS Code, Windsurf > Configurez le serveur MCP Didit sur Claude, Cursor, VS Code ou tout client MCP, ou auto-hébergez le serveur open source. Sans clé API. Choisissez votre client ci-dessous. Le serveur **hébergé** (`https://mcp.didit.me/mcp`) ne nécessite aucune clé API — lors de la première connexion, votre client ouvre un navigateur et vous vous connectez à Didit via **[Se connecter avec Didit](https://docs.didit.me/fr/integration/mcp/authentication.md)**, puis approuvez les autorisations. > [!TIP] > > **Vous utilisez Claude ?** La page [Connecter Claude](https://docs.didit.me/fr/integration/mcp/claude.md) contient le lien de connecteur en un clic qui ouvre la boîte de dialogue **Add custom connector** avec le nom et l'URL préremplis, de sorte que vous n'avez plus qu'à confirmer et vous connecter. > [!NOTE] > > Les clients qui ne prennent pas encore en charge MCP distant/HTTP (Windsurf, Zed) se connectent via la passerelle `mcp-remote`, qui relaie stdio vers l'URL hébergée et gère l'échange OAuth à votre place. *** ## Serveur hébergé (recommandé) > [tab] Claude Code > > Ajoutez le serveur avec le CLI, puis déclenchez la connexion : > > ```bash theme={null} > claude mcp add --transport http didit https://mcp.didit.me/mcp > ``` > > Lancez Claude Code et exécutez `/mcp` — cela ouvre le navigateur pour **Se connecter avec Didit**. Après votre approbation, les outils `didit` sont disponibles. > [tab] Claude web et Desktop > > Web : cliquez sur [**Add Didit to Claude →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp) et confirmez la boîte de dialogue préremplie. > > Desktop : **Settings → Connectors → Add custom connector**, nommez-le `Didit` et définissez l'URL sur : > > ```text theme={null} > https://mcp.didit.me/mcp > ``` > > Cliquez sur **Connecter** et terminez **Se connecter avec Didit** dans le navigateur. Les outils Didit apparaissent ensuite dans le menu des outils du chat. > [tab] Cursor > > Ajoutez à `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (par projet) : > > ```json theme={null} > { > "mcpServers": { > "didit": { > "url": "https://mcp.didit.me/mcp" > } > } > } > ``` > > Ou utilisez **Settings → Tools & Integrations → New MCP Server**. Cursor s'enregistre auprès de Didit via Dynamic Client Registration et ouvre le navigateur pour la connexion lors de la première utilisation. > [tab] VS Code > > Avec le mode agent de GitHub Copilot, ajoutez `.vscode/mcp.json` : > > ```json theme={null} > { > "servers": { > "didit": { > "type": "http", > "url": "https://mcp.didit.me/mcp" > } > } > } > ``` > > Ou exécutez **MCP: Add Server** depuis la palette de commandes et choisissez **HTTP**. Connectez-vous lorsque vous y êtes invité. Pointez VS Code vers l'URL `/mcp` complète : le serveur publie ses métadonnées de ressource OAuth pour ce chemin. > [tab] Windsurf > > Windsurf se connecte via la passerelle `mcp-remote`. Ajoutez à `~/.codeium/windsurf/mcp_config.json` : > > ```json theme={null} > { > "mcpServers": { > "didit": { > "command": "npx", > "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"] > } > } > } > ``` > > Ouvrez **Settings → Cascade → MCP Servers → Manage** pour confirmer qu'il est chargé, puis connectez-vous via le navigateur. > [tab] Zed > > Ajoutez un serveur de contexte dans le fichier `settings.json` de Zed : > > ```json theme={null} > { > "context_servers": { > "didit": { > "source": "custom", > "command": "npx", > "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"] > } > } > } > ``` > > Zed lance la passerelle et ouvre le navigateur pour **Se connecter avec Didit**. > [tab] Tout autre client > > Tout client qui implémente MCP sur **Streamable HTTP** avec **OAuth 2.1** peut se connecter directement à `https://mcp.didit.me/mcp`. Il découvre le serveur d'autorisation à partir de `https://mcp.didit.me/.well-known/oauth-protected-resource/mcp`, s'enregistre avec Dynamic Client Registration et exécute le flux PKCE. Le serveur accepte uniquement `POST` sur `/mcp` ; `GET` et `DELETE` répondent `405`, car il est sans état et ne maintient aucun flux initié par le serveur. > > Un client qui gère uniquement stdio peut utiliser la même passerelle `mcp-remote` que Windsurf et Zed : > > ```bash theme={null} > npx -y mcp-remote@latest https://mcp.didit.me/mcp > ``` > > Pour tester le serveur sans client, l'[Inspecteur MCP](https://modelcontextprotocol.io/docs/tools/inspector) se connecte à la même URL et vous guide tout au long de la connexion. > [!NOTE] > > **Aucune clé API dans la configuration.** Le serveur hébergé vous authentifie dans le navigateur et agit en votre nom — pour chaque organisation à laquelle vous appartenez, avec les autorisations associées à votre rôle. Voir [Authentification](https://docs.didit.me/fr/integration/mcp/authentication.md). Le serveur hébergé répond à `GET https://mcp.didit.me/healthz` avec sa version. *** ## Vérifier votre connexion Après vous être connecté, demandez à votre client : ```text theme={null} Use the Didit MCP server to call didit_context_get and list my organizations and applications. ``` L'agent doit appeler `didit_context_get` et afficher vos organisations avec leurs applications. S'il indique qu'il ne dispose d'aucun outil Didit, le serveur ne s'est pas connecté ou la connexion n'a pas abouti : voir [Dépannage](https://docs.didit.me/fr/integration/mcp/advanced.md#dépannage). ## Auto-hébergement Le serveur hébergé est conçu à partir du dépôt open source [github.com/didit-protocol/mcp](https://github.com/didit-protocol/mcp) (MIT). Chaque version est également publiée sur npm sous le nom [`@didit-protocol/mcp-server`](https://www.npmjs.com/package/@didit-protocol/mcp-server), vous pouvez donc exécuter le serveur stdio directement depuis npm ou compiler l'un ou l'autre des points d'entrée à partir d'un clone. Une seule base de code fournit deux points d'entrée : | Point d'entrée | Mode | Transport | Authentification | | - | - | - | - | | `dist/http.js` | Hébergé | HTTP en continu sur `MCP_PORT` (par défaut 3000), `POST /mcp`, `GET /healthz` | OAuth 2.1 Bearer, validé par introspection de token | | `dist/index.js` | stdio (sans interface graphique) | MCP stdio | Un token d'accès utilisateur dans `DIDIT_ACCESS_TOKEN` | Les deux modes agissent en tant qu'**utilisateur** Didit. Il n'existe pas de mode utilisant une clé API d'application. **1. Cloner et compiler** ```bash theme={null} git clone https://github.com/didit-protocol/mcp.git && cd mcp npm install && npm run build ``` Ou construisez le conteneur : `docker build -t didit-mcp .`. L'image exécute `dist/http.js` en tant qu'utilisateur non root, expose le port 3000 et dispose d'un contrôle d'état sur `/healthz`. **2. Exécuter le serveur HTTP (OAuth)** Copiez `.env.example` vers `.env` et renseignez les valeurs du mode hébergé, puis : ```bash theme={null} node dist/http.js # or docker run -p 3000:3000 --env-file .env didit-mcp ``` Le serveur est uniquement un serveur de ressources OAuth. Il nécessite que `MCP_RESOURCE_URI` soit défini sur l'URL publique complète du transport (par exemple `https://mcp.example.com/mcp`, et non l'origine seule) ainsi que les identifiants utilisés pour introspecter les tokens (`MCP_OAUTH_CLIENT_ID`, `MCP_OAUTH_CLIENT_SECRET`) auprès du serveur d'autorisation Didit. La liste complète des variables se trouve dans [Avancé → auto-hébergement](https://docs.didit.me/fr/integration/mcp/advanced.md#auto-hébergement). **3. Ou exécutez-le via stdio (sans interface graphique)** Pour un agent local ne pouvant pas exécuter de flux OAuth, lancez le package publié (aucun clone nécessaire) et transmettez un token d'accès utilisateur dans l'environnement : ```bash theme={null} DIDIT_ACCESS_TOKEN= npx -y @didit-protocol/mcp-server ``` À partir d'un clone, `DIDIT_ACCESS_TOKEN= node dist/index.js` fait de même. Sans token, l'agent peut se connecter avec `didit_account_login`, suivi de `didit_account_verify_2fa` lorsque le compte dispose de l'authentification à deux facteurs. Les variables optionnelles `MCP_DEFAULT_ORG` et `MCP_DEFAULT_APP` permettent de fixer la portée pour les configurations mono-tenant. Enregistrez-le dans Claude Code avec : ```bash theme={null} claude mcp add didit-local -e DIDIT_ACCESS_TOKEN= -- npx -y @didit-protocol/mcp-server ``` Ou dans le fichier `mcp.json` de Cursor : ```json theme={null} { "mcpServers": { "didit-local": { "command": "npx", "args": ["-y", "@didit-protocol/mcp-server"], "env": { "DIDIT_ACCESS_TOKEN": "" } } } } ``` Le serveur stdio open source n'inclut pas les outils du serveur hébergé dédiés à Travel Rule, à la place de marché, au réseau de fraude et aux outils liés aux tokens du SDK de transaction, ni ses outils de conformité autres que la création d'un workflow. Il ajoute `didit_org_top_up`, `didit_org_reveal_application_api_key`, ainsi que cinq outils de configuration de compte (`didit_account_register`, `didit_account_verify_email`, `didit_account_resend_otp`, `didit_account_login`, `didit_account_verify_2fa`) qui prennent des identifiants comme arguments et ne sont donc jamais intégrés sur un connecteur distant. Les outils acceptant des fichiers prennent également en charge les arguments `*_path` sur stdio, puisque le serveur partage votre système de fichiers. *** ## Étapes suivantes > [card] [Authentification](https://docs.didit.me/fr/integration/mcp/authentication.md) > > Connexion, scopes et rôles. > [card] [Référence des outils](https://docs.didit.me/fr/integration/mcp/tools.md) > > Tout ce que l'agent peut appeler. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.