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

# Servidor MCP da Didit no Cursor

> Adicione o servidor MCP da Didit ao Cursor com um clique ou um mcp.json de três linhas e inicie sessão. Sem chave de API, no agente do Cursor.

Cursor liga-se ao servidor MCP alojado do Didit (`https://mcp.didit.me/mcp`) através de uma única ligação de instalação ou de três linhas de `mcp.json`. Na primeira utilização, o Cursor abre **Log in with Didit** no seu navegador; não há nenhuma chave de API para copiar.

> [card] [Adicionar o 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 o URL mcp.didit.me/mcp. Confirme a instalação e, em seguida, inicie sessão no Didit.

A ligação de instalação, caso queira colocá-la atrás do seu próprio botão ou num README:

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

Esta ligação envolve a ligação profunda do Cursor, que também pode utilizar 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] Ligação de instalação
>
> 1. Clique em [**Adicionar o Didit ao Cursor →**](https://cursor.com/install-mcp?name=didit\&config=eyJ1cmwiOiJodHRwczovL21jcC5kaWRpdC5tZS9tY3AifQ%3D%3D). O navegador pede para abrir o Cursor; permita.
> 2. O Cursor mostra o servidor `didit` com o URL `https://mcp.didit.me/mcp`. Confirme a instalação.
> 3. Quando o Cursor indicar que o servidor `didit` requer início de sessão, clique para estabelecer ligação e conclua **Log in with Didit** no navegador.
>
> Se o Cursor não abrir, a página de instalação mostra a configuração para copiar manualmente para `mcp.json`.

> [tab] mcp.json
>
> Adicione o Didit a `~/.cursor/mcp.json` (todos os projetos) ou a `.cursor/mcp.json` (um só projeto):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> Mantenha os servidores que já tiver dentro de `mcpServers`. Na primeira utilização, o Cursor regista-se automaticamente no Didit e abre o navegador para **Log in with Didit**.

> [tab] Linha de comandos
>
> O comando `cursor` pode adicionar o servidor ao seu perfil de utilizador:
>
> ```bash theme={null}
> cursor --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> Mostra `Added MCP servers: didit`. Abra o Cursor e inicie sessão quando for pedido.

> [!NOTE]
>
> **Sem chave de API na configuração.** O servidor usa OAuth 2.1 com PKCE e atua em seu nome: **apenas** nas organizações que aprovar no início de sessão, com as permissões da sua função. Veja [Autenticação](https://docs.didit.me/pt/integration/mcp/authentication.md).

***

## Verificar se está a funcionar

No chat do agente do Cursor, pergunte:

```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 as suas organizações com as respetivas aplicações. Em seguida, ponha-o a trabalhar na sua base de código:

* "Crie um fluxo KYC em sandbox com verificação de identidade e prova de vida e, depois, adicione o SDK web da Didit a esta aplicação com esse fluxo."
* "Registe um destino do webhook para atualizações do estado da sessão, que aponte para a minha rota `/api/didit/webhook`, e escreva o handler que verifica a assinatura."
* "Crie uma sessão de teste para `user_123` e envie-me a ligação de verificação."

***

## Resolução de problemas

* **O Cursor não abriu a partir da ligação.** Cole, em vez disso, o JSON do separador **mcp.json**.
* **O início de sessão fica preso num ciclo ou falha.** Inicie sessão em [business.didit.me](https://business.didit.me) no seu navegador predefinido primeiro e, depois, volte a ligar-se.
* **Uma ferramenta responde com `missing_scope`.** A sua função nessa organização não tem essa permissão. Consulte [funções e permissões](https://docs.didit.me/pt/integration/mcp/authentication.md#funções-e-permissões).
* **O agente diz que não tem ferramentas da Didit.** Verifique se o servidor `didit` está ativado nas definições de MCP do Cursor e se o início de sessão foi concluído. Consulte [Resolução de problemas](https://docs.didit.me/pt/integration/mcp/advanced.md#resolução-de-problemas).

***

## Próximos passos

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

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

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

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


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