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

# Conjunts d'eines MCP de Didit i mode només lectura

> Carrega només les eines MCP de Didit que necessitis amb conjunts d'eines, connecta't en mode només lectura i cerca la resta sota demanda.

Els conjunts d'eines permeten que una connexió MCP de Didit carregui una llista curta d'eines en lloc de tot el catàleg, i el mode de només lectura et dona una connexió que mai no pot modificar dades.
Tots dos són paràmetres de la URL del servidor:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true
```

Sense cap paràmetre, el servidor llista totes les eines que el teu rol pot utilitzar, de manera que no canvia res per a una connexió que ja tens.

## Per què carregar menys eines

El teu client envia la definició de cada eina llistada al model abans de la teva primera pregunta.
Per al catàleg complet de Didit, això suposa desenes de milers de tokens a cada sol·licitud: aproximadament entre 50.000 i 115.000, segons el tokenitzador del model.
Alguns clients també limiten el nombre d'eines que accepten.

| Què carrega la connexió | Eines llistades | Proporció d'aquests tokens |
| - | - | - |
| Tot (sense paràmetre) | Totes les eines que pot utilitzar el teu rol | Totes |
| La llista curta, `core` | Unes 30 | Aproximadament una desena part |
| La llista curta, de només lectura | Unes 20 | Menys d'una desena part |

El compromís és un pas extra.
Una eina fora de la llista no es perd, però el model l'ha de trobar amb [cerca d'eines](#accedir-a-les-eines-que-no-has-carregat) abans de poder-la executar, i un model que veu totes les eines tria la correcta una mica més sovint que un model que ha de cercar-la.
Carrega-les totes quan una conversa abasta moltes àrees i el cost de context no importa.
Carrega `core`, més els conjunts d'eines que més utilitzes, quan sí que importa.

## Tria els teus conjunts d'eines

Afegeix `toolsets` a la URL del servidor amb una llista separada per comes:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases
```

`core` és la llista curta amb la qual comencen la majoria de feines.
Inclou les teves organitzacions i aplicacions, les sessions de verificació (crear, buscar, decidir, explicar, simular al sandbox i llegir els lliuraments de webhook), la cerca de fluxos de treball, l'analítica i el saldo, la clau d'API i els webhooks de la teva aplicació, la cerca de casos, usuaris, empreses i transaccions, i la cerca a la documentació.

* `core`: la llista curta de dalt.
* `account`: organitzacions, aplicacions, claus d'API, membres i rols.
* `billing`: pla, saldo de crèdit, mètodes de pagament, rebuts i dades de facturació.
* `sessions`: sessions de verificació (crear, buscar, decidir, revisar, compartir, importar, PDFs i lliuraments de webhook).
* `workflows`: fluxos de treball de verificació i qüestionaris (crear, editar, validar i publicar).
* `lists`: llistes personalitzades, la llista de bloqueig i la llista d'admesos.
* `vendors`: les persones i empreses que verifiques (usuaris de proveïdors i empreses proveïdores).
* `transactions`: monitoratge de transaccions (transaccions, cribratge de carteres i regles amb backtesting).
* `cases`: gestió de casos (crear, assignar, escalar i resoldre casos).
* `investigator`: l'Investigator (la seva cua de revisió, informes, decisions, preguntes de política i rendiment).
* `webhooks`: destinacions del webhook i alertes.
* `reports`: analítica, exportacions i el registre d'auditoria.
* `branding`: personalització de marca blanca del flux de verificació.
* `verification`: APIs de verificació independents (document d'identitat, facial, AML, prova de domicili, telèfon, correu electrònic, validació en bases de dades i comprovacions d'empreses).
* `travel_rule`: Travel Rule (configuració, el directori de VASP, xarxes, adreces, transferències i missatges).
* `marketplace`: el mercat de proveïdors (el catàleg, les teves connexions i les sol·licituds d'integració).
* `networks`: xarxes de frau (sessions, usuaris i empreses enllaçats que comparteixen un dispositiu, un document o un contacte).
* `compliance`: l'assistent de compliment (el teu perfil regulatori, els seus requisits i els fluxos de treball generats a partir d'aquests).
* `docs`: cerca a la documentació de Didit.
* `all`: totes les eines que el teu rol pot utilitzar. És el valor per defecte.

La [referència de les eines](https://docs.didit.me/ca/integration/mcp/tools.md) enumera totes les eines amb el seu tipus i el permís del rol que necessita.

Com es comporta la selecció:

* **Els conjunts d'eines requereixen activació explícita.** Una URL sense `toolsets` llista-ho tot.
* **Si anomenes conjunts d'eines, se'n llisten exactament aquests.** `?toolsets=cases` llista les eines de casos, més `didit_context_get`, que obté cada connexió. Afegeix `core` si també vols mantenir la llista curta.
* **Un conjunt d'eines decideix què es llista, no què pots executar.** Una eina fora de la teva selecció s'executa igualment quan el model la crida pel nom, amb els mateixos permisos de rol de sempre.
* **Un nom que el servidor no coneix s'ignora.** La connexió continua funcionant, i el servidor indica al model quin nom ha ignorat i quins són els vàlids.
* **El teu rol continua aplicant-se.** Un conjunt d'eines mai no concedeix un permís: consulta [rols i permisos](https://docs.didit.me/ca/integration/mcp/authentication.md#rols-i-permisos).

## Connecta en mode només lectura

Afegeix `read_only=true` a la URL del servidor:

```text theme={null}
https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&read_only=true
```

Una connexió de només lectura només llista les eines que llegeixen, i el servidor rebutja cada crida que crearia, modificaria o eliminaria alguna cosa.
El rebuig es produeix al servidor en cada crida, de manera que es manté fins i tot si el client recorda una eina d'una connexió anterior.
Utilitza-la per a informes, per explorar un compte o per a un agent que no vols que actuï per si sol.

Per tornar a permetre els canvis, connecta sense `read_only`.

## Accedir a les eines que no has carregat

Quan una connexió només llista una part del catàleg, el servidor afegeix quatre eines perquè no quedi res fora de l'abast:

* `didit_tool_search` (lectura): troba eines segons el que vols fer («exporta les sessions a CSV») o llista un conjunt d'eines. Cada coincidència indica què fa l'eina, quins paràmetres té i si llegeix, escriu o és destructiva.
* `didit_tool_describe` (lectura): retorna la descripció completa i l'esquema d'entrada de fins a cinc eines.
* `didit_tool_call_read` (lectura): executa una eina de només lectura que no és a la llista. Rebutja una eina que canvia dades.
* `didit_tool_call_write` (destructiva): executa una eina que crea, canvia o elimina dades i que no és a la llista. No s'ofereix en una connexió de només lectura.

Una crida a través de `didit_tool_call_read` o `didit_tool_call_write` es comprova exactament igual que una crida directa: els permisos del teu rol, el mode de només lectura i tots els requisits `confirm: true` continuen aplicant-se.
Són dues eines separades perquè el client pugui demanar-te confirmació abans d'un canvi i deixar passar una consulta.

Amb `core` carregat, una sol·licitud com «convida un nou membre de l'equip a la meva organització» segueix aquest recorregut:

1. El model crida `didit_tool_search` amb `invite a teammate` i obté `didit_org_invite_member`, marcada com una operació d'escriptura.
2. Crida `didit_tool_call_write`, passant `didit_org_invite_member` com a `name` juntament amb els arguments propis d'aquella eina.
3. El client et demana que aprovis la crida, com ho fa amb qualsevol eina que canvia dades.

Quan tot està carregat no queda res per descobrir, així que aquestes quatre eines no apareixen a la llista.

## Configura-ho al teu client

Segueix els mateixos passos que la [guia d'instal·lació](https://docs.didit.me/ca/integration/mcp/installation.md), però amb els paràmetres afegits a la URL.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> Mantén les cometes: si no, el teu intèrpret d'ordres interpretaria el `?` i el `&` per si mateix.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"
> ```

> [tab] Cursor
>
> A `~/.cursor/mcp.json`:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> A `.vscode/mcp.json`:
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] Claude web i Desktop
>
> Obre **Settings**, després **Connectors** i després **Add custom connector**, i enganxa la URL amb els seus paràmetres:
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] Servidor local
>
> El servidor local accepta opcions o variables d'entorn:
>
> ```bash theme={null}
> npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only
> ```
>
> ```bash theme={null}
> DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server
> ```

Si el teu client et permet definir capçaleres però no editar la URL, envia `X-MCP-Toolsets: core,workflows` i `X-MCP-Readonly: true` en lloc d'això.
Un valor a la URL preval sobre la capçalera pel que fa als conjunts d'eines, i el mode de només lectura s'activa quan qualsevol dels dos ho demana.

> [!NOTE]
>
> El connector de ChatGPT fa servir un catàleg propi, fix i reduït, a `https://mcp.didit.me/mcp/chatgpt`.
> Els conjunts d'eines i el mode de només lectura no s'hi apliquen.
> Consulta [Connecta ChatGPT](https://docs.didit.me/ca/integration/mcp/chatgpt.md).

## Prompts, instruccions i cerca a la documentació

El servidor ajuda el model a començar pel lloc correcte:

* **Instruccions.** En connectar-se, el servidor indica al model que comenci amb `didit_context_get`, com es resolen `organization_id` i `application_id`, que desenvolupi en una aplicació de sandbox i quins conjunts d'eines ha carregat aquesta connexió.
* **Prompts.** Els clients que admeten prompts de MCP mostren cinc punts de partida: `integrate_didit`, `review_queue`, `explain_session`, `build_workflow` i `verification_report`. A Claude Code apareixen com a ordres amb barra inclinada.
* **Cerca a la documentació.** `didit_docs_search` cerca en aquesta documentació i retorna les seccions coincidents amb els seus enllaços, de manera que les preguntes sobre el funcionament de Didit es responen a partir de les pàgines actuals.

## Comprovar què ha carregat una connexió

Pregunta al teu client:

```text theme={null}
Which Didit toolsets does this connection load, and is it read-only?
```

El model respon a partir de les instruccions del servidor.
Per comprovar que un servidor admet conjunts d'eines abans de confiar-hi, llegeix el seu endpoint d'estat:

```bash theme={null}
curl https://mcp.didit.me/healthz
```

La resposta enumera `toolsets` i `read_only` dins de `features`.

## Passos següents

> [card] [Instal·lació](https://docs.didit.me/ca/integration/mcp/installation.md)
>
> Connecta Claude, ChatGPT, Cursor, VS Code, Codex o qualsevol client MCP.

> [card] [Referència d'eines](https://docs.didit.me/ca/integration/mcp/tools.md)
>
> Totes les eines, el seu tipus i el permís de rol que necessiten.

> [card] [Autenticació](https://docs.didit.me/ca/integration/mcp/authentication.md)
>
> Inicia sessió amb Didit, els àmbits i els permisos de rol.

> [card] [Exemples d'indicacions](https://docs.didit.me/ca/integration/mcp/examples.md)
>
> Indicacions que funcionen des del primer dia.


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