Como Conectar o Servidor Didit MCP ao Cursor e ao VS Code (PT-BR)

Se você desenvolve em Cursor ou VS Code, pode integrar o servidor Didit MCP (Model Context Protocol) diretamente ao assistente de IA do seu editor. Uma vez conectado, seu assistente pode criar sessões de KYC (Conheça seu Cliente), realizar verificações de KYB (Conheça seu Negócio), analisar carteiras, consultar listas de AML (Anti-Lavagem de Dinheiro) e ler resultados de verificação — tudo na mesma janela onde você escreve código. Este guia fornece a configuração JSON exata para ambos os editores, o fluxo de login OAuth (Autorização Aberta) e como verificar as ferramentas carregadas. Não é necessária chave de API no arquivo de configuração; a autenticação ocorre através do botão "Entrar com o Didit".

Principais vantagens

• O servidor Didit MCP oferece mais de 130 ferramentas em 11 categorias — sessões de KYC e KYB, verificação autônoma, fluxos de trabalho, monitoramento de transações, rastreamento AML, análise de carteiras, listas, casos, relatórios, webhooks e faturamento.
• O endpoint hospedado é https://mcp.didit.me/mcp via Streamable HTTP — recomendado em vez de auto-hospedagem para a maioria das equipes.
• Ambos os editores se conectam através de um pequeno arquivo JSON: ~/.cursor/mcp.json para Cursor e .vscode/mcp.json para VS Code.
• A autenticação é OAuth 2.1 + PKCE ("Entrar com o Didit") através do business.didit.me — sem chave de API na configuração, e o acesso é restrito à sua função no console.
• Novas contas recebem 500 verificações gratuitas por mês sem cartão; a camada MCP é gratuita.

Passo 1 — Conecte o servidor Didit MCP ao Cursor

O Cursor lê os servidores MCP de ~/.cursor/mcp.json no seu diretório pessoal (você também pode usar um arquivo .cursor/mcp.json por projeto).

Crie ou edite o arquivo e adicione o servidor didit:

{
  "mcpServers": {
    "didit": {
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Salve o arquivo. Observe que não há token ou segredo — apenas a URL hospedada. Se você já tiver outros servidores MCP definidos, adicione a entrada didit junto com eles dentro de mcpServers.

Agora, abra Configurações do Cursor → MCP (ou Ferramentas/Integrações, dependendo da sua versão). O servidor didit aparecerá na lista. O Cursor solicitará a autenticação; aprove-a e conclua o fluxo de "Entrar com o Didit" no seu navegador em business.didit.me. Como isso usa OAuth 2.1 com PKCE, nenhuma credencial de longa duração é gravada no disco e as ferramentas que você pode chamar respeitam sua função no console.

Passo 2 — Conecte o servidor Didit MCP ao VS Code

O VS Code lê os servidores MCP do workspace de .vscode/mcp.json na raiz do seu projeto. Crie esse arquivo e adicione:

{
  "servers": {
    "didit": {
      "type": "http",
      "url": "https://mcp.didit.me/mcp"
    }
  }
}

Observe as diferenças em relação ao Cursor: o VS Code usa a chave servers (não mcpServers) e exige um "type": "http" explícito para o transporte Streamable HTTP. Salve o arquivo.

O VS Code detecta o novo servidor e oferece para Iniciar. Inicie o servidor didit; o VS Code o guiará pelo fluxo OAuth "Entrar com o Didit" no seu navegador. Depois de aprovar o acesso em business.didit.me, o servidor estará conectado e suas ferramentas estarão disponíveis para o Copilot Chat no modo agente.

Passo 3 — Uma observação sobre Windsurf e Zed

Se você usa Windsurf ou Zed, esses clientes se conectam através de um pequeno comando de bridge em vez de uma URL simples. Na configuração de MCP do cliente, execute o endpoint Didit através do mcp-remote:

npx -y mcp-remote@latest https://mcp.didit.me/mcp

Adicione esse comando à configuração do servidor MCP do cliente; o fluxo de login OAuth funciona da mesma forma.

Verifique as ferramentas carregadas

Após a autenticação, confirme se o catálogo está presente.

• No Cursor: abra Configurações → MCP e expanda o servidor didit. Você deverá ver suas ferramentas listadas nas 11 categorias.
• No VS Code: abra a visualização de servidores MCP (ou execute o comando "MCP: List Servers") e confirme se didit aparece como em execução com suas ferramentas disponíveis no modo agente.

Em seguida, execute um prompt somente leitura no seu assistente para confirmar a autenticação de ponta a ponta:

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

Seu assistente chama a ferramenta Didit através do servidor MCP e retorna suas organizações e suas aplicações. Se os dados reais do seu workspace forem retornados, você estará conectado. A partir daí, tente prompts de maior intenção:

Crie uma sessão de verificação KYC e me forneça o link de verificação.

Analise este endereço de carteira em busca de riscos e resuma o resultado.

O assistente do seu editor seleciona a ferramenta certa, chama o Didit e retorna — ao lado do seu código.

Solução de problemas

• O servidor não aparece após a edição do JSON. Verifique se há um erro de sintaxe JSON (uma vírgula final perdida é a causa comum), confirme se o caminho do arquivo e a chave estão corretos — mcpServers para Cursor, servers para VS Code — e recarregue o editor.
• O VS Code diz que o servidor não iniciará. Certifique-se de ter incluído "type": "http"; o VS Code precisa disso para usar o transporte Streamable HTTP.
• O login OAuth nunca é concluído. Permita pop-ups do navegador para que a janela "Entrar com o Didit" possa abrir e finalize a aprovação em business.didit.me. Reinicie a autenticação nas configurações do MCP se a sessão expirou.
• Chamadas de ferramentas retornam um erro de permissão. O acesso ao MCP espelha sua função no console Didit. Faça login com uma conta que tenha as permissões necessárias.

Referência e próximos passos

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

Didit é infraestrutura para identidade e prevenção de fraudes, confiável por mais de 1.500 empresas, com um investimento de $7,5 milhões, uma empresa Y Combinator W26, lucrativa e presente em mais de 220 países. KYC completo custa $0,33, análise de carteira $0,15 e rastreamento AML $0,20 — com 500 verificações gratuitas por mês e sem necessidade de cartão.

Comece gratuitamente em business.didit.me e coloque ferramentas de identidade e prevenção de fraudes dentro do seu editor hoje mesmo.