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

# Ligar o VS Code e o Copilot ao servidor MCP da Didit

> Ligue o servidor MCP da Didit ao VS Code e ao Copilot: instalação com um clique ou mcp.json. Inicie sessão, sem chave de API.

O VS Code liga o modo de agente do GitHub Copilot ao servidor MCP alojado do Didit (`https://mcp.didit.me/mcp`) através de uma ligação de instalação, de uma entrada em `mcp.json` ou de um único comando `code`. Depois, o VS Code pede-lhe que inicie sessão; no navegador, clique em **Log in with Didit**. Não há nenhuma chave de API para copiar.

> [card] [Adicionar o Didit ao VS Code](https://vscode.dev/redirect/mcp/install?name=didit\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.didit.me%2Fmcp%22%7D)
>
> Abre o fluxo de instalação do VS Code para o servidor `didit` (HTTP, mcp.didit.me/mcp). Clique em Instalar e, em seguida, inicie sessão com o Didit.

A ligação de instalação, para o seu próprio botão ou README:

```text theme={null}
https://vscode.dev/redirect/mcp/install?name=didit&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.didit.me%2Fmcp%22%7D
```

Redireciona para `vscode:mcp/install?{"type":"http","url":"https://mcp.didit.me/mcp","name":"didit"}`. Para o VS Code Insiders, use `https://insiders.vscode.dev/redirect/mcp/install?…` com a mesma cadeia de consulta.

***

## Configurar por método

> [tab] Link de instalação
>
> 1. Clique em [**Adicionar o Didit ao VS Code →**](https://vscode.dev/redirect/mcp/install?name=didit\&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.didit.me%2Fmcp%22%7D) e deixe o navegador abrir o VS Code.
> 2. O VS Code mostra o servidor `didit`. Clique em **Instalar**.
> 3. Quando o VS Code pedir para iniciar sessão, autorize e conclua **Iniciar sessão com Didit** no navegador.

> [tab] mcp.json
>
> Para um único espaço de trabalho, adicione `.vscode/mcp.json`:
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> O VS Code usa `servers`, e não a chave `mcpServers` que outros clientes utilizam. Aponte-o para o URL completo `/mcp`: o servidor publica os seus metadados OAuth para esse caminho.

> [tab] Paleta de comandos
>
> 1. Execute **MCP: Add Server** a partir da paleta de comandos.
> 2. Escolha **HTTP**, cole `https://mcp.didit.me/mcp` e dê-lhe o nome `didit`.
> 3. Escolha onde guardar (o seu perfil de utilizador ou o espaço de trabalho) e, quando for pedido, inicie sessão.

> [tab] Linha de comandos
>
> Adicione o servidor ao seu perfil de utilizador com o comando `code`:
>
> ```bash theme={null}
> code --add-mcp '{"name":"didit","type":"http","url":"https://mcp.didit.me/mcp"}'
> ```
>
> Ele mostra `Added MCP servers: didit` e escreve a entrada no seu `mcp.json` de utilizador.

> [!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. Consulte [Autenticação](https://docs.didit.me/pt/integration/mcp/authentication.md).

***

## Verificar se funciona

Abra o Copilot Chat, mude para o modo **Agent** e pergunte:

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

O Copilot pede-lhe que permita a chamada `didit_context_get` e, em seguida, lista as suas organizações e as respetivas aplicações.

> [!TIP]
>
> **Demasiadas ferramentas ativadas?** Um utilizador da Didit com sessão iniciada tem bem mais de cem ferramentas. Se o Copilot avisar sobre o número de ferramentas, abra o seletor de ferramentas no campo de entrada do chat e mantenha apenas os grupos de ferramentas da Didit de que a tarefa precisa, por exemplo as sessões e os fluxos.

***

## Resolução de problemas

* **O link de instalação não abriu nada.** Use o separador **mcp.json** ou **Command line** em alternativa.
* **O início de sessão entra num ciclo ou falha.** Comece por iniciar sessão em [business.didit.me](https://business.didit.me) no seu navegador predefinido. Depois, execute **MCP: List Servers**, selecione `didit` e reinicie-o.
* **Uma ferramenta responde com `missing_scope`.** A sua função nessa organização não tem a permissão necessária. Consulte [funções e permissões](https://docs.didit.me/pt/integration/mcp/authentication.md#funções-e-permissões).

***

## Próximos passos

> [card] [Ligar ao Cursor](https://docs.didit.me/pt/integration/mcp/cursor.md)
>
> Ligação para instalação com um clique e mcp.json para o Cursor.

> [card] [Ligar ao OpenAI Codex](https://docs.didit.me/pt/integration/mcp/codex.md)
>
> Um comando para a CLI do Codex e para a extensão de 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] [Outros clientes](https://docs.didit.me/pt/integration/mcp/installation.md)
>
> Windsurf, Zed, qualquer cliente MCP e alojamento próprio.


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