O que são a API, o MCP e os webhooks?
São três formas de conectar o MB Suite a outras ferramentas, para que ninguém precise copiar dados à mão nem ficar consultando toda hora:
| O que é | Para que serve | Como se conecta |
|---|---|---|
| API REST | Os seus sistemas, o seu ERP ou um script leem e escrevem no MB Suite: criar um negócio a partir do seu site, levar os leads para a sua planilha, atualizar tarefas a partir de outra ferramenta. | Com uma API key que age como uma pessoa, com as permissões por módulo que você escolher. |
| Servidor MCP | O Claude, o ChatGPT, o Cursor ou o seu próprio agente trabalham no seu MB Suite pela conversa: buscar um contato, criar um negócio, ver quanto você investiu na Meta. | O Claude, o ChatGPT, o VS Code e o Claude Code pedem a sua permissão em uma tela do MB Suite; o Cursor e os seus próprios agentes usam uma API key. Passo a passo: Conectar o Claude, o ChatGPT ou o Cursor ao MB Suite com o MCP. |
| Webhooks | O MB Suite avisa o seu sistema no momento em que algo acontece: entra um lead, um negócio muda de etapa, sai uma publicação, chega uma resposta a um formulário. | Você cola o endereço do seu sistema e escolhe os eventos; cada entrega chega assinada. Veja Webhooks. |
Quem os habilita e com qual plano?
Quem os habilita é um owner ou um admin do workspace, uma única vez para todo o workspace. Eles estão incluídos nas assinaturas pagas ativas: o teste grátis não os inclui. Se o seu workspace está no teste, Configurações > API e MCP indica isso e oferece Ir para Assinatura; quando a assinatura estiver paga, volte e habilite-os com um clique. Se a cobrança estiver pausada por falta de pagamento, eles podem ser habilitados quando ela for regularizada.
Enquanto isso, o resto da equipe vê o aviso de que eles ainda não estão habilitados, para pedir a um owner ou a um admin. Depois de habilitados, qualquer membro pode conectar o Claude, o ChatGPT, o VS Code ou o Claude Code com as próprias permissões (a aba MCP tem a URL e os passos); as API keys, os webhooks, o Uso e o Registro são dos owners e dos admins.
Como os habilito?
- No workspace, vá em Configurações > API e MCP.
- Confira o que o seu plano inclui: quantas chamadas por dia e quantas API keys ativas. Se quiser ler antes como funciona, Ver a documentação a abre em outra aba.
- Pressione Habilitar API e MCP. Aparecem as abas API keys, MCP, Webhooks, Uso, Registro e Documentação e, no cabeçalho, o status Habilitados.
- Siga com o que você precisa: criar a sua primeira API key, conectar o Claude, o ChatGPT ou o Cursor ou criar um webhook.
O que acontece nas Contas?
A API e o MCP são habilitados no workspace e valem para todas as suas Contas: uma Conta usa os do seu workspace, e eles não são habilitados nem desligados em uma Conta. Se você abrir API e MCP dentro de uma Conta e eles ainda não estiverem habilitados, a tela avisa: para as pessoas da agência ela oferece Ir para o workspace, e para as do cliente indica que peçam à agência.
As API keys e os apps do workspace também podem trabalhar nas suas Contas, se você permitir ao criá-las ou ao autorizá-los. Para que uma Conta tenha as próprias API keys: se a agência paga a assinatura dela, a agência permite isso em Partners (veja API keys); se a Conta paga a própria assinatura, ela não precisa dessa permissão, mas só pode criar e usar as API keys próprias dela quando essa assinatura estiver paga e ativa (no teste grátis, a tela da Conta avisa).
Como os desligo e o que acontece com o que já criei?
- Em Configurações > API e MCP do workspace, abra o status Habilitados, no cabeçalho.
- Escolha Desligar API e MCP, leia o que acontece e confirme com Desligar.
Em menos de um minuto, as API keys e os apps conectados (Claude, ChatGPT, Cursor e outros) param de responder e os webhooks param de enviar eventos novos, também em todas as Contas do workspace. Nada é apagado: as API keys, os apps autorizados e os webhooks ficam como estavam, e a tela mostra um aviso âmbar com quem os desligou e quando. Enquanto eles estão desligados, não é possível criar API keys nem webhooks, mas você ainda pode editar, rotacionar, suspender, revogar ou excluir os que já tem: é o que você precisa se os desligou por causa de um vazamento. Para voltar, um owner ou um admin pressiona Habilitar de novo e tudo continua como estava.
O que acontece se a assinatura deixar de estar paga?
A API e o MCP ficam em pausa, como se você os desligasse: as API keys e os apps conectados respondem com um erro 402 payment_required, e os webhooks param de enviar eventos. Isso acontece quando a cobrança fica pausada por falta de pagamento ou quando termina o período de uma assinatura cancelada. Nada é apagado: em Configurações > API e MCP do workspace, um aviso explica isso e oferece Ir para Assinatura aos owners e aos admins; quando a assinatura estiver paga de novo, tudo volta a funcionar sozinho, sem precisar habilitar nada.
Cada pedido recusado diz o motivo no código de erro, para que a sua integração saiba o que aconteceu: payment_required (402), a cobrança está pausada; platform_requires_paid_plan (403), a assinatura está no teste grátis ou não existe; platform_not_enabled (403), a API e o MCP estão desligados no workspace ou ainda não foram habilitados. E se o MB Suite suspender o workspace, a API e o MCP respondem organization_suspended: veja Meu workspace aparece como suspenso.
Quanto posso usar?
As cotas crescem com o seu plano: chamadas por dia e por minuto, e quantas API keys e webhooks você pode ter ativos ao mesmo tempo. Você vê as principais na tela onde habilita a API e o MCP e, depois, todas na aba Uso, em Cotas do seu plano; a comparação entre os planos está em Preços. As cotas diárias são reiniciadas todos os dias às 00:00 UTC.
Quando uma chamada precisa de uma cota diária que já se esgotou, ela recebe um erro 429 até o reinício. Ao chegar a 80% e a 100% de uma cota, os owners e admins recebem um aviso por e-mail e nas notificações; em uma Conta, também os do workspace. O que se faz nas telas do MB Suite não conta.
Onde vejo quanto é usado e o que foi feito?
Na aba Uso: as chamadas, leituras, gravações e erros de hoje e do mês, quanto as respostas demoram, as chamadas dos últimos 30 dias, as API keys ou apps que mais chamaram, as operações mais usadas e as Cotas do seu plano, com quanto você já usou de cada uma.
Na aba Registro: cada pedido da API e cada operação que o MCP executa nos últimos 30 dias, com quem fez, com qual API key ou app, qual operação, como terminou e quanto demorou. Você pode filtrar por dia, API key ou app, status, operação ou código de erro, buscar um request_id e abrir um pedido para ver o detalhe e, se ele falhou, o que o erro significa. Ver no registro, no menu de uma API key ou de um app conectado, abre o registro já filtrado. O que uma API key ou um app faz dentro de uma Conta, mesmo sendo do workspace, fica no Registro dessa Conta, não no do workspace. O Registro não guarda o que foi enviado nem o que foi respondido: nunca a API key, o token nem os dados do pedido.
É seguro conectar outras ferramentas?
Cada API key e cada app conectado age como uma pessoa do workspace e nunca pode mais do que ela: se essa pessoa só vê os próprios negócios, a API key ou o app também; se ela é Viewer, só lê. Além disso, você escolhe os módulos que eles alcançam e se podem escrever; excluir vem desligado; e o que é em massa, a maioria das exclusões e o que envia algo para fora do MB Suite, muda algo em outra plataforma ou tem um custo à parte passam antes por uma prévia que a própria ferramenta confirma. Tudo fica registrado no nome dessa pessoa e cada pedido, no Registro.
Se uma API key for usada de forma suspeita —muitos pedidos recusados seguidos ou tentativas de entrar em organizações que não são a dela—, o MB Suite a suspende sozinho e avisa os owners e admins nas notificações; depois que a integração for revisada, ela é reativada pelo menu dela (veja API keys).
Quais plataformas conectadas posso usar pela API e pelo MCP?
Os termos de algumas plataformas limitam o que se pode fazer com os dados delas fora das telas do MB Suite, e a API e o MCP os respeitam. Do Google Ads, do Business Profile, do YouTube e do TikTok não há nada disponível por esse caminho: nem os dados nem alterações ou publicações neles; por isso, os módulos que só trabalham com eles, como o SEO Local ou o Auto-Budget, também não estão disponíveis. Do LinkedIn, só os relatórios das suas contas de anúncios e páginas e os leads dos seus formulários de Lead Gen, e só com uma API key pela API REST, não pelo MCP, por um app conectado nem com uma API key de um agente de IA; os comentários e as menções dos membros dele não estão disponíveis, e não é possível publicar nem alterar nada no LinkedIn. As suas outras plataformas conectadas, como a Meta, o Google Analytics ou o Search Console, funcionam pela API e pelo MCP como o resto do MB Suite.
No CRM, os negócios, prospectos, pessoas e empresas que entraram ou foram completados pelo TikTok não estão disponíveis; os do LinkedIn Lead Gen seguem a regra do LinkedIn, e os de um formulário do Google Ads chegam sem as respostas do formulário. Também não saem por esse caminho os PDFs de um dashboard, de um relatório ou de um envio com dados dessas plataformas, nem é possível criar ou programar um envio que inclua as contas delas.
Um pedido que esses termos não permitem recebe um erro 403 platform_terms_restricted, que diz de qual plataforma se trata, e o MCP nem oferece essas operações ao assistente. Pelo mesmo motivo, os webhooks não enviam alguns eventos, ou os enviam sem alguns dados: Webhooks diz quais. Nas telas do MB Suite tudo funciona como sempre, e a documentação para desenvolvedores lista estas plataformas no guia Permissões e escopos.
O que significa «Beta»?
A tela de API e MCP leva a marca Beta: a API, o MCP e os webhooks já funcionam com os seus dados reais e continuam ganhando operações, eventos e melhorias. Para que uma mudança não quebre o que você já conectou, cada organização fica fixada na versão da API vigente quando cria a primeira API key, e cada API key e cada webhook mantêm a sua até você trocá-la. O que muda em cada versão está no registro de mudanças da documentação.
Onde está a documentação técnica?
Na aba Documentação você tem os guias, a referência dos módulos ativos na sua organização e os eventos de webhooks, e Abrir o site de desenvolvedores leva você ao site completo: developers.mb-suite.com, com a busca, os códigos de erro, o registro de mudanças e o status da API, do MCP e dos webhooks. Para o dia a dia, siga com estes artigos: API keys, Conectar o Claude, o ChatGPT ou o Cursor ao MB Suite com o MCP e Webhooks.
A API, o MCP e os webhooks levam dados da sua organização —contatos, negócios, métricas e o que mais você permitir— para as ferramentas que você escolhe, que os tratam sob as próprias condições. O uso deles é regido pelos nossos Termos e Condições e pelo nosso Acordo de Processamento de Dados (DPA).
Ainda tem dúvidas?
Pergunte à MIA, o assistente de IA do MB Suite: abra-o com o botão MB AI (⌘J) na barra superior. A MIA conhece a seção em que você está, então você pode consultá-la sobre o que vê na tela e também tirar dúvidas de como usar o MB Suite.