> ## 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.

# Collegare Cursor al server MCP di Didit

> Aggiungi il server MCP di Didit a Cursor con un clic o con un mcp.json di tre righe, poi accedi con Didit. Nessuna chiave API richiesta.

Cursor si connette al server MCP ospitato da Didit (`https://mcp.didit.me/mcp`) con un solo link di installazione o con tre righe di `mcp.json`. Al primo utilizzo Cursor apre **Log in with Didit** nel browser; non c'è nessuna chiave API da copiare.

> [card] [Aggiungi Didit a Cursor](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D)
>
> Apre la pagina di installazione di Cursor, che avvia Cursor e aggiunge il server `didit` con l'URL mcp.didit.me/mcp. Conferma l'installazione, quindi accedi con Didit.

Il link di installazione, se vuoi associarlo a un tuo pulsante o in un README:

```text theme={null}
https://cursor.com/install-mcp?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D
```

Racchiude il deeplink di Cursor, che puoi usare anche direttamente:

```text theme={null}
cursor://anysphere.cursor-deeplink/mcp/install?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ==
```

Il valore `config` è la codifica base64 di `{"url":"https://mcp.didit.me/mcp"}`.

***

## Configurazione per metodo

> [tab] Link di installazione
>
> 1. Fai clic su [**Add Didit to Cursor →**](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D). Il browser chiede di aprire Cursor; consentilo.
> 2. Cursor mostra il server `didit` con URL `https://mcp.didit.me/mcp`. Conferma l'installazione.
> 3. Quando Cursor indica che `didit` richiede l'accesso, fai clic per connetterti e completa **Log in with Didit** nel browser.
>
> Se Cursor non si apre, la pagina di installazione stampa la configurazione da incollare manualmente in `mcp.json`.

> [tab] mcp.json
>
> Aggiungi Didit a `~/.cursor/mcp.json` (tutti i progetti) oppure a `.cursor/mcp.json` (un solo progetto):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> Mantieni i server già presenti all'interno di `mcpServers`. Al primo utilizzo Cursor si registra automaticamente presso Didit e apre il browser per **Log in with Didit**.

> [tab] Riga di comando
>
> Il comando `cursor` può aggiungere il server al tuo profilo utente:
>
> ```bash theme={null}
> cursor --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> Stampa `Added MCP servers: didit`. Apri Cursor e accedi quando richiesto.

> [!NOTE]
>
> **Nessuna chiave API nella configurazione.** Il server usa OAuth 2.1 con PKCE e agisce **per conto tuo**: solo nelle organizzazioni che approvi durante l'accesso, con i permessi del tuo ruolo. Vedi [Autenticazione](https://docs.didit.me/it/integration/mcp/authentication.md).

***

## Verifica che funzioni

Nella chat dell'agente di Cursor, chiedi:

```text theme={null}
Use the Didit MCP server to call didit_context_get and list my organizations and applications.
```

L'agente chiama `didit_context_get` ed elenca le tue organizzazioni con le relative applicazioni. Poi mettilo al lavoro sul tuo codebase:

* "Crea un workflow KYC in sandbox con verifica dell'identità e rilevamento della vitalità, poi aggiungi l'SDK web di Didit a questa app usando quel workflow."
* "Registra una destinazione webhook per gli aggiornamenti dello stato delle sessioni che punti alla mia route `/api/didit/webhook`, e scrivi il gestore che verifica la firma."
* "Crea una sessione di test per `user_123` e dammi il link di verifica."

***

## Risoluzione dei problemi

* **Cursor non si è aperto dal link.** Incolla invece il JSON dalla scheda **mcp.json**.
* **Il processo di accesso entra in un ciclo o non riesce.** Accedi prima a [business.didit.me](https://business.didit.me) dal browser predefinito, poi connettiti di nuovo.
* **Uno strumento risponde con `missing_scope`.** Il tuo ruolo in quell'organizzazione non ha l'autorizzazione necessaria. Vedi [ruoli e autorizzazioni](https://docs.didit.me/it/integration/mcp/authentication.md#ruoli-e-autorizzazioni).
* **L'agente dice di non avere strumenti Didit.** Verifica che il server `didit` sia abilitato nelle impostazioni MCP di Cursor e che l'accesso sia stato completato. Vedi [Risoluzione dei problemi](https://docs.didit.me/it/integration/mcp/advanced.md#risoluzione-dei-problemi).

***

## Prossimi passi

> [card] [Connetti VS Code](https://docs.didit.me/it/integration/mcp/vscode.md)
>
> Link di installazione e mcp.json per GitHub Copilot in VS Code.

> [card] [Connetti OpenAI Codex](https://docs.didit.me/it/integration/mcp/codex.md)
>
> Un solo comando per la CLI di Codex e l'estensione per l'IDE.

> [card] [Riferimento agli strumenti](https://docs.didit.me/it/integration/mcp/tools.md)
>
> Tutto ciò che l'agente può chiamare, strumento per strumento.

> [card] [Integrazione con un singolo prompt](https://docs.didit.me/it/integration/mcp/examples.md)
>
> Esempi svolti di un agente che crea un'integrazione Didit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.