Em duas linhas: o MCP é a porta pela qual um assistente de IA trabalha dentro do MB Suite. Você cola a URL do servidor no Claude, no ChatGPT, no Cursor ou em outro app, autoriza no MB Suite o que ele pode fazer e, a partir daí, pede coisas em linguagem natural: ele as faz como você, com as suas permissões, e tudo fica registrado no seu nome.

O que é o MCP e o que posso fazer com ele?

MCP (Model Context Protocol) é um padrão aberto para que os assistentes de IA usem outros aplicativos. Com o MB Suite conectado, você pode pedir ao Claude, por exemplo, «quais negócios abertos eu tenho no pipeline de vendas?», «procure a Laura Gómez e me diga em que etapa está o negócio dela», «crie um negócio para a Acme e registre uma nota com o que conversamos» ou «quanto investi na Meta este mês contra o anterior?», e o assistente faz isso no seu MB Suite sem que você copie nada à mão.

O assistente trabalha como a pessoa que o autorizou: vê o que ela vê e faz o que ela pode fazer, dentro das permissões que ela deu, nunca mais. Cada ação fica registrada no nome dela. Por padrão, todo app só lê, mesmo que peça para escrever: se você quiser que ele também crie ou altere registros, ative isso ao autorizá-lo (mais abaixo, como).

Do que preciso para conectar?

Ser membro de uma organização com a API e o MCP habilitados: quem os habilita é um owner ou um admin do workspace (veja API, MCP e webhooks). O Claude, o ChatGPT, o VS Code e o Claude Code se conectam por OAuth: pedem a sua permissão em uma tela do MB Suite e você decide o que dar, sem criar nada antes. O Cursor, um agente próprio ou um script se conectam com uma API key, que um owner ou um admin cria. Os conectores personalizados dependem do seu plano no Claude ou no ChatGPT: se você não vê a opção, confira com eles.

Qual é a URL do servidor?

Ela está em Configurações > API e MCP, na aba MCP, em Servidor MCP, com o botão Copiar: https://mcp.mb-suite.com. É a mesma para todos: a organização e as permissões são escolhidas ao autorizar ou, com uma API key, definidas pela API key. Se você já conectou um app com o endereço anterior, https://mb-suite.com/api/platform/mcp, não é preciso trocá-lo.

Em Conectar, a mesma aba tem o passo a passo de cada app —Claude, ChatGPT, Cursor, VS Code, Claude Code e Outro app—, com a configuração ou o comando prontos para copiar (Copiar configuração, Copiar comando). São os mesmos passos de baixo.

Como conecto o Claude?

No Claude, abra Configurações → Conectores → Adicionar conector personalizado.
Cole a URL do servidor (se pedir um nome, coloque MB Suite) e salve.
O Claude leva você ao MB Suite para escolher a organização e revisar as permissões (mais abaixo, o que tem nessa tela). Ao pressionar Permitir, você volta ao Claude já conectado.
Em uma conversa, teste com «O que posso fazer no MB Suite?». A primeira coisa que o assistente usa é mb_context, que diz a ele quem você é, em qual organização ele está e o que pode fazer. Se não estiver ativo, ative-o pelo menu de ferramentas do chat.

Nos planos Team e Enterprise do Claude, primeiro um owner da conta do Claude adiciona o conector pelas configurações de administração; depois cada pessoa o conecta e o autoriza com o próprio usuário do MB Suite.

Como conecto o ChatGPT?

No ChatGPT, abra Configurações → Apps e conectores → Configurações avançadas e ative o modo desenvolvedor. Em planos empresariais, quem habilita é o administrador.
De volta a Apps e conectores, escolha Criar, cole a URL do servidor como servidor MCP e, se perguntar, escolha OAuth como autenticação.
O ChatGPT leva você ao MB Suite para autorizar: revise a organização e as permissões e pressione Permitir.
Em uma conversa, ative o app do MB Suite e peça algo do seu CRM.

A OpenAI muda esses menus com frequência: os conectores agora se chamam apps, e o modo desenvolvedor já mudou de lugar mais de uma vez. Se não encontrar, procure «developer mode» na ajuda do ChatGPT.

Como conecto o Cursor?

Crie uma API key na aba API keys. Se preferir que o agente veja uma ferramenta tipada para cada operação, em Avançado escolha Uma ferramenta por operação.
Na aba MCP, em Conectar, escolha Cursor e copie a configuração com Copiar configuração.
No Cursor, abra Cursor Settings → Tools & MCP → New MCP Server, cole a configuração, substitua mbs_live_SUA_API_KEY pela sua API key inteira e salve.
As ferramentas do MB Suite aparecem no agente do Cursor.

A configuração tem este formato: {"mcpServers": {"mb-suite": {"url": "https://mcp.mb-suite.com", "headers": {"Authorization": "Bearer mbs_live_SUA_API_KEY"}}}}.

Guarde a configuração com a sua API key no arquivo global do Cursor (~/.cursor/mcp.json), não no .cursor/mcp.json de um projeto: esse arquivo fica dentro do repositório e pode acabar enviado junto com o código.

Como conecto o VS Code?

No VS Code, abra a paleta de comandos e escolha «MCP: Add Server». Você precisa do GitHub Copilot.
Escolha HTTP, cole a URL do servidor e salve para o seu usuário ou para o projeto. Se preferir editar o arquivo, Copiar configuração na aba MCP dá a configuração do .vscode/mcp.json.
Na primeira vez, o VS Code pede permissão para entrar e leva você ao MB Suite para escolher a organização e revisar as permissões. O VS Code não é um dos apps que o MB Suite reconhece, então a tela pede que você marque «Entendo que o MB Suite não verificou este app…» antes de poder pressionar Permitir.
No chat do Copilot, no modo Agente, teste com «O que posso fazer no MB Suite?».

Como conecto o Claude Code?

No terminal, adicione o servidor com o comando da aba MCP (Copiar comando): claude mcp add --transport http mb-suite https://mcp.mb-suite.com. Se você somar --scope user, ele fica disponível em todos os seus projetos.
Abra o Claude Code, digite /mcp e escolha mb-suite para se autenticar.
O Claude Code abre o MB Suite no navegador para escolher a organização e revisar as permissões; ao pressionar Permitir, você volta ao Claude Code já conectado.
Teste com «O que posso fazer no MB Suite?».

Como conecto outro app, um agente próprio ou um script?

Na aba MCP, em Conectar, Outro app explica as três formas, com a configuração pronta para copiar: se o app aceita servidores MCP remotos com OAuth, você cola a URL do servidor e ele traz você ao MB Suite para autorizá-lo, como o Claude; se em vez disso ele pede uma API key, você a cria na aba API keys e a usa como Bearer no cabeçalho Authorization; e se o app só aceita servidores locais, você o conecta com a ponte mcp-remote, que precisa do Node.js. Um agente próprio ou um script faz o mesmo com qualquer cliente MCP: conecta-se por HTTP à URL do servidor e envia a API key no cabeçalho Authorization de cada requisição.

Em uma Conta cuja agência ainda não permitiu API keys próprias, a aba MCP avisa isso quando você escolhe Cursor ou Outro app: os apps que se conectam por OAuth —Claude, ChatGPT, VS Code ou Claude Code— podem ser conectados.

O que vejo ao autorizar um app?

Quando o Claude, o ChatGPT ou outro app pede acesso, o MB Suite abre a tela «… quer acessar o seu MB Suite», com o nome do app (se você não estiver com a sessão iniciada, ele pede para entrar antes). Antes de pressionar Permitir:

Confira quem está pedindo acesso, abaixo do título. O MB Suite reconhece o Claude, o Claude Code e o ChatGPT pelo domínio, não pelo nome que eles declaram: eles mostram o próprio logo ao lado do logo do MB Suite e a legenda Identificado pelo domínio, seguida do domínio deles (como claude.ai ou chatgpt.com). Um app que se registra sozinho ao se conectar —o VS Code, por exemplo— mostra a inicial no lugar do logo e, em âmbar, Sem identidade verificada (o nome, o logo e os links foram declarados pelo próprio app) ou, se ele se identificar pelo próprio domínio, Identificado pelo domínio com esse domínio. Se um app que o MB Suite não reconhece for enviar você para um site ao terminar, o endereço aparece no topo, em âmbar: «Ao terminar, ele vai enviar você para…». Só os apps publicados ou verificados pelo MB Suite mostram App verificado.
Em Organização, escolha onde ele vai trabalhar: uma organização da qual você é membro e com a API e o MCP habilitados. Se nenhuma das suas os tiver, a tela avisa: quem os habilita é um owner ou um admin em Configurações > API e MCP, com uma assinatura paga ativa.
Em Permissões solicitadas, a linha Ver suas informações resume o que o app vai poder ler: «Leitura em … módulos, com as mesmas permissões que você». Logo abaixo, você sempre vê o detalhe dos módulos com dados sensíveis —por exemplo, quais dados do CRM, os SMS do Phones, as mensagens diretas do Inbox, as respostas do Web Forms ou as audiências do Email Marketing—, e Ver módulos abre a lista completa.
Escrever vem desligado, mesmo que o app peça. Se você quiser que ele também crie e modifique registros, ative a linha Leitura e escrita: se o app pediu permissões específicas, ela cobre só os módulos em que ele pediu para escrever, e, se ele pediu só leitura, a linha não aparece. Excluir é à parte.
Escrever em um módulo sensível —Membros, Branding, Contas, Client Portal, Email Marketing ou Integrações— fica à parte, em Escrita em módulos sensíveis: um interruptor por módulo, todos desligados, mesmo que o app peça. Ative só os de que ele realmente precisa: escrever ali pode mudar quem entra, a sua marca, o que os seus clientes recebem ou as suas conexões. Cada módulo que você ativa fica âmbar.
Se o app pedir para excluir, ao ativar a escrita em algum módulo aparece à parte uma linha desligada: Excluir registros de…, com os módulos em que ele vai poder escrever. Ative-a só se quiser que ele possa excluir; ao ativá-la, ela fica âmbar.
Se o app pedir isso, ou não detalhar quais permissões quer, aparece à parte a linha E-mail e calendário conectados, desligada. Ative-a só se quiser que o app leia os e-mails da sua própria caixa e os eventos do seu próprio calendário vinculados a pessoas, empresas ou negócios do CRM (nunca a caixa inteira); ao ativá-la, a linha fica âmbar. Se a organização que você escolheu não permitir, a linha fica desabilitada com o aviso «Sua organização não permite isso: um owner ativa em Configurações → API e MCP → API keys».
Se você escolheu o workspace de uma agência, pode ativar Acessar também as Contas e escolher Todas as Contas ou Escolher Contas: o app também vai trabalhar nelas, só nas que você vê.
Em Avançado você pode mudar o Modo de ferramentas do MCP (mais abaixo, o que muda).
No rodapé, ao lado de Cancelar e Permitir, o Claude, o Claude Code e o ChatGPT mostram para onde você volta ao terminar e um lembrete. Com o Claude: «Ao terminar, você volta para Claude em claude.ai. Permita só se foi você quem acabou de iniciar esta conexão a partir de Claude». O Claude Code volta para este computador, então diz «Ao terminar, você volta para Claude Code neste computador (localhost:…)», seguido do mesmo lembrete. Ali também ficam o aviso de que é um app externo e os links para os Termos e a Política de privacidade do MB Suite e para a política de privacidade da empresa do app. Se não foi você quem iniciou a conexão, pressione Cancelar: alguém pode iniciá-la pela própria conta e enviar o link para você.
Se o MB Suite não reconhece o app nem o verificou, o rodapé mostra, ao lado de Permitir, a caixa «Entendo que o MB Suite não verificou este app…»: marque-a só se foi você quem acabou de iniciar a conexão, a partir desse app; sem isso, Permitir não é habilitado.
Pressione Permitir para voltar ao app já conectado, ou Cancelar para não dar acesso.

Nessa tela você escolhe a organização, se o app também escreve, a escrita em cada módulo sensível, se ele pode excluir, se pode ler o e-mail e o calendário conectados, as Contas e o modo de ferramentas. O que você não escolhe é, módulo por módulo, o que ele lê: a leitura é concedida junta, em todos os módulos que ele pede, e a escrita dos módulos comuns também, só se você ativar Leitura e escrita, independentemente do que o app pedir. Se o app pedir para ler mais do que você quer dar, pressione Cancelar.

Se você já conectou o app sem essa permissão —porque a sua organização ainda não permitia ou porque você não a ativou— e agora quer dá-la, desconecte-o em Conexões autorizadas e conecte-o de novo pelo app, desta vez com a linha ativada. E se depois um owner desativar isso para a organização, o app deixa de ler e-mail e calendário na hora, sem que você precise desconectá-lo, e volta a ler assim que isso for ativado de novo. Quem ativa e o que acontece ao desativar está em API keys.

O que o app ler do seu e-mail e do seu calendário sai do MB Suite: o app recebe esse conteúdo e o guarda sob as condições dele e, em planos pessoais de alguns assistentes de IA, pode ser usado para treinar modelos, a menos que você desative isso no app. Os e-mails incluem dados dos seus clientes: a sua organização responde por essa entrega, e o app não pode usá-los para publicidade nem revendê-los. Ative E-mail e calendário conectados só em apps em que você confia e que realmente precisem disso.

Se, em vez dessa tela, você vir Esta solicitação não pode ser autorizada, o app enviou uma solicitação que não corresponde ao registro dele e, por segurança, o MB Suite não redireciona você para lugar nenhum: feche a aba e tente de novo pelo app.

O que o assistente pode fazer depois de conectado?

No modo Compacto (recomendado), o assistente vê cinco ferramentas gerais e, se tiver acesso ao CRM, mb_search:

Ferramenta	Para que serve
`mb_context`	Diz em nome de quem ele age, em qual organização, com qual função, plano e limites diários, quais Contas alcança (uma lista curta e quantas são no total), quais integrações estão conectadas, o que aconteceu há pouco no CRM e em quais módulos pode trabalhar, com a quantidade de operações de cada um. É a primeira coisa que ele usa.
`mb_catalog`	O catálogo de operações de um módulo, com a descrição completa de cada uma. Um módulo grande, como o CRM, chega um grupo por vez.
`mb_search_operations`	Encontra uma operação por palavras, em português, inglês ou espanhol. Se a mudança que você pediu precisa de uma permissão que a conexão não tem —escrever, com uma conexão que só lê—, ou só é feita nas telas do MB Suite, como criar API keys, ele avisa.
`mb_describe_operation`	A ficha de uma operação: quais dados pede e o que devolve.
`mb_execute_operation`	Executa uma operação.
`mb_search`	Busca no CRM negócios, pessoas, empresas e prospectos por texto.

Com Uma ferramenta por operação, ele também vê uma ferramenta para cada operação que pode executar (por exemplo, crm_deals_create), algo que alguns modelos aproveitam melhor. Nos dois casos, o assistente só vê o que a pessoa pode fazer com essas permissões.

Se você pedir algo que a conexão não pode fazer —alterar registros com uma conexão que só lê, ou excluir sem essa permissão—, o MB Suite diz ao assistente exatamente o que falta, para que ele conte a você. Para dar essa permissão, desconecte o app em Conexões autorizadas e conecte-o de novo com ela ativada; com uma API key, um owner ou um admin a altera com Editar. E se uma resposta for longa demais para uma única mensagem —uma lista muito longa, por exemplo—, ela chega cortada e diz ao assistente como pedir o resto, para que ele a percorra em partes.

Pelo MCP não há nada disponível do Google Ads, do Business Profile, do LinkedIn, do TikTok nem do YouTube, porque os termos deles não permitem: o assistente não vê as operações deles, ou recebe um erro que explica isso, e onde várias plataformas se misturam —um dashboard ou a atribuição do CRM, por exemplo— ele recebe o resto sem elas. No CRM, ele não vê os negócios, prospectos, pessoas nem empresas que entraram ou foram completados pelo TikTok ou pelo LinkedIn Lead Gen, e não recebe os PDFs de dashboards, relatórios nem envios com dados dessas plataformas. Nas telas do MB Suite tudo funciona como sempre (quais plataformas e por quê, em API, MCP e webhooks).

E as ações em massa, os envios e o que não pode ser desfeito?

Algumas coisas não são executadas direto: o que muda muitos registros de uma vez (mover ou excluir negócios em massa, por exemplo), o irreversível, como excluir, o que envia algo para fora do MB Suite —um WhatsApp, um e-mail, um SMS, uma publicação nas suas redes, um convite para uma reunião— ou muda algo em outra plataforma, e o que tem um custo à parte, como gerar com IA ou auditar um site. Primeiro o assistente pede uma prévia (dry_run) que diz o que vai acontecer —quais e quantos registros vão mudar, o que vai sair ou se tem um custo à parte— e devolve um confirm_token; só com esse código, que vale 10 minutos, ele pode executar. Peça que ele mostre a prévia antes de confirmar.

Algumas poucas pedem isso só quando de fato enviariam algo: convidar um membro sem o e-mail de convite, por exemplo, é executado direto. A própria prévia diz ao assistente se ele precisa do código.

Excluir também exige que você tenha permitido isso ao autorizar o app ou ao criar a API key. A maioria das exclusões deixa uma cópia por 30 dias na Lixeira —o que é excluído do CRM, na Lixeira do CRM—, onde o owner ou um admin pode restaurá-la. Se você é owner ou admin, também pode pedir ao assistente que a restaure: cada exclusão diz a ele qual cópia ficou na Lixeira. O que vive fora do MB Suite não volta, como um modelo de WhatsApp na Meta ou um evento do seu calendário: o assistente vê em cada operação se dá para desfazer.

Se o assistente fizer muitíssimas chamadas seguidas ou em um mesmo dia, o MB Suite pede que ele espere e tente de novo: há um limite por minuto e um por dia, que dependem do seu plano. O assistente os vê em mb_context, e os owners e admins, na aba Uso.

Se o assistente não conseguir se conectar ou o MB Suite parar de responder, confira developers.mb-suite.com/status: ali você vê o status da API, do servidor MCP e dos webhooks, com os incidentes em andamento e as manutenções programadas; confira também se a API e o MCP continuam habilitados e a assinatura ativa. Se o que falha é uma operação, o assistente recebe o motivo, o campo que estava errado e um request_id: muitas vezes ele corrige a chamada sozinho, e se você escrever para nós sobre isso, inclua esse código.

Como vejo e desconecto os apps autorizados?

Vá em Configurações > API e MCP e abra a aba MCP.
Em Conexões autorizadas você vê cada app conectado por OAuth: o App, em nome de quem ele age (Age como, que é quem o autorizou), um resumo das Permissões, as Contas que alcança, quando foi Conectado e o Último uso. Clique na linha para ver, abaixo dela, todas as permissões agrupadas por área. Se um app pode ler o e-mail e o calendário conectados, as permissões dele mostram E-mail e calendário conectados (se a organização desativou isso depois, sai do resumo e o detalhe mostra E-mail e calendário conectados · pausado).
No menu Ações da linha do app (os três pontos), escolha Desconectar e confirme. O app perde o acesso na hora; para usá-lo de novo, ele terá que pedir permissão outra vez.

As API keys não aparecem ali: elas são suspensas ou revogadas na aba API keys. Se você não é owner nem admin, em API e MCP vê só as abas MCP e Documentação; em MCP, os apps que você autorizou, que pode desconectar por conta própria; o owner e os admins veem os de toda a organização e podem desconectar qualquer um. No menu Ações de cada app, o owner e os admins também têm Ver no registro, que abre a aba Registro filtrada por esse app. Se quem autorizou um app sair da organização, o app para de funcionar.

Um app conectado pelo MCP lê e modifica dados do seu MB Suite —contatos, empresas, negócios e atividades do CRM, as métricas das plataformas que você conectou cujos termos permitem (Meta, Google Analytics, Search Console, Facebook e Instagram; os do Google Ads, do Business Profile, do LinkedIn, do TikTok e do YouTube não deixam usá-las pelo MCP) e, se você permitir, os e-mails e eventos vinculados ao CRM— e os processa com a própria IA, sob os próprios termos. Autorize só apps em que você confia, com as permissões de que precisam, e desconecte os que não usa mais. O uso do MCP e o tratamento desses dados são regidos pelos nossos Termos e Condições, pela nossa Política de privacidade 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.

Conectar o Claude, o ChatGPT ou o Cursor ao MB Suite com o MCP