Como conectar o Fine Structure a qualquer ferramenta de IA que tenha suporte a MCP

Se a sua ferramenta não aparece na lista, use este modelo: endpoint, Authorization header e token MCP do Fine Structure.

A maioria das ferramentas de IA modernas se conecta ao MCP com a mesma ideia básica: você adiciona um servidor chamado fine-structure, dá um endereço a ele e adiciona um token Authorization. A diferença está apenas no nome do campo no arquivo de configuração: algumas ferramentas usam url, outras usam serverUrl, e outras usam uma estrutura especial como context_servers.

Endereço MCP: https://finestructure.ai/api/mcp é o endereço fixo do servidor do Fine Structure.

Token: O header deve ser Authorization com o valor Bearer fse2_mcp_<token>.

Permissões: Você escolhe as permissões no Fine Structure: somente leitura, construção, publicação, segredos, segurança ou Agency Mode.

Verificação: Após a conexão, peça ao agente para ler get_platform_guide. Se funcionar, a conexão está correta.

A forma universal

Crie um token, copie o endereço e o header, e cole-os na tela de MCP da sua ferramenta.

O que procurar em cada ferramenta de IA

• MCP settings
• Model Context Protocol
• Add custom server
• Remote MCP server
• View raw config
• mcp.json ou mcp_config.json

Ferramenta | O que normalmente é preciso configurar

Claude Code | Remote HTTP server com url e Authorization header.

Codex | config.toml com mcp_servers e campo url.

Google Antigravity | mcp_config.json com serverUrl.

Cursor | .cursor/mcp.json ou ~/.cursor/mcp.json.

Windsurf / Cascade | mcp_config.json com serverUrl ou url.

VS Code / GitHub Copilot | servers dentro do mcp.json, de preferência com input secreto para o token.

Zed | context_servers dentro de settings com url e headers.

Cline / Roo Code / Continue / OpenCode / Claude Desktop | Normalmente a mesma ideia: mcpServers, endereço do servidor e Authorization header. Se não houver suporte a servidor remoto, use a ponte MCP que a ferramenta recomendar.

{
  "mcpServers": {
    "fine-structure": {
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

{
  "mcpServers": {
    "fine-structure": {
      "serverUrl": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

{
  "context_servers": {
    "fine-structure": {
      "url": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

O que dizer ao agente após a conexão

• Peça ao agente: "Use the Fine Structure MCP and call get_platform_guide first."
• Se estiver trabalhando em um aplicativo existente, informe também o nome do aplicativo ou o app_id.
• Antes de uma publicação ou de uma mudança grande, peça ao agente para executar validate_app e inspect_preview.
• Se a conexão falhar, crie um novo token em /mcp e revogue o antigo para não deixar acesso aberto.

Uma regra de segurança simples: Não cole o MCP token em uma captura de tela, em um issue público, em um GitHub commit ou em um documento de cliente. Se um token for exposto, revogue-o na página /mcp e crie um novo.