MCP: o Hub nas mãos da sua IA

Os dados da sua empresa não precisam ficar trancados dentro do Hub. Se você já trabalha com um assistente de IA (o Claude, o ChatGPT ou outro), dá para conectá-lo diretamente à sua conta: ele passa a consultar tarefas, negócios, cadastros e conversas, e a agir sobre eles, com o acesso exatamente do tamanho que você definir. É o Hub virando ferramenta na mão da IA que você já usa.

[!box] Disponível a partir do plano Colaborador Conectar um assistente de IA e criar chaves de API são recursos do assento Colaborador e dos planos acima dele. O assento de entrada não os inclui: ele é o acesso barato para a empresa inteira usar o Hub, não o assento de quem constrói integrações.

O que é e quando usar

O Hub fala MCP, um padrão aberto que permite a assistentes de IA usarem outros sistemas como ferramentas. Na prática: você copia o endereço MCP do Hub, cola no seu assistente, entra com a sua conta Marvee e escolhe na hora o que ele pode fazer. Feito isso, o assistente enxerga e opera o Hub, limitado ao que você autorizou.

A autorização é sempre sua, individual. O endereço é o mesmo para a organização toda, mas cada pessoa que conecta entra com a própria conta e recebe o próprio acesso. Duas pessoas conectadas pelo mesmo endereço enxergam coisas diferentes, cada uma pelo que pode fazer no Hub. Ninguém herda o acesso de ninguém.

Dois caminhos, públicos diferentes:

O que o acesso MCP entrega hoje:

• Um endereço único para a organização, em Configurações, na área MCP & API. Botões prontos para Claude, ChatGPT e Cursor, e o endereço à mão para qualquer outro cliente MCP.
• Autorização com a sua conta, na hora de conectar: uma tela mostra quem está pedindo acesso e o que você está concedendo, antes de valer.
• Acesso escolhido em níveis, por app: Somente leitura e Operação resolvem o caso comum em um clique, e Personalizado abre a matriz com uma linha por app, para decidir app a app. As ações sensíveis (exclusões e configuração) ficam fora dos níveis de propósito: entram só pelo ajuste fino, uma a uma.
• Lista de quem autorizou o quê, com busca e revogação. O administrador enxerga as conexões da organização e pode revogar a de um colega; o endereço da conexão, esse, continua sendo só de quem é dono.
• Respeito total às permissões, a cada chamada: a conexão nunca pode mais do que você pode. Se o seu acesso no Hub mudar hoje, a conexão encolhe junto na chamada seguinte, sem precisar refazer nada.
• Escrita com governança no Brain: a IA externa não altera o conhecimento da empresa diretamente; ela propõe, e a proposta espera aprovação humana na Caixa de entrada do Brain.

Na aba API, para quem escreve código: chaves mk_ com os mesmos níveis de acesso, validade opcional e a documentação das APIs do Hub na mesma tela. O valor da chave aparece uma vez, na criação.

Conceitos e acesso

Acesso. Cada conexão nasce limitada ao que a pessoa que autorizou pode fazer (para autorizar leitura do CRM, você precisa poder ler o CRM). Cada um gerencia as próprias conexões e chaves; quem administra a organização enxerga todas e pode revogar qualquer uma.

Primeiro uso: passo a passo

1. Abra a área MCP & API. Em Configurações, na aba MCP, está o endereço da sua organização e os botões dos assistentes.
2. Conecte o seu assistente. Clique no botão do Claude, do ChatGPT ou do Cursor: o endereço vai para a área de transferência e a tela do assistente abre no lugar certo para colar. Usando outro cliente MCP, copie o endereço e informe onde o seu cliente pedir.
3. Autorize com a sua conta. O assistente traz você de volta para uma tela do Hub que diz quem está pedindo acesso. Escolha Somente leitura para começar e confirme. Precisando de mais, use Personalizado e libere só o que aquele uso pede.
4. Teste com uma pergunta. Peça algo simples: “liste as minhas tarefas abertas no Hub” ou “quais negócios estão parados no funil?”. Se a resposta vier com os seus dados, está conectado.
5. Evolua para a escrita. Quando a leitura estiver redonda, autorize Operação nos apps em que isso faz sentido. Ampliar o acesso de uma conexão que já existe exige autorizar de novo pelo assistente: o vínculo antigo guarda o acesso do dia em que foi feito.

Checklist do primeiro uso: copiar o endereço, autorizar com o acesso de leitura, fazer uma pergunta sobre os seus dados e receber a resposta certa.

O que dá para fazer: exemplos reais

• Auditoria de atendimento. Peça ao seu assistente para varrer as conversas de WhatsApp das instâncias conectadas e levantar o que quiser: tempo de resposta, promessas feitas e não cumpridas, tom do atendimento, oportunidades perdidas. O que antes era ler conversa por conversa vira uma análise sob demanda.
• Cadastro em lote. Tem uma lista de clientes para entrar na base? A IA cadastra um a um pelo MCP: para empresas com CNPJ, os dados oficiais (razão social, endereço, quadro societário) chegam sozinhos, e os campos personalizados já entram preenchidos no cadastro.
• Leitura do comercial de onde você trabalha. Consulte negócios do CRM, tarefas do time e cadastros sem abrir o Hub: “resuma o funil desta semana”, “quais tarefas do projeto X estão atrasadas”, “quantos leads entraram por indicação”.
• Conhecimento que chega por proposta. A IA externa organiza um material e propõe páginas novas no Brain; o time revisa e aprova na Caixa de entrada. Nada entra na base da empresa sem um humano dizer sim.

Limites e erros comuns

Erros comuns de quem começa: autorizar tudo “para garantir” (comece com leitura; a escrita vem depois, quando o uso estiver claro), e esquecer conexões antigas ativas (revise a lista de vez em quando e revogue o que não usa mais, principalmente de quem saiu do time).

Próximo passo

• Marvin: dentro do Hub, a IA é ele: mesmo cérebro, zero configuração. O MCP é para quando o trabalho acontece fora.
• MDC: o caminho inverso: trazer dados de outros sistemas para dentro do Hub.
• Skills: o que a sua IA externa faz via MCP pode virar rotina padronizada com skills dentro do Hub.
• Membros e permissões: o alicerce do acesso; a conexão herda o que a pessoa pode, e acompanha as mudanças dela.