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

# Toolsets e modo somente leitura do MCP Didit

> Carregue só as ferramentas MCP da Didit que você precisa com toolsets, conecte em modo somente leitura e acesse as demais via busca de ferramentas.

Toolsets (conjuntos de ferramentas) permitem que uma conexão MCP da Didit carregue uma lista curta de ferramentas em vez de todo o catálogo, e o modo somente leitura oferece uma conexão que nunca pode alterar dados.
Ambos são definidos por um parâmetro na URL do servidor:

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

Sem o parâmetro, o servidor lista todas as ferramentas que sua função pode usar, então nada muda para uma conexão que você já tem.

## Por que carregar menos ferramentas

Seu cliente envia a definição de cada ferramenta listada ao modelo antes da sua primeira pergunta.
Para todo o catálogo da Didit, isso representa dezenas de milhares de tokens em cada requisição: aproximadamente de 50.000 a 115.000, dependendo do tokenizador do modelo.
Alguns clientes também limitam quantas ferramentas aceitam.

| O que a conexão carrega | Ferramentas listadas | Parcela desses tokens |
| - | - | - |
| Tudo (sem parâmetro) | Todas as ferramentas que sua função pode usar | Todas elas |
| A lista curta, `core` | Cerca de 30 | Cerca de um décimo |
| A lista curta, somente leitura | Cerca de 20 | Menos de um décimo |

A contrapartida é um passo a mais.
Uma ferramenta fora da lista não se perde, mas o modelo precisa encontrá-la com a [pesquisa de ferramentas](#acesse-as-ferramentas-que-você-não-carregou) antes de conseguir executá-la, e um modelo que vê todas as ferramentas escolhe a correta um pouco mais vezes do que um modelo que precisa pesquisar.
Carregue tudo quando uma conversa abrange muitas áreas e o custo de contexto não importa.
Carregue `core`, mais os conjuntos de ferramentas que você mais usa, quando ele importar.

## Escolha seus conjuntos de ferramentas

Adicione `toolsets` à URL do servidor com uma lista separada por vírgulas:

```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` é a lista curta com a qual a maior parte do trabalho começa.
Ela cobre suas organizações e aplicações, sessões de verificação (criar, buscar, decidir, explicar, simular no sandbox e ler entregas de webhook), busca de fluxos de verificação, análises e saldo, a chave de API e os webhooks da sua aplicação, busca de casos, usuários, empresas e transações, e a busca na documentação.

* `core`: a lista curta acima.
* `account`: organizações, aplicações, chaves de API, membros e funções.
* `billing`: plano, saldo de crédito, métodos de pagamento, recibos e dados de faturamento.
* `sessions`: sessões de verificação (criar, buscar, decidir, revisar, compartilhar, importar, PDFs e entregas de webhook).
* `workflows`: fluxos de verificação (workflow) e questionários (criar, editar, validar e publicar).
* `lists`: listas personalizadas, a lista de bloqueio e a lista de permissões.
* `vendors`: as pessoas e empresas que você verifica (usuários do vendor e empresas fornecedoras).
* `transactions`: monitoramento de transações (transações, triagem de carteiras e regras com testes retrospectivos).
* `cases`: gestão de casos (criar, atribuir, escalar e resolver casos).
* `investigator`: o Investigator (sua fila de revisão, relatórios, decisões, perguntas sobre políticas e desempenho).
* `webhooks`: destinos de webhook e alertas.
* `reports`: análises, exportações e o registro de auditoria.
* `branding`: personalização de marca própria do fluxo de verificação.
* `verification`: APIs de verificação independentes (documento de identidade, facial, AML, comprovante de endereço, telefone, e-mail, verificações de banco de dados e de empresas).
* `travel_rule`: Travel Rule (configurações, o diretório de VASPs, redes, endereços, transferências e mensagens).
* `marketplace`: o mercado de provedores (o catálogo, suas conexões e solicitações de integração).
* `networks`: redes de fraude (sessões, usuários e empresas vinculados que compartilham um dispositivo, documento ou contato).
* `compliance`: o assistente de conformidade (seu perfil regulatório, seus requisitos e os fluxos gerados a partir deles).
* `docs`: busca na documentação da Didit.
* `all`: todas as ferramentas que sua função pode usar. Este é o padrão.

A [referência de ferramentas](https://docs.didit.me/pt-br/integration/mcp/tools.md) lista cada ferramenta com seu tipo e a permissão de função que ela exige.

Como a seleção funciona:

* **Os conjuntos de ferramentas exigem adesão explícita.** Uma URL sem `toolsets` lista tudo.
* **Nomear conjuntos de ferramentas lista exatamente esses.** `?toolsets=cases` lista as ferramentas de casos, além de `didit_context_get`, que toda conexão recebe. Adicione `core` para manter também a lista curta.
* **Um conjunto de ferramentas define o que é listado, não o que você pode executar.** Uma ferramenta fora da sua seleção ainda é executada quando o modelo a chama pelo nome, com as mesmas permissões de função de sempre.
* **Um nome que o servidor não conhece é ignorado.** A conexão continua funcionando, e o servidor informa ao modelo qual nome foi ignorado e quais são os válidos.
* **Sua função continua valendo.** Um conjunto de ferramentas nunca concede permissão: veja [funções e permissões](https://docs.didit.me/pt-br/integration/mcp/authentication.md#funções-e-permissões).

## Conectar em modo somente leitura

Adicione `read_only=true` à URL do servidor:

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

Uma conexão somente leitura lista apenas as ferramentas que leem dados, e o servidor recusa toda chamada que criaria, alteraria ou excluiria algo.
A recusa acontece no servidor, em todas as chamadas, então ela vale mesmo que seu cliente se lembre de uma ferramenta de uma conexão anterior.
Use esse modo para gerar relatórios, para explorar uma conta ou para um agente que você não quer que aja por conta própria.

Para permitir alterações novamente, conecte sem `read_only`.

## Acesse as ferramentas que você não carregou

Quando uma conexão lista apenas parte do catálogo, o servidor adiciona quatro ferramentas para que nada fique fora de alcance:

* `didit_tool_search` (leitura): encontra ferramentas pelo que você quer fazer ("exportar sessões para CSV") ou lista um conjunto de ferramentas. Cada resultado informa o que a ferramenta faz, seus parâmetros e se ela lê, grava ou é destrutiva.
* `didit_tool_describe` (leitura): retorna a descrição completa e o esquema de entrada de até cinco ferramentas.
* `didit_tool_call_read` (leitura): executa uma ferramenta somente leitura que não está na lista. Recusa uma ferramenta que altera dados.
* `didit_tool_call_write` (destrutiva): executa uma ferramenta que cria, altera ou exclui dados e não está na lista. Não é oferecida em uma conexão somente leitura.

Uma chamada feita por meio de `didit_tool_call_read` ou `didit_tool_call_write` é verificada exatamente como uma chamada direta: as permissões da sua função, o modo somente leitura e todos os requisitos de `confirm: true` continuam valendo.
As duas são separadas para que o seu cliente possa pedir sua aprovação antes de uma alteração e liberar uma consulta.

Com `core` carregado, um pedido como "convidar um novo membro para minha organização" acontece assim:

1. O modelo chama `didit_tool_search` com `invite a teammate` e recebe `didit_org_invite_member`, marcado como uma operação de gravação.
2. Ele chama `didit_tool_call_write`, passando `didit_org_invite_member` como `name` junto com os argumentos próprios dessa ferramenta.
3. O seu cliente pede que você aprove a chamada, como faz com qualquer ferramenta que altere dados.

Quando tudo está carregado, não há nada a descobrir, então essas quatro ferramentas não aparecem na lista.

## Configure no seu cliente

Use os mesmos passos do [guia de instalação](https://docs.didit.me/pt-br/integration/mcp/installation.md), com os parâmetros adicionados à URL.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> Mantenha as aspas: caso contrário, o shell interpretaria o `?` e o `&` por conta própria.

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

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

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

> [tab] Claude web e Desktop
>
> Abra **Settings**, depois **Connectors**, depois **Add custom connector**, e cole a URL com os parâmetros:
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] Servidor local
>
> O servidor local aceita opções ou variáveis de ambiente:
>
> ```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
> ```

Se o seu cliente permitir definir cabeçalhos, mas não editar a URL, envie `X-MCP-Toolsets: core,workflows` e `X-MCP-Readonly: true`.
Um valor na URL tem prioridade sobre o cabeçalho para os conjuntos de ferramentas, e o modo somente leitura fica ativado se qualquer um dos dois o solicitar.

> [!NOTE]
>
> O plugin do ChatGPT usa seu próprio catálogo fixo e reduzido, em `https://mcp.didit.me/mcp/chatgpt`.
> Conjuntos de ferramentas e modo somente leitura não se aplicam a ele.
> Veja [Conectar o ChatGPT](https://docs.didit.me/pt-br/integration/mcp/chatgpt.md).

## Prompts, instruções e busca na documentação

O servidor ajuda o modelo a começar pelo lugar certo:

* **Instruções.** Ao conectar, o servidor orienta o modelo a começar com `didit_context_get`, explica como `organization_id` e `application_id` são resolvidos, a desenvolver em uma aplicação sandbox e informa quais conjuntos de ferramentas essa conexão carregou.
* **Prompts.** Clientes que oferecem suporte a prompts do MCP exibem cinco pontos de partida: `integrate_didit`, `review_queue`, `explain_session`, `build_workflow` e `verification_report`. No Claude Code, eles aparecem como comandos de barra.
* **Busca na documentação.** `didit_docs_search` pesquisa esta documentação e retorna as seções correspondentes com seus links, para que as dúvidas sobre o funcionamento do Didit sejam respondidas com base nas páginas atuais.

## Verificar o que uma conexão carregou

Pergunte ao seu cliente:

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

O modelo responde com base nas instruções do servidor.
Para verificar se um servidor oferece suporte a toolsets antes de depender deles, leia o endpoint de status:

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

A resposta lista `toolsets` e `read_only` em `features`.

## Próximos passos

> [card] [Instalação](https://docs.didit.me/pt-br/integration/mcp/installation.md)
>
> Conecte o Claude, o ChatGPT, o Cursor, o VS Code, o Codex ou qualquer cliente MCP.

> [card] [Referência de ferramentas](https://docs.didit.me/pt-br/integration/mcp/tools.md)
>
> Cada ferramenta, seu tipo e a permissão de função que ela exige.

> [card] [Autenticação](https://docs.didit.me/pt-br/integration/mcp/authentication.md)
>
> Faça login com a Didit, escopos e permissões de função.

> [card] [Prompts de exemplo](https://docs.didit.me/pt-br/integration/mcp/examples.md)
>
> Prompts que funcionam desde o primeiro dia.


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