Como conectar o Fine Structure ao VS Code e ao GitHub Copilot com MCP

O VS Code guarda as configurações de MCP no arquivo mcp.json, e é possível definir o token como um input secreto em vez de escrevê-lo de forma visível.

Se você trabalha com o VS Code e o GitHub Copilot Agent Mode, é possível conectar o Fine Structure como um servidor MCP remoto. Assim o Copilot tem acesso às ferramentas do Fine Structure sem que você precise copiar arquivos, esquemas ou histórico de erros manualmente.

Onde colocar o arquivo: Você pode usar o .vscode/mcp.json para um workspace específico ou a configuração User MCP para todo o computador.

Armazenamento do token: O VS Code oferece suporte a input variables, de modo que o token pode ser guardado como secreto e não aparecer no arquivo.

Verificação da conexão: Pela Command Palette, você pode executar MCP: List Servers ou abrir a configuração do MCP.

Comece pelo Fine Structure

Crie um token MCP e então volte ao VS Code. Se estiver em dúvida, escolha Read only para testar a conexão antes de editar.

Passos

• Entre na sua conta do Fine Structure.
• Abra a página MCP pelo botão Create MCP token na documentação, ou diretamente por /mcp.
• Escolha se o agente terá acesso a todos os aplicativos de sua propriedade ou apenas a um aplicativo.
• Escolha as permissões: Read only para testes, Build para edição, Full access apenas para um agente em que você confia.
• Clique em Create MCP setup e copie o token ou o bloco de configuração. O token é exibido apenas uma vez.
• No VS Code, abra a Command Palette e procure por MCP: Open Workspace Folder MCP Configuration ou MCP: Open User Configuration.
• Cole a configuração abaixo.
• Quando o VS Code solicitar o Fine Structure MCP token, cole o token sem compartilhá-lo com outras pessoas.
• Execute MCP: List Servers e confirme que o servidor fineStructure está ativo.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fineStructureToken",
      "description": "Fine Structure MCP token",
      "password": true
    }
  ],
  "servers": {
    "fineStructure": {
      "type": "http",
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:fineStructureToken}"
      }
    }
  }
}

Por que isso é bom: O input secreto ajuda você a não guardar tokens dentro do Git. Isso é especialmente importante em equipes ou em projetos de clientes.