Como conectar o Fine Structure ao Claude Code com MCP

Guia para pessoas sem conhecimento técnico que querem deixar o Claude Code construir, testar e aprimorar aplicativos do Fine Structure via MCP.

O Claude Code consegue trabalhar com o Fine Structure como um colega de equipe que conhece o sistema: ele pode ler a estrutura do aplicativo, entender os arquivos, propor mudanças, executar testes de sistema e solicitar a publicação apenas quando houver a permissão adequada. A conexão é feita via MCP, ou seja, por um token controlado e não por uma senha pessoal.

O que isso oferece a você: Você pode pedir ao Claude Code para construir uma nova tela, corrigir um erro, testar uma versão antes da publicação ou preparar uma mudança para o cliente sem copiar arquivos do sistema manualmente.

Para quem isso é indicado: Para donos de negócios, agências e gerentes de produto que querem que um agente de IA trabalhe no produto dentro de limites claros.

Quão seguro é: O token é limitado por aplicativo e por permissões. Você pode criar um Read only para testes, um Build para trabalho, ou um Full access apenas quando confiar no agente.

Primeiro passo: criação do token MCP

Abra a página MCP, crie um novo token e copie o valor que começa com fse2_mcp_. Sem o token, o Claude Code não consegue acessar a sua conta do Fine Structure.

Passos simples

• 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.
• Abra o Terminal na pasta do projeto em que você trabalha com o Claude Code.
• Cole o comando abaixo e substitua o fse2_mcp_<token> pelo seu token.
• Abra o Claude Code e digite /mcp para confirmar que o servidor fine-structure está conectado.

claude mcp add --transport http fine-structure https://finestructure.ai/api/mcp --header "Authorization: Bearer fse2_mcp_<token>"

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

O que dizer ao Claude 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.

Dica de marketing interna: Se você é uma agência, crie um token travado em um único aplicativo para cada cliente. Assim o Claude Code recebe exatamente o projeto relevante e não a conta inteira.