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

# Server MCP Didit: verifica dell'identità per agenti AI

> Collega Claude, Cursor, VS Code, Windsurf e qualsiasi client MCP a Didit. KYC, KYB e AML nativi per agenti, in linguaggio naturale, ospitati o self-hosted.

Il **server MCP di Didit** collega qualsiasi client [Model Context Protocol](https://modelcontextprotocol.io), come Claude, Cursor, VS Code, Windsurf, Zed e altri, direttamente alla piattaforma di identità di Didit. Una volta connesso, un agente può eseguire KYC, KYB, screening AML, monitoraggio delle transazioni e operazioni complete sullo spazio di lavoro (workflow, sessioni, liste, webhook, fatturazione) tramite comandi in linguaggio naturale.

Questa lezione di Didit Academy collega il server MCP ospitato a Claude tramite OAuth, poi crea un workflow KYC con un solo prompt, interroga la coda di revisione e testa retroattivamente le regole sulle transazioni su 90 giorni di storico.

[Usa Didit con MCP — Didit Academy](https://www.youtube.com/embed/I3UkFIhW548?rel=0\&playsinline=1)

> [!NOTE]
>
> L'MCP di Didit è **in lettura e scrittura**: gli agenti possono creare sessioni, configurare workflow, aggiornare gli stati e aggiungere voci alle tue liste per tuo conto. Ogni client ti chiede di verificare le chiamate agli strumenti prima che vengano eseguite. Mantieni questa verifica attiva, soprattutto per le azioni di scrittura e di cancellazione.

***

## Inizia in 30 secondi

La via più rapida è il **server ospitato**: un solo URL, nessuna chiave API. Il tuo client apre il browser, tu **accedi con Didit**, approvi le autorizzazioni e sei connesso.

```text Hosted endpoint theme={null}
https://mcp.didit.me/mcp
```

> [!TIP]
>
> **Su Claude per il web**, [**Aggiungi Didit a Claude →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp) precompila la finestra di dialogo del connettore: conferma, accedi con Didit, fatto. Procedura completa in [Collega Claude](https://docs.didit.me/it/integration/mcp/claude.md). Il codice sorgente è disponibile su [GitHub](https://github.com/didit-protocol/mcp) (licenza MIT).

> [card] [Installa nel tuo client](https://docs.didit.me/it/integration/mcp/installation.md)
>
> Configurazione pronta da copiare per Claude, Cursor, VS Code, Windsurf e Zed.

> [card] [Come funziona l'accesso](https://docs.didit.me/it/integration/mcp/authentication.md)
>
> "Accedi con Didit" (OAuth 2.1 con PKCE): nessuna chiave API, nessun segreto nella configurazione.

> [card] [Esplora gli strumenti](https://docs.didit.me/it/integration/mcp/tools.md)
>
> 169 strumenti per sessioni, workflow, controlli indipendenti, monitoraggio delle transazioni, liste, casi, report e webhook.

> [card] [Vedilo in azione](https://docs.didit.me/it/integration/mcp/examples.md)
>
> Esempi di prompt e conversazioni complete con l'agente.

***

## Come funziona

L'MCP ospitato è un **server delle risorse** OAuth 2.1; la Business Console di Didit (`business.didit.me`) è il **server di autorizzazione**. Ti connetti con un solo URL, **accedi con Didit** nel browser, e l'MCP agisce quindi come **te**, in tutte le organizzazioni a cui appartieni, con le autorizzazioni del tuo ruolo nella console.

> [!NOTE]
>
> **L'MCP agisce come utente Didit, non come applicazione: non esiste una modalità con chiave API.** Ogni strumento chiama gli endpoint della console con ambito utente, che accettano solo il tuo token Bearer. (Per chiamare direttamente la REST API con una chiave API di applicazione, ad esempio per creare sessioni dal tuo backend, usa la [REST API](https://docs.didit.me/openapi-25.json): è separata da questo MCP.)

Il server è un Streamable HTTP stateless: una sola `POST https://mcp.didit.me/mcp` per richiesta, senza affinità di sessione, e un controllo dello stato pubblico su `GET https://mcp.didit.me/healthz`.

Preferisci eseguire il server per conto tuo? Puoi farlo: vedi [Installazione → hosting autonomo](https://docs.didit.me/it/integration/mcp/installation.md#self-hosting). Anche in questo caso l'utente viene autenticato tramite OAuth (oppure con un token Bearer utente per esecuzioni stdio senza interfaccia).

Gli strumenti restituiscono il JSON originale degli endpoint Didit sottostanti. Per il quadro completo vedi [Autenticazione](https://docs.didit.me/it/integration/mcp/authentication.md).

***

## Cosa puoi fare con questo strumento?

Chiedi in linguaggio naturale. Ecco alcune cose che l'agente può fare su **tutte le tue app contemporaneamente**:

* *"Mostrami le ultime 5 sessioni in revisione su tutte le mie app."*
* *"Quante persone hanno provato la verifica telefonica ma hanno abbandonato negli ultimi 15 giorni?"*
* *"Crea un workflow KYC con scansione del documento e rilevamento della vitalità, poi dammi un link di verifica."*
* *"Trova il cliente con vendor\_data `user_8842`: in quale app si trova e qual è il suo stato?"*
* *"Esegui lo screening AML di questo wallet e aggiungilo alla blocklist se rileva una corrispondenza."*
* *"Registra una destinazione webhook per gli aggiornamenti di stato sul mio endpoint."*
* *"Qual è il mio saldo del credito e il tasso di conversione di questo mese?"*

***

## Pensato per l'era agentica

La maggior parte delle piattaforme di verifica richiede una configurazione manuale della console. Didit consente a un agente di fare tutto il lavoro, dall'inizio alla fine: **configurare i workflow**, **creare e revisionare le sessioni**, **collegare i webhook** e **monitorare la fatturazione**. Abbinando l'MCP all'[integrazione con un solo prompt](https://docs.didit.me/it/integration/integration-prompt.md), un agente può realizzare un'integrazione completa (route del backend, SDK del frontend e gestore dei webhook) chiamando in tempo reale gli strumenti MCP per creare il workflow e la sessione.

> [card] [Installazione](https://docs.didit.me/it/integration/mcp/installation.md)
>
> Configurazione specifica per Claude, Cursor, VS Code, Windsurf e Zed, oltre al hosting autonomo.

> [card] [Autenticazione](https://docs.didit.me/it/integration/mcp/authentication.md)
>
> Accesso OAuth, ambiti e ruoli.

> [card] [Riferimento degli strumenti](https://docs.didit.me/it/integration/mcp/tools.md)
>
> Tutti gli strumenti, raggruppati per area, con il relativo ambito e le autorizzazioni del ruolo.

> [card] [Funzionalità avanzate e risoluzione dei problemi](https://docs.didit.me/it/integration/mcp/advanced.md)
>
> Ruoli, comportamento tra app, workflow con diramazioni, webhook e hosting autonomo.


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