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

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

Principais conclusões

• O servidor Didit MCP expõe mais de 130 ferramentas em 11 categorias — Sessões KYC e KYB (Know Your Business), verificação independente, fluxos de trabalho, monitorização de transações, análise AML, análise de carteiras, listas, casos, relatórios, webhooks e faturação.
• O servidor alojado está localizado em https://mcp.didit.me/mcp através de Streamable HTTP — recomendado em vez de auto-hospedagem para a maioria das equipas.
• A autenticação é OAuth 2.1 + PKCE (“Iniciar sessão com a Didit”). Não existe chave de API para colar; faz login através de business.didit.me e o acesso é limitado ao seu papel na consola.
• A instalação no Claude Code é feita com um comando; a instalação no Claude Desktop e no Claude web é feita através de Definições → Conectores → Adicionar conector personalizado.
• As 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 regista 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

Isto regista um servidor chamado didit usando o transporte Streamable HTTP apontado para o ponto final alojado. Repare que não há token ou segredo no comando — a autenticação ocorre interativamente.

Passo 2 — Iniciar sessão com OAuth

Dentro do Claude Code, execute:

/mcp

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

Passo 3 — Confirmar o carregamento das ferramentas

Execute /mcp novamente e abra o servidor didit. Deverá ver o catálogo de ferramentas preenchido nas 11 categorias. Se as ferramentas estiverem listadas, está pronto.

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

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

Passo 1 — Abrir as configurações de Conectores

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

Passo 2 — Introduzir 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 “Iniciar sessão com a Didit”. Aproxime o acesso com a sua conta Didit. Quando a aba fechar, o conector Didit aparece na sua lista de conectores como conectado. Tal como no Claude Code, não existe chave de API — o fluxo OAuth é a única credencial e permanece limitado ao seu utilizador.

Passo 4 — Ativar o conector numa conversa

Inicie uma nova conversa, abra o menu de ferramentas ou conectores e certifique-se de que Didit está ativado para que o Claude seja autorizado a chamar as suas ferramentas.

Verificar se funciona

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

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

O Claude chamará a ferramenta Didit apropriada através do servidor MCP e devolverá as suas organizações e respetivas aplicações. Se vir os seus dados de espaço de trabalho reais a serem devolvidos, a ligação está ativa e autenticada corretamente. A partir daí, pode avançar para pedidos de maior intenção como:

Crie uma sessão de verificação KYC para um novo utilizador e forneça-me o link de verificação.

Analise este endereço de carteira em busca de riscos e resuma as conclusões.

O Claude seleciona a ferramenta correta do catálogo, executa-a na Didit e relata o resultado em linha.

Resolução de problemas

• O servidor didit aparece como “precisa de autenticação” ou desconectado. Volte a executar /mcp no Claude Code (ou reabra as configurações de Conectores no Desktop) e complete o login no 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 predefinido está definido e que os pop-ups são permitidos para o passo de login. No Claude Code, pode copiar a URL de autorização impressa para um navegador manualmente.
• “Adicionar conector personalizado” está em falta 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 web, confirme se o seu plano permite conectores.
• As ferramentas não aparecem após a ligação. Desative e ative o conector Didit no menu de ferramentas da conversa e, em seguida, inicie uma nova conversa para que o Claude recarregue o catálogo.

Referências e próximos passos

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

A Didit é infraestrutura para identidade e fraude, confiável por mais de 1.500 empresas, apoiada por 7,5 milhões de dólares, uma empresa Y Combinator W26, lucrativa e ativa em mais de 220 países. As execuções KYC completas custam 0,33 dólares, a análise de carteiras 0,15 dólares e a análise AML 0,20 dólares — com 500 verificações gratuitas por mês e sem cartão necessário.

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