Instal·lar MCP Didit: Claude, Cursor, VS Code, Windsurf

Tria el teu client a continuació. El servidor allotjat (https://mcp.didit.me/mcp) no necessita clau d’API: en connectar-te per primera vegada, el client obre un navegador, fas clic a Iniciar sessió amb Didit i aprovas els permisos.

Fas servir Claude? La pàgina Connecta Claude té l’enllaç del connector d’un sol clic, que obre el diàleg Add custom connector amb el nom i la URL ja omplerts, així que només has de confirmar i iniciar sessió.

Els clients que encara no admeten MCP remot/HTTP (Windsurf, Zed) es connecten mitjançant el pont mcp-remote, que redirigeix stdio cap a la URL allotjada i gestiona per tu l’intercanvi d’OAuth.

Servidor allotjat (recomanat)

Afegeix el servidor amb la CLI i després activa l’inici de sessió:

claude mcp add --transport http didit https://mcp.didit.me/mcp

Inicia Claude Code i executa /mcp: s’obrirà el navegador perquè iniciïs sessió amb Didit. Després d’aprovar-ho, les eines didit estaran disponibles.

Web: fes clic a Afegeix Didit a Claude → i confirma el diàleg amb els camps ja omplerts.Desktop: Settings → Connectors → Add custom connector, posa-li el nom Didit i estableix la URL a:

https://mcp.didit.me/mcp

Fes clic a Connect i completa el procés d’iniciar sessió amb Didit al navegador. Les eines de Didit apareixeran després al menú d’eines del xat.

Afegeix a ~/.cursor/mcp.json (global) o a .cursor/mcp.json (per projecte):

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

O bé fes servir Settings → Tools & Integrations → New MCP Server. Cursor es registra a Didit mitjançant Dynamic Client Registration i obre el navegador per iniciar sessió la primera vegada que l’utilitzes.

Amb el mode agent de GitHub Copilot, afegeix .vscode/mcp.json:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

O bé executa MCP: Add Server des de la paleta de comandaments i tria HTTP. Inicia sessió quan se’t demani. Indica a VS Code la URL completa /mcp: el servidor publica les seves metadades del recurs OAuth per a aquesta ruta.

Windsurf es connecta mitjançant el pont mcp-remote. Afegeix a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "didit": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Obre Settings → Cascade → MCP Servers → Manage per confirmar que s’ha carregat i després inicia sessió des del navegador.

Afegeix un servidor de context al fitxer settings.json de Zed:

{
  "context_servers": {
    "didit": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
    }
  }
}

Zed inicia el pont i obre el navegador per a Iniciar sessió amb Didit.

Qualsevol client que implementi MCP sobre Streamable HTTP amb OAuth 2.1 pot connectar-se directament a https://mcp.didit.me/mcp. Descobreix el servidor d’autorització a partir de https://mcp.didit.me/.well-known/oauth-protected-resource/mcp, es registra amb Dynamic Client Registration i executa el flux PKCE. El servidor només accepta POST a /mcp; GET i DELETE responen amb 405, perquè no manté estat i no manté cap flux iniciat pel servidor.Un client que només parla stdio pot fer servir el mateix pont mcp-remote que Windsurf i Zed:

npx -y mcp-remote@latest https://mcp.didit.me/mcp

Per provar el servidor sense client, el MCP Inspector es connecta a la mateixa URL i et guia durant l’inici de sessió.

Sense clau d’API a la configuració. El servidor allotjat t’autentica al navegador i actua en nom teu a totes les organitzacions de les quals ets membre, amb els permisos del teu rol. Consulta Autenticació.

El servidor allotjat respon a GET https://mcp.didit.me/healthz amb la seva versió.

Verifica la connexió

Després d’iniciar sessió, demana al teu client:

Use the Didit MCP server to call didit_context_get and list my organizations and applications.

L’agent hauria de cridar didit_context_get i mostrar les teves organitzacions amb les seves aplicacions. Si diu que no té eines de Didit, el servidor no s’ha connectat o l’inici de sessió no s’ha completat: consulta Resolució de problemes.

Autoallotjament

El servidor allotjat es compila a partir del repositori de codi obert github.com/didit-protocol/mcp (MIT). Cada versió també es publica a npm com a @didit-protocol/mcp-server, de manera que pots executar el servidor stdio directament des de npm o compilar qualsevol dels dos punts d’entrada des d’un clon. Una mateixa base de codi conté dos punts d’entrada:

Punt d’entrada	Mode	Transport	Autenticació
`dist/http.js`	Allotjat	HTTP en flux (Streamable HTTP) al `MCP_PORT` (per defecte 3000), `POST /mcp`, `GET /healthz`	Bearer OAuth 2.1, validat mitjançant introspecció de tokens
`dist/index.js`	stdio (sense interfície)	MCP stdio	Un token d’accés d’usuari a `DIDIT_ACCESS_TOKEN`

Tots dos modes actuen com a usuari de Didit. No hi ha un mode de clau d’API d’aplicació.

Clona i compila

git clone https://github.com/didit-protocol/mcp.git && cd mcp
npm install && npm run build

O crea el contenidor: docker build -t didit-mcp .. La imatge executa dist/http.js com a usuari no root, exposa el port 3000 i té una comprovació d’estat a /healthz.

Executa el servidor HTTP (OAuth)

Copia .env.example a .env, omple els valors del mode allotjat i, després, executa:

node dist/http.js
# or
docker run -p 3000:3000 --env-file .env didit-mcp

El servidor només és un servidor de recursos OAuth. Necessita que MCP_RESOURCE_URI estigui definit amb l’URL pública completa del transport (per exemple https://mcp.example.com/mcp, no només l’origen) i les credencials que utilitza per fer la introspecció de tokens (MCP_OAUTH_CLIENT_ID, MCP_OAUTH_CLIENT_SECRET) davant del servidor d’autorització de Didit. La llista completa de variables és a Avançat → autoallotjament.

O executa-ho per stdio (sense interfície)

Per a un agent local que no pot fer un flux OAuth, executa el paquet publicat (no cal clonar res) i passa un token d’accés d’usuari a l’entorn:

DIDIT_ACCESS_TOKEN=<user-access-token> npx -y @didit-protocol/mcp-server

Des d’un clon, DIDIT_ACCESS_TOKEN=<user-access-token> node dist/index.js fa el mateix. Sense token, l’agent pot iniciar sessió amb didit_account_login, seguit de didit_account_verify_2fa quan el compte té l’autenticació de dos factors activada.Les variables opcionals MCP_DEFAULT_ORG i MCP_DEFAULT_APP fixen l’àmbit per a configuracions d’un sol inquilí. Registra-ho a Claude Code amb:

claude mcp add didit-local -e DIDIT_ACCESS_TOKEN=<user-access-token> -- npx -y @didit-protocol/mcp-server

O al fitxer mcp.json de Cursor:

{
  "mcpServers": {
    "didit-local": {
      "command": "npx",
      "args": ["-y", "@didit-protocol/mcp-server"],
      "env": { "DIDIT_ACCESS_TOKEN": "<user-access-token>" }
    }
  }
}

El servidor stdio de codi obert no inclou les eines de Travel Rule, del mercat, de la xarxa de frau ni les eines de tokens de l’SDK de transaccions del servidor allotjat, ni les seves eines de compliment, tret de les que permeten crear un flux de treball. Sí que afegeix didit_org_top_up, didit_org_reveal_application_api_key i cinc eines de configuració del compte (didit_account_register, didit_account_verify_email, didit_account_resend_otp, didit_account_login, didit_account_verify_2fa), que reben les credencials com a arguments i, per tant, mai no es distribueixen en un connector remot. Les eines que reben fitxers també accepten arguments *_path en stdio, perquè el servidor comparteix el sistema de fitxers.

Guies

Autenticació

Model Context Protocol (MCP)

SDK web

SDK natius

SDK de servidor

Integracions

Instal·lar MCP Didit: Claude, Cursor, VS Code, Windsurf

Servidor allotjat (recomanat)

Verifica la connexió

Autoallotjament

Següents passos

Autenticació

Referència d'eines

​Servidor allotjat (recomanat)

​Verifica la connexió

​Autoallotjament

​Següents passos

Autenticació

Referència d'eines

Servidor allotjat (recomanat)

Verifica la connexió

Autoallotjament

Següents passos