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

# Exemples del MCP de Didit: prompts i converses amb agents

> Exemples de prompts i converses amb agents del MCP de Didit: flux i sessió KYC, cerca al registre KYB, cua de revisió, prova de regla i webhook.

## Peticions ràpides

A continuació hi ha alguns patrons que mostren què pot fer l'MCP de Didit. Formula les coses en llenguatge natural: l'agent tria les eines. Totes les eines que s'esmenten aquí existeixen a la [referència d'eines](https://docs.didit.me/ca/integration/mcp/tools.md).

***

**Operacions i monitoratge (entre aplicacions)**

* *"Mostra'm les 5 últimes sessions en revisió de totes les meves aplicacions."* → `didit_session_search` amb `status: "In Review"`, `limit: 5`
* *"Quantes persones van intentar la verificació de telèfon però van abandonar en els últims 15 dies?"* → `didit_analytics` amb `last_n_days: 15` (una sola crida; llegeix l'embut de funcionalitats)
* *"Troba el client amb vendor\_data `user_8842` i digue'm de quina aplicació és i quin estat té."* → `didit_vendor_user_search`
* *"Quin és el meu saldo de crèdits i la taxa de conversió d'aquest mes?"* → `didit_org_get_balance` + `didit_analytics`

**Configuració**

* *"Crea un flux de treball KYC amb escaneig del document d'identitat i prova de vida, i dona'm un enllaç de verificació."* → `didit_workflow_create` → `didit_session_create`
* *"Crea un flux de treball de verificació d'identitat que només accepti passaports, i després una prova de vida amb selfie."* → `didit_workflow_create`; digues només `documents_allowed: ["PASSPORT"]`. L'MCP ho amplia perquè només s'acceptin passaports de tots els països (consulta [Avançat → configuracions de funcionalitats](https://docs.didit.me/ca/integration/mcp/advanced.md#configuracions-de-funcionalitats-i-llistes-de-permesos)).
* *"Flux de treball nou: escaneja un passaport; si el document d'identitat és rebutjat, rebutja la sessió; si la professió declarada és ≈ 'Software Engineer' (≥60%), fes una prova de vida; en cas contrari, demana un comprovant de domicili en espanyol; després decideix automàticament."* → `didit_workflow_get_field_definitions` → `didit_workflow_validate_graph` → `didit_workflow_set_graph`
* *"Al flux de treball `26d33c04…`, després de la verificació d'identitat: si es rebutja, rebutja la sessió; si la professió és ≥80% similar a 'Software Engineer', afegeix un pas de comprovant de fons amb Document AI; després continua."* → `didit_workflow_search` → `didit_workflow_get_graph` → `didit_workflow_edit_graph` (petites operacions, desades com a esborrany revisable)
* *"En quins països puc oferir un inici de sessió amb BankID o MitID en lloc d'un escaneig del document?"* → `didit_workflow_get_id_verification_methods_catalog`
* *"Registra una destinació de webhook per a les actualitzacions d'estat a `https://myapp.com/webhooks/didit`."* → `didit_webhook_create`

**Compliment**

* *"Fes un cribratge AML d'aquesta cartera i afegeix-la a la llista de bloqueig si coincideix."* → `didit_transaction_screen_wallet` → `didit_blocklist_add`
* *"Obre un cas per a la sessió `…` i assigna-me'l."* → `didit_case_create` → `didit_case_manage`
* *"Acme Ltd és una empresa registrada al Regne Unit? I qui són els seus accionistes?"* → `didit_verify_kyb_search` → `didit_verify_kyb_select`

***

## 1. Posar en marxa la verificació

> **Tu:** "Configura la verificació d'identitat de Didit per a la meva aplicació amb escaneig del document d'identitat i prova de vida, i dona'm un enllaç per provar-la."
>
> **Agent:** Primer crearé el flux de treball. *(crida `didit_workflow_create` amb `workflow_label: "Standard KYC"`, `features: [{ "feature": "OCR" }, { "feature": "LIVENESS" }]`)* — Publicat **"Standard KYC"**, `workflow_id = 6f2c…`. Ara una sessió per provar-lo. *(crida `didit_session_create` amb `workflow_id: "6f2c…"`, `vendor_data: "test-user-1"`)* — Aquest és el teu enllaç: `https://verify.didit.me/session/…`. Obre'l al mòbil per executar el flux de treball. En producció, el teu backend crea sessions amb l'API REST:
>
> ```bash theme={null}
> curl -X POST https://verification.didit.me/v3/session/ \
>   -H "x-api-key: $DIDIT_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "workflow_id": "6f2c...", "vendor_data": "internal-user-id", "callback": "https://myapp.com/done" }'
> ```
>
> Aquest `x-api-key` és la **clau d'API REST** de la teva aplicació per al teu backend; és diferent de la manera com has iniciat sessió en aquest MCP, que usa *Log in with Didit*. Vols que registri també la destinació del webhook?
>
> **Tu:** "Sí; el meu endpoint és `https://myapp.com/webhooks/didit`."
>
> **Agent:** *(crida `didit_webhook_create` amb `label: "Production"`, `url: "https://myapp.com/webhooks/didit"`, `webhook_version: "v3"`, `subscribed_events: ["status.updated"]`)* — Fet. El secret de signatura està ocult en la resposta que rebo, així que copia'l des de **Webhooks** a la consola i guarda'l com a `DIDIT_WEBHOOK_SECRET`. Verifica la capçalera `X-Signature-V2` de cada lliurament abans de confiar-hi.

***

## 2. KYB: comprovar una empresa al registre mercantil

> **Tu:** "Acme Trading Ltd és una empresa real del Regne Unit? Tinc el número de registre 12345678."
>
> **Agent:** *(crida `didit_verify_kyb_search` amb `country_code: "GB"`, `name: "Acme Trading Ltd"`, `registration_number: "12345678"`)* — Hi ha un candidat: **ACME TRADING LTD**, constituïda el 2019, estat *actiu*, domicili social a Manchester. Vols el registre complet amb administradors i accionistes?
>
> **Tu:** "Sí, i digue'm qui són els titulars reals."
>
> **Agent:** *(crida `didit_verify_kyb_select` amb el `kyb_response_id` del candidat)* — Registre complet recuperat: dos administradors i una persona amb control significatiu que té el 75% o més de les accions i dels drets de vot. El registre inclou l'historial de presentacions i el domicili social. Aquesta va ser una consulta de registre facturable (dues crides que consumeixen crèdits). Si vols que això passi automàticament per a cada client empresarial, puc afegir `KYB_REGISTRY` a un flux de treball KYB amb `didit_workflow_create`; `didit_workflow_get_kyb_registry_catalog` ens indica quins nivells de dades ven el registre mercantil del Regne Unit.

***

## 3. Gestiona la cua de revisió

> **Tu:** "Què està pendent de la meva revisió i què falla en cadascun?"
>
> **Agent:** *(crida `didit_session_search` amb `status: "In Review"`, `limit: 10`)* Hi ha quatre sessions en revisió en dues aplicacions. Llegeixo la decisió de cadascuna. *(crida `didit_session_get_decision` per a cada `session_id`)*
>
> | Sessió | Aplicació | Per què s'ha aturat |
> | - | - | - |
> | `a1f3…` | Alta | Puntuació de coincidència facial 71 (llindar 80), prova de vida superada |
> | `b7c2…` | Alta | Document caducat fa 2 mesos |
> | `c904…` | Marketplace | AML: una coincidència PEP, coincidència de nom del 92%, data de naixement diferent |
> | `d215…` | Marketplace | Comprovant de domicili de més de 90 dies |
>
> **Tu:** "Aprova `a1f3`: he mirat la selfie i és la mateixa persona. Rebutja `b7c2`, document caducat."
>
> **Agent:** *(crida `didit_session_update_status` amb `session_id: "a1f3…"`, `new_status: "Approved"`, i després amb `session_id: "b7c2…"`, `new_status: "Declined"`, `comment: "Expired document"`)* Totes dues s'han actualitzat. *(crida `didit_session_add_review` sobre `a1f3…` amb la nota "Manual selfie review: same person")* S'ha afegit una nota de revisió perquè el registre d'auditoria mostri per què s'ha sobreescrit la puntuació. Els dos casos d'AML i de comprovant de domicili continuen oberts; digues-m'ho i obriré un cas per a la coincidència PEP amb `didit_case_create`.

***

## 4. Prova retrospectiva d'una regla de transaccions abans de publicar-la

> **Tu:** "Vull marcar qualsevol persona que faci més de 3 transferències de més de \$1,000 en una hora. Quant de soroll generaria?"
>
> **Agent:** *(crida `didit_transaction_rule_backtest` amb `conditions` sobre `amount > 1000`, una `aggregation` de recompte ≥ 3 en una finestra d'1 hora, `period_days: 90`)* Durant els últims 90 dies aquesta regla s'hauria activat en 14 transaccions de 6 subjectes; 2 d'aquests subjectes ja estan marcats. Vols que la creï en mode `TEST`, perquè registri les coincidències sense executar cap acció?
>
> **Tu:** "Sí, mode TEST."
>
> **Agent:** *(crida `didit_transaction_rule_create` amb `title: "Velocity: 3+ transfers over $1,000 per hour"`, `category: "aml_ctf"`, `mode: "TEST"`, els mateixos `conditions` i `aggregation`, i una llista `actions` que marca el subjecte)* Creada. Revisa-la amb `didit_transaction_rule_get` d'aquí a uns dies; quan estiguis satisfet, `didit_transaction_rule_update` canvia `mode` a `ACTIVE`. `didit_transaction_rule_library_list` també té les regles de velocitat predefinides de Didit si prefereixes instal·lar-ne una.

***

## Els resultats de la sessió són asíncrons

`didit_session_create` retorna un `session_id`, un `session_token` i una `url` allotjada, però la verificació encara no s'ha fet. L'usuari obre la `url` i completa el flux. La decisió final arriba mitjançant:

1. Un webhook `status.updated` (recomanat), o
2. `didit_session_get_decision` (sondeig, com a alternativa).

Totes dues tenen la mateixa estructura: **sempre matrius en plural** amb un `node_id` per entrada:

```json theme={null}
{
  "session_id": "uuid",
  "status": "Approved",
  "session_kind": "user",
  "id_verifications":  [ { "node_id": "first_id", "status": "Approved", "first_name": "Jane" } ],
  "liveness_checks":   [ { "node_id": "first_liveness", "status": "Approved", "score": 95.4 } ],
  "face_matches":      [ { "node_id": "first_face_match", "status": "Approved", "score": 96.1 } ],
  "aml_screenings":    [ { "node_id": "first_aml", "status": "Approved", "total_hits": 0, "hits": [] } ],
  "reviews": []
}
```

No llegeixis mai les claus V2 en singular (`id_verification`, `liveness`): només s'envien quan un destí es fixa explícitament a `webhook_version: "V2"`. Consulta [Models de dades](https://docs.didit.me/ca/reference/data-models.md) per a la referència de camps de cada funcionalitat i [Avançat → Webhooks](https://docs.didit.me/ca/integration/mcp/advanced.md#gestió-dels-webhooks) per a les regles de verificació i reintents.

***

## Combina-ho amb la integració de prompt únic

El MCP serveix molt bé per *executar* Didit. Perquè un agent *escrigui* una integració completa (ruta de backend + SDK de frontend + gestor de webhooks + esquema de BD), passa-li el [Prompt d'integració](https://docs.didit.me/ca/integration/integration-prompt.md): recorre els set passos i crida les eines MCP per crear el flux de treball, la sessió i el webhook en viu.

***

> [card] [Referència d'eines](https://docs.didit.me/ca/integration/mcp/tools.md)
>
> Totes les eines que l'agent pot cridar.

> [card] [Avançat i resolució de problemes](https://docs.didit.me/ca/integration/mcp/advanced.md)
>
> Rols, comportament entre aplicacions, webhooks i autoallotjament.


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