Pular para o conteúdo principal
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:
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. 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 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:
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 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.

​
Conectar em modo somente leitura

Adicione read_only=true à URL do servidor:
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, com os parâmetros adicionados à URL.
Mantenha as aspas: caso contrário, o shell interpretaria o ? e o & por conta própria.
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.
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.

​
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:
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:
A resposta lista toolsets e read_only em features.

​
Próximos passos

Instalação

Conecte o Claude, o ChatGPT, o Cursor, o VS Code, o Codex ou qualquer cliente MCP.

Referência de ferramentas

Cada ferramenta, seu tipo e a permissão de função que ela exige.

Autenticação

Faça login com a Didit, escopos e permissões de função.

Prompts de exemplo

Prompts que funcionam desde o primeiro dia.
Última modificação em 12 de novembro de 2026