Como Integrar o Servidor Didit MCP no Claude (Desktop e Código) (PT-BR)

O servidor Didit MCP (Model Context Protocol) permite que o Claude execute verificações de identidade e fraude para você — criando sessões KYC (Know Your Customer), examinando carteiras, consultando listas AML (Anti-Money Laundering) e lendo resultados de verificação — sem que você precise escrever uma única linha de código. Este guia mostra como conectá-lo ao Claude Desktop (e ao Claude na web) usando um conector personalizado, e ao Claude Code usando um comando de terminal. Toda a configuração leva cerca de cinco minutos, usa o OAuth (Open Authorization) “Fazer login com o Didit” e não requer chave de API em sua configuração.

Principais vantagens

• O servidor Didit MCP expõe mais de 130 ferramentas em 11 categorias — sessões KYC e KYB (Know Your Business), verificação autônoma, fluxos de trabalho, monitoramento de transações, triagem AML, triagem de carteiras, listas, casos, relatórios, webhooks e faturamento.
• O servidor hospedado está localizado em https://mcp.didit.me/mcp via Streamable HTTP — recomendado em vez de auto-hospedagem para a maioria das equipes.
• A autenticação é OAuth 2.1 + PKCE (“Fazer login com o Didit”). Não há chave de API para colar; você faz login através do business.didit.me e o acesso é limitado ao seu papel no console.
• O Claude Code instala com um comando; o Claude Desktop e o Claude na web instalam através de Configurações → Conectores → Adicionar conector personalizado.
• Novas contas recebem 500 verificações gratuitas por mês sem cartão, e a camada MCP em si é gratuita.

Opção A: Instalar no Claude Code

O Claude Code é o caminho mais rápido porque registra o servidor a partir do seu terminal.

Passo 1 — Adicionar o servidor Didit

Execute este comando em qualquer diretório de projeto:

claude mcp add --transport http didit https://mcp.didit.me/mcp

Isso registra um servidor chamado didit usando o transporte Streamable HTTP apontado para o endpoint hospedado. Observe que não há token ou segredo no comando — a autenticação ocorre interativamente.

Passo 2 — Fazer login com OAuth

Dentro do Claude Code, execute:

/mcp

Selecione didit e, em seguida, escolha autenticar. O Claude Code abre seu navegador para business.didit.me, onde você aprova o acesso com seu login Didit existente. Assim que você confirmar, o navegador retorna a sessão e o servidor didit aparece como conectado. Como isso usa OAuth 2.1 com PKCE, as ferramentas que você pode chamar respeitam seu papel no console — nenhuma chave de longa duração é armazenada no disco.

Passo 3 — Confirmar o carregamento das ferramentas

Execute /mcp novamente e abra o servidor didit. Você deverá ver o catálogo de ferramentas preenchido nas 11 categorias. Se as ferramentas estiverem listadas, você estará pronto.

Opção B: Instalar no Claude Desktop (e Claude na web)

O Claude Desktop e o Claude na web suportam conectores personalizados, que é como você adiciona o servidor Didit MCP lá.

Passo 1 — Abrir as configurações de Conectores

No Claude Desktop ou Claude na web, vá para Configurações → Conectores → Adicionar conector personalizado.

Passo 2 — Preencher os detalhes do conector Didit

Preencha os dois campos:

• Nome: Didit
• URL: https://mcp.didit.me/mcp

Em seguida, clique em Conectar.

Passo 3 — Autorizar no navegador

O Claude abre uma aba do navegador para “Fazer login com o Didit”. Aprove o acesso com sua conta Didit. Quando a aba fechar, o conector Didit aparecerá na sua lista de conectores como conectado. Assim como no Claude Code, não há chave de API — o fluxo OAuth é a única credencial e permanece limitado ao seu usuário.

Passo 4 — Habilitar o conector em um chat

Comece uma nova conversa, abra o menu de ferramentas ou conectores e certifique-se de que o Didit esteja ativado para que o Claude possa chamar suas ferramentas.

Verificar se funciona

A verificação mais rápida é um prompt somente leitura que toca sua conta. Em qualquer conversa do Claude com o conector ativado, pergunte:

Liste minhas organizações e aplicações.

O Claude chamará a ferramenta Didit apropriada através do servidor MCP e retornará suas organizações e suas aplicações. Se você vir seus dados reais do espaço de trabalho retornarem, a conexão estará ativa e autenticada corretamente. A partir daí, você pode prosseguir para prompts de maior intenção, como:

Criar uma sessão de verificação KYC para um novo usuário e me fornecer o link de verificação.

Examinar este endereço de carteira em busca de riscos e resumir os resultados.

O Claude escolhe a ferramenta certa do catálogo, executa-a no Didit e relata o resultado em linha.

Solução de problemas

• O servidor didit aparece como “precisa de autenticação” ou desconectado. Execute /mcp novamente no Claude Code (ou reabra as configurações de Conectores no Desktop) e complete o login do navegador novamente. As sessões OAuth podem expirar; a reautenticação restaura o acesso.
• Nenhuma janela do navegador foi aberta durante o login. Certifique-se de que um navegador padrão esteja definido e que os pop-ups sejam permitidos para a etapa de login. No Claude Code, você pode copiar a URL de autorização impressa para um navegador manualmente.
• “Adicionar conector personalizado” está faltando no Claude Desktop. Atualize para a versão mais recente do Claude Desktop — o suporte a conectores personalizados é lançado nas versões atuais. No Claude na web, confirme se seu plano permite conectores.
• As ferramentas não aparecem após a conexão. Desative e ative o conector Didit no menu de ferramentas da conversa e, em seguida, inicie um novo chat para que o Claude recarregue o catálogo.

Referência e próximos passos

• Leia a visão geral do Didit MCP e o guia de instalação para obter a referência completa da ferramenta.
• Veja a página de desenvolvedor em didit.me/developers/mcp.
• Navegue ou auto-hospede o servidor de código aberto (licenciado MIT) em github.com/didit-protocol/mcp.

Didit é infraestrutura para identidade e fraude, confiável por mais de 1.500 empresas, apoiado por US$ 7,5 milhões, uma empresa Y Combinator W26, lucrativa e ativa em mais de 220 países. KYC completo custa US$ 0,33, triagem de carteira US$ 0,15 e triagem AML US$ 0,20 — com 500 verificações gratuitas todos os meses e sem necessidade de cartão.

Comece gratuitamente em business.didit.me e faça sua primeira verificação orientada pelo Claude em minutos.