Conectar via MCP

O Buildprint MCP permite que você conecte um cliente de IA compatível, como Cursor, Claude Code, Claude, OpenCode ou ChatGPT, ao seu workspace do Buildprint para que o cliente possa usar as ferramentas MCP de leitura do Buildprint em seus aplicativos Bubble.

Antes de começar

• Conecte seu aplicativo Bubble ao Buildprint e conclua a verificação de propriedade primeiro. Veja Connecting your Bubble app.

• Certifique-se de que o colaborador do Buildprint tenha as permissões do Bubble que você deseja que o Buildprint leia.

• Use um cliente de IA que suporte servidores MCP HTTP remotos, conectores ou aplicativos.

• Trate a URL do seu servidor MCP como um segredo. Qualquer pessoa com a URL pode usar esse servidor até que você a revogue.

Criar a URL do seu servidor MCP

1. No Buildprint, abra Integrations > MCP.

2. Clique em Create MCP server.

3. Escolha se o servidor deve acessar todos os projetos no workspace ou apenas projetos selecionados.

4. Copie a URL do servidor MCP gerada.

A URL do servidor MCP é específica do workspace e limitada aos projetos que você selecionou ao criá-la. Crie URLs separadas se desejar escopos diferentes ou se quiser revogar um cliente sem afetar outro.

Instalar no seu cliente de IA

Cursor

Use o botão Add to Cursor do Buildprint na caixa de diálogo do MCP ou siga o Cursor's MCP install guide e cole a URL do seu servidor MCP HTTP gerada.

Claude Code

Execute este comando no seu terminal, substituindo YOUR_MCP_SERVER_URL pela URL que você copiou do Buildprint:

claude mcp add --transport http buildprint YOUR_MCP_SERVER_URL

Se o Claude Code não reconhecê-lo imediatamente, reinicie o aplicativo e verifique os Claude Code's MCP docs.

Claude, OpenCode, ChatGPT e outros clientes

Cole a URL do servidor MCP gerada nas configurações de MCP, conectores ou aplicativos do cliente. Se o cliente solicitar uma configuração JSON, use:

{
  "mcpServers": {
    "buildprint": {
      "type": "http",
      "url": "YOUR_MCP_SERVER_URL"
    }
  }
}

Documentos de referência: Claude, OpenCode, ChatGPT.

Para que o Buildprint MCP é bom

• Pesquisar documentos do Buildprint e metadados do projeto.

• Inspecionar a estrutura, versões, logs e dados sincronizados do aplicativo Bubble por meio das ferramentas MCP do Buildprint.

• Depurar problemas, entender workflows, comparar versões e investigar problemas de produção sem abrir o Bubble manualmente.

Limitações atuais

• Sem edição via servidores MCP pessoais: os servidores MCP criados em Agent -> Integrations -> MCP são atualmente apenas para leitura.

• Sem suporte oficial de configuração para clientes MCP de terceiros: não oferecemos suporte prático para configurar Cursor, Claude, ChatGPT, OpenCode ou outras instalações de MCP do lado do cliente.

• Sem garantias: Buildprint é um software beta. Não garantimos tempo de atividade, estabilidade, compatibilidade ou comportamento para o Buildprint em si ou para qualquer cliente MCP de terceiros.

• O escopo do projeto ainda se aplica: o servidor MCP só pode acessar os projetos selecionados quando o token foi criado.

• As permissões do Bubble ainda se aplica: o Buildprint não pode exceder as permissões de colaborador concedidas no Bubble.

• Valores sensíveis permanecem protegidos: o Buildprint não expõe valores do conector de API privada do Bubble ou segredos de plugins através do MCP.

Solução de problemas

• O servidor funciona para alguns aplicativos, mas não para outros: certifique-se de que o projeto esteja incluído no escopo do token e que a verificação de propriedade tenha sido concluída.

• Ferramentas de logs ou dados falham: verifique as permissões de colaborador do Bubble para acesso a logs, dados e versões.

• Seu cliente não consegue adicionar o servidor: alguns clientes não suportam servidores MCP HTTP remotos ou seu fluxo de instalação pode ter mudado. Siga os documentos mais recentes do cliente vinculados acima.

• Você precisa remover o acesso: revogue o servidor MCP em Agent -> Integrations -> MCP e crie um novo.

Guias relacionados: Permissions and data safety, Support guidelines.