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

# Conecte o Cursor ao servidor MCP da Didit

> Adicione o servidor MCP da Didit ao Cursor com um link de instalação em um clique ou um mcp.json de três linhas. Entre com sua conta Didit. Sem chave de API.

O Cursor se conecta ao servidor MCP hospedado da Didit (`https://mcp.didit.me/mcp`) com um link de instalação ou três linhas de `mcp.json`. No primeiro uso, o Cursor abre **Log in with Didit** no seu navegador; não há chave de API para copiar.

> [card] [Adicionar a Didit ao Cursor](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D)
>
> Abre a página de instalação do Cursor, que inicia o Cursor e adiciona o servidor `didit` com a URL mcp.didit.me/mcp. Confirme a instalação e, em seguida, faça login na Didit.

O link de instalação, caso você queira colocá-lo por trás do seu próprio botão ou em um README:

```text theme={null}
https://cursor.com/install-mcp?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D
```

Ele encapsula o deeplink do Cursor, que você também pode usar diretamente:

```text theme={null}
cursor://anysphere.cursor-deeplink/mcp/install?name=didit&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ==
```

O valor de `config` é o base64 de `{"url":"https://mcp.didit.me/mcp"}`.

***

## Configurar por método

> [tab] Link de instalação
>
> 1. Clique em [**Adicionar Didit ao Cursor →**](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D). Seu navegador pede para abrir o Cursor; permita.
> 2. O Cursor mostra o servidor `didit` com a URL `https://mcp.didit.me/mcp`. Confirme a instalação.
> 3. Quando o Cursor indicar `didit` como pendente de login, clique para conectar e conclua **Log in with Didit** no navegador.
>
> Se o Cursor não abrir, a página de instalação exibe a configuração para você colar manualmente no `mcp.json`.

> [tab] mcp.json
>
> Adicione o Didit em `~/.cursor/mcp.json` (todos os projetos) ou em `.cursor/mcp.json` (um projeto):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> Mantenha os servidores que você já tem dentro de `mcpServers`. No primeiro uso, o Cursor se registra automaticamente no Didit e abre o navegador para **Log in with Didit**.

> [tab] Linha de comando
>
> O comando `cursor` pode adicionar o servidor ao seu perfil de usuário:
>
> ```bash theme={null}
> cursor --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> Ele exibe `Added MCP servers: didit`. Abra o Cursor e faça login quando solicitado.

> [!NOTE]
>
> **Nenhuma chave de API na configuração.** O servidor usa OAuth 2.1 com PKCE e age em seu nome: somente nas organizações que você aprovar no login, com as permissões da sua função. Veja [Autenticação](https://docs.didit.me/pt-br/integration/mcp/authentication.md).

***

## Verifique se funciona

No chat do agente no Cursor, peça:

```text theme={null}
Use the Didit MCP server to call didit_context_get and list my organizations and applications.
```

O agente chama `didit_context_get` e lista suas organizações com as respectivas aplicações. Depois, coloque-o para trabalhar no seu código:

* "Crie um fluxo de verificação (workflow) de KYC em sandbox com verificação de identidade e prova de vida, e depois adicione o SDK web da Didit a este app usando esse fluxo."
* "Registre um destino de webhook para atualizações de status da sessão apontando para a rota `/api/didit/webhook` do meu projeto, e escreva o manipulador que verifica a assinatura."
* "Crie uma sessão de teste para `user_123` e me envie o link de verificação."

***

## Solução de problemas

* **O Cursor não abriu pelo link.** Cole o JSON da aba **mcp.json**.
* **O login fica em loop ou falha.** Faça login em [business.didit.me](https://business.didit.me) no seu navegador padrão primeiro e depois conecte-se de novo.
* **Uma ferramenta responde com `missing_scope`.** Sua função nessa organização não tem a permissão necessária. Veja [funções e permissões](https://docs.didit.me/pt-br/integration/mcp/authentication.md#funções-e-permissões).
* **O agente informa que não tem ferramentas do Didit.** Verifique se o servidor `didit` está ativado nas configurações de MCP do Cursor e se o login foi concluído. Veja [Solução de problemas](https://docs.didit.me/pt-br/integration/mcp/advanced.md#solução-de-problemas).

***

## Próximos passos

> [card] [Conectar ao VS Code](https://docs.didit.me/pt-br/integration/mcp/vscode.md)
>
> Link de instalação e mcp.json para o GitHub Copilot no VS Code.

> [card] [Conectar ao OpenAI Codex](https://docs.didit.me/pt-br/integration/mcp/codex.md)
>
> Um único comando para o Codex CLI e a extensão de IDE.

> [card] [Referência de ferramentas](https://docs.didit.me/pt-br/integration/mcp/tools.md)
>
> Tudo o que o agente pode chamar, ferramenta por ferramenta.

> [card] [Integração com um único prompt](https://docs.didit.me/pt-br/integration/mcp/examples.md)
>
> Exemplos práticos de um agente criando uma integração com a Didit.


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