Pular para o conteúdo principal
O servidor MCP da Base44 expõe sua conta Base44 a qualquer assistente de IA compatível com MCP. Uma vez conectado, você pode descrever o que quer construir ou alterar e a IA criará ou atualizará projetos em seu nome. Para conectar, você deve autenticar com OAuth. Durante esse fluxo, você escolhe a qual workspace dar acesso, e a Base44 só age dentro desse workspace, com sua permissão explícita.
Você precisa de um plano Builder ou superior para conectar um assistente de IA pelo servidor MCP da Base44.

​
Conecte seu assistente de IA

O servidor está disponível em:
Adicione à configuração MCP da sua ferramenta de IA:
Depois de adicionar a configuração, sua ferramenta de IA vai solicitar que você faça login na Base44 pelo fluxo padrão de OAuth. Você só precisa fazer isso uma vez.
Algumas ferramentas exigem reinicialização para detectar novas configurações de MCP.

​
Escolha um workspace

Na etapa de consentimento do OAuth, você escolhe para qual workspace a conexão aponta. Antes, toda conexão usava o seu workspace pessoal por padrão. Agora você pode apontar um assistente para o workspace compartilhado de uma equipe. Toda ação do assistente, incluindo criar, listar e editar projetos, roda no workspace que você escolher, e a conexão não alcança nenhum outro workspace. O workspace fica fixo durante toda a vida da conexão. Para usar outro workspace, conecte de novo e selecione-o no consentimento.

​
O que seu assistente pode fazer em um workspace

Seu assistente age como você, então herda a sua função no workspace selecionado. O que ele pode fazer segue as mesmas regras que valem para você no editor da Base44.
  • Criar projetos: Você precisa de permissão de criação no workspace. Em um workspace compartilhado, um Viewer ou Guest não pode criar projetos.
  • Editar projetos: Você precisa de acesso de escrita ao projeto. Um Viewer somente leitura não pode fazer mudanças, mesmo em um projeto que consegue abrir.
  • Ler projetos: Listar projetos, ler schemas de entidades e consultar registros seguem o mesmo acesso de leitura que você já tem.

​
Workspaces com SSO obrigatório

A Base44 verifica de novo sua participação no workspace a cada requisição e a cada renovação de token, então uma conexão só continua funcionando enquanto seu acesso existir. Se o workspace selecionado exigir SSO, essa verificação é mais rígida. Remover você do workspace encerra a conexão na hora, e trocar a configuração de SSO do workspace a encerra até você conectar de novo.

​
Ferramentas disponíveis

O servidor expõe 3 tipos de ferramentas. As ferramentas de projeto criam e gerenciam projetos e passam mudanças de código para a IA do editor de apps aplicar. As ferramentas de sandbox leem, escrevem e executam comandos diretamente no sandbox do app, para quando você quer que seu assistente escreva o código. As ferramentas da API da plataforma alcançam o restante da plataforma Base44, como deploys, analytics e secrets, por meio da API dela.

​
Ferramentas de projeto

update_entity_schema substitui as definições de campo da entidade pelas que você envia. Qualquer campo ou restrição que você não incluir é removido, não mantido como está.

​
Ferramentas de sandbox

As ferramentas de sandbox que alteram o app precisam da permissão sandbox:write, que você concede na etapa de consentimento do OAuth. Consulte Cloud sandbox para saber como o sandbox funciona, suas permissões e limites, e os comandos CLI base44 sandbox equivalentes.
As mudanças que seu assistente faz com as ferramentas de sandbox são salvas no app na hora, mas só os checkpoints aparecem no histórico de versões do app. Um Restore ou Revert no editor de apps volta o app ao último checkpoint e descarta tudo o que foi escrito depois dele. Peça ao seu assistente para chamar create_checkpoint quando terminar uma mudança.

​
Ferramentas da API da plataforma

Estas ferramentas alcançam recursos da plataforma Base44 que não têm uma ferramenta MCP dedicada, como deploys, checkpoints, URLs publicadas e de preview, analytics, secrets, domínios personalizados, workflows, SEO e Google Ads. Seu assistente encontra uma operação no catálogo, lê o contrato dela e depois a chama. Para registros de entidades, seu assistente usa query_entities, create_entities e update_entities em vez da API da plataforma.
Para encontrar e chamar as mesmas operações pelo terminal, use os comandos base44 api da CLI equivalentes.

​
Trabalhe em um branch

A ferramenta edit_base44_app e as ferramentas de sandbox trabalham no branch principal do app, a menos que você indique outro. Seu assistente obtém o ID de cada branch com list_branches e o passa para atuar nesse branch.
Clientes MCP específicos usam mais 2 ferramentas internamente para verificar o progresso do build. Elas não são feitas para serem chamadas diretamente.

​
Prompts de exemplo

Uma vez conectado, você pode pedir ao seu assistente de IA coisas como:
  • “Crie um projeto Base44 para rastrear candidaturas a vagas com status, nome da empresa e notas de entrevista.”
  • “Edite meu projeto de CRM para adicionar um campo de data de follow-up à entidade Contacts.”
  • “Liste todos os meus projetos Base44.”
  • “Adicione 10 produtos de amostra ao meu projeto de inventário para que eu possa testar a UI.”
  • “Consulte os primeiros 10 pedidos do meu projeto de e-commerce que têm status pending.”
  • “Publique meu projeto de inventário e me envie a URL ao vivo dele.”
A IA interpreta seu pedido e chama a ferramenta apropriada. Para create_base44_app e edit_base44_app, o build roda em segundo plano e você recebe um link para o editor da Base44 quando estiver pronto.

​
Veja também

  • Cloud sandbox: Como as ferramentas do sandbox funcionam e o que seu assistente pode alterar em um app
  • Traga seu próprio agente: Conecte seu próprio agente de codificação ao sandbox de um app
  • Servidor MCP de Docs: Permita que assistentes de IA pesquisem a documentação da Base44 diretamente
  • Skills: Instruções reutilizáveis que ensinam agentes de codificação de IA a realizar tarefas específicas da Base44
  • Entidades: Saiba mais sobre o modelo de dados em que list_entity_schemas e query_entities operam
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.