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, 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.

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ê cria uma conexão no Hub, escolhe o assistente e o acesso, leva a URL do servidor daquela conexão para o assistente e autoriza com a sua conta Marvee. Feito isso, o assistente enxerga e opera o Hub, limitado ao que você autorizou.

A conexão é sempre sua, individual. Cada pessoa cria a própria conexão, e cada conexão nasce com uma URL exclusiva. Duas pessoas conectadas ao mesmo assistente 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:

• Uma conexão por assistente, com URL exclusiva, em Configurações › Desenvolvimento › MCP, no mesmo grupo de Visão geral e API. Em Nova conexão, o seletor Assistente oferece Claude, Codex, Grok Bot e Outro cliente MCP, e a janela mostra o Nome e a URL do servidor para levar ao assistente.
• Autorização com a sua conta, na hora de conectar: a página Vincular a conexão mostra a conexão, a organização e o que você está concedendo, antes de valer.
• Acesso escolhido na criação, em Acesso do assistente: Acompanhar meus acessos do Hub usa os seus acessos atuais e futuros naquela organização; Personalizar acesso abre os atalhos Somente leitura, Operação e Personalizado, este com o nível app por app. As ações que pedem a sua confirmação continuam pedindo autorização antes de executar.
• Lista de quem conectou o quê, em Conexões MCP, agrupada por pessoa, com a situação e a última chamada de cada conexão, busca e revogação. Quem administra a organização enxerga as conexões de todos e pode revogar a de um colega; a URL da conexão, essa, 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 encolher 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 no campo Expira em e a documentação das APIs do Hub na mesma tela. A chave secreta aparece uma vez, na criação.

Conceitos e acesso

Acesso. Cada conexão nasce limitada ao que a pessoa que a criou pode fazer (para liberar 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.

Instalação antiga. Quem conectou um assistente pelo endereço genérico de antes vê o aviso Atualize esta instalação na janela da conexão: troque, no assistente, a URL genérica pela URL exclusiva daquela conexão.

Primeiro uso: passo a passo

O passo a passo completo, com guia em vídeo, está em Conectar o Marvee Hub ao Claude. Em resumo:

1. Crie a conexão em Configurações › Desenvolvimento › MCP, com Nova conexão: escolha o assistente e o acesso.
2. Adicione ao assistente o Nome e a URL do servidor que a janela mostra.
3. Autorize e teste: autorize com a sua conta na página do Hub e mande o pedido de teste ao assistente; a conexão passa a Confirmada.

Para outro assistente, o caminho é o mesmo: escolha o assistente em Assistente (ou Outro cliente MCP) e use a URL do servidor da conexão onde o seu cliente pedir.

Checklist do primeiro uso: criar a conexão com acesso de leitura, levar a URL ao assistente, autorizar, 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

• Conectar o Marvee Hub ao Claude: o passo a passo com guia em vídeo, da conexão criada ao teste confirmado.
• 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.