MCP no VS Code e no Windsurf

VS Code (Copilot)

O VS Code usa servidores MCP no GitHub Copilot Chat, em modo agente. Com um inputs do tipo senha, o VS Code pergunta a chave na primeira vez e guarda com segurança — o arquivo pode ir para o Git sem expor nada.

1. Gere uma chave em Configurações → Desenvolvedor.

2. Crie o arquivo .vscode/mcp.json no projeto:

   .vscode/mcp.json

   {
     "inputs": [
       {
         "id": "toptalking-key",
         "type": "promptString",
         "password": true,
         "description": "Chave de API da TopTalking"
       }
     ],
     "servers": {
       "toptalking": {
         "type": "http",
         "url": "https://platform.toptalking.com.br/mcp",
         "headers": {
           "Authorization": "Bearer ${input:toptalking-key}"
         }
       }
     }
   }

3. Clique em Start sobre o servidor no próprio arquivo (ou rode o comando MCP: List Servers) e cole a chave quando o VS Code pedir.

4. Abra o Copilot Chat, escolha o modo Agent e confira no seletor de ferramentas se as da toptalking estão marcadas.

5. Peça: “Liste as etapas do Kanban da TopTalking e quantos contatos há em cada uma.”

Windsurf

O Windsurf (Cascade) lê os servidores MCP de um arquivo global.

1. Gere uma chave em Configurações → Desenvolvedor.

2. Abra o arquivo ~/.codeium/windsurf/mcp_config.json (no Windows, %USERPROFILE%\.codeium\windsurf\mcp_config.json) — também dá para abrir pelo painel de MCP do Cascade.

3. Cole e troque tt_live_SUA_CHAVE pela sua chave:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "toptalking": {
         "serverUrl": "https://platform.toptalking.com.br/mcp",
         "headers": {
           "Authorization": "Bearer tt_live_SUA_CHAVE"
         }
       }
     }
   }

4. No Cascade, atualize a lista de servidores MCP e confirme que a toptalking aparece com as ferramentas.

5. Peça: “Use a TopTalking para buscar o contato com telefone 5511999998888.”

Veja as ferramentas e os cuidados de segurança em Servidor MCP. Para a IA escrever código de integração, use as regras prontas em Cursor, Windsurf e Copilot.