Passer au contenu principal
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, puis approuvez les autorisations.
Vous utilisez Claude ? La page Connecter Claude 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.
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é)

Ajoutez le serveur avec le CLI, puis déclenchez la connexion :
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.
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.
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 :
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.

Auto-hébergement

Le serveur hébergé est conçu à partir du dépôt open source github.com/didit-protocol/mcp (MIT). Chaque version est également publiée sur npm sous le nom @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 : 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

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 :
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.
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 :
À partir d’un clone, DIDIT_ACCESS_TOKEN=<user-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 :
Ou dans le fichier mcp.json de Cursor :
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

Authentification

Connexion, scopes et rôles.

Référence des outils

Tout ce que l’agent peut appeler.
Dernière modification le 7 novembre 2026