Conectar o Marvee Hub ao Claude

Disponível a partir do plano Colaborador

Conectar um assistente de IA é recurso do assento Colaborador e dos planos acima dele. O assento de entrada não o inclui.

O Hub fala o padrão aberto que permite a assistentes de IA usarem outros sistemas como ferramentas. Este guia é o caminho específico do Claude: como criar a conexão no Hub, onde colar os dados no Claude, o que autorizar, como saber que funcionou e o que fazer com isso depois. Para entender o modelo de acesso por trás, veja MCP: o Hub nas mãos da sua IA.

Antes de começar

• Sua conta no Hub precisa ser de assento Colaborador ou acima.
• O e-mail da sua conta precisa estar confirmado. Sem isso, a área de Desenvolvimento mostra Confirme seu e-mail para liberar chaves de API e conexões MCP, com o botão Confirmar e-mail.
• Você precisa de uma conta no Claude. Qualquer plano pago serve.
• Decida qual acesso você vai conceder. Na dúvida, comece com leitura: a escrita vem depois, quando o uso estiver claro.

Uma coisa que economiza confusão mais tarde: cada conexão é sua e tem endereço próprio. Você cria a conexão no Hub, e ela nasce com uma URL exclusiva, que só vale para ela. Ninguém herda o acesso de ninguém, e a conexão nunca pode mais do que você mesmo pode fazer no Hub.

Uma conexão do Claude serve para todos os lugares onde você usa o Claude: o site, o app de desktop, o celular e o Claude Code, no terminal.

Passo 1: crie a conexão no Hub

1. No Hub, abra Configurações e, em Desenvolvimento, vá em MCP. A tela lista as Conexões MCP.
2. Clique em Nova conexão. Abre a janela Conectar um assistente.
3. Em Assistente, deixe Claude.
4. Em Nome da conexão, o Hub sugere “Claude · nome da organização”. Troque se quiser: é por ele que você reconhece a conexão na lista.
5. Em Acesso do assistente, escolha como a conexão alcança o Hub (veja a tabela abaixo). Ao escolher Personalizar acesso, a janela abre os atalhos de Acesso, com Somente leitura marcado.
6. Clique em Criar e continuar. O Hub avisa “Conexão criada. Vamos conectar o assistente.” e a janela passa às etapas de instalação.

Acesso do assistente	O que permite	Quando usar
Acompanhar meus acessos do Hub	Usa os seus acessos atuais e futuros na organização. Se você perder uma permissão, o assistente também perde	Quando você quer que o Claude possa o mesmo que você, sem refazer a autorização a cada acesso novo
Personalizar acesso	Você escolhe os apps e as ações. Dentro dele há três atalhos: Somente leitura (consulta, sem escrever nada), Operação (leitura e escrita, incluindo as ações sensíveis, que a tela lista pelo nome) e Personalizado (uma linha por app, com ajuste fino ação por ação)	Quando o uso é específico, ou quando você quer começar só lendo

Nos dois casos, as ações que exigem a sua confirmação continuam pedindo autorização antes de executar.

Passo 2: adicione o Hub ao Claude

A janela passa a mostrar três etapas: Adicionar, Autorizar e Testar. Na primeira, o Hub mostra os dados que o Claude pede.

Onde você usa	Como adicionar
Claude no site, no app de desktop ou no celular	Use Abrir conectores do Claude, escolha adicionar um conector personalizado e preencha com o Nome e a URL do servidor que a janela mostra. Cada um tem o seu botão de copiar
Claude Code, no terminal	Copie o comando do campo Claude Code e rode no terminal. Ele já leva o nome e a URL da conexão

Pronto de um lado, clique em Já adicionei ao assistente.

Passo 3: autorize com a sua conta

1. No Claude, abra o conector com o nome da conexão e escolha conectar. No Claude Code, digite /mcp e selecione a conexão para autenticar.
2. O Claude leva você a uma página do Hub, Vincular a conexão, que mostra o nome da conexão, a organização e o acesso que você escolheu no passo 1.
3. Confira a organização e clique em Autorizar acesso.
4. De volta à janela do Hub, clique em Verificar autorização.

Se o Hub não recebeu nada, ele avisa na própria janela. O motivo mais comum é a URL colada pela metade: confira e escolha conectar de novo.

Passo 4: confirme que funcionou

Na etapa Testar, o Hub mostra um pedido pronto para você mandar ao Claude (use Copiar pedido de teste). A confirmação aparece sozinha na janela, com Tudo pronto em e o nome da organização. Não precisa ser esse pedido: a primeira chamada que o Claude fizer ao Hub pela conexão já confirma, e a situação da conexão passa a Confirmada.

Depois, faça uma pergunta simples, cuja resposta você já conhece:

Liste as minhas tarefas abertas no Hub.

Ou:

Quais negócios estão parados no funil há mais de duas semanas?

Se a resposta vier com os seus dados de verdade, está conectado. Se vier vazia ou genérica, confira se você autorizou os apps que a pergunta usa.

Checklist: conexão criada em Configurações > MCP, conector adicionado no Claude com a URL da conexão, Autorizar acesso feito na página do Hub, situação Confirmada na lista e uma pergunta respondida com dados reais.

O que a situação da conexão quer dizer

A lista de Conexões MCP mostra a situação de cada uma:

Situação	O que significa	O que fazer
Aguardando instalação	A conexão existe, mas ainda não foi adicionada ao Claude	Abra a conexão e siga a etapa Adicionar
Autorizada · falta confirmar	Você autorizou, e o Claude ainda não fez nenhuma chamada por esta autorização	Faça qualquer pedido ao Claude que use o Hub
Confirmada	O Claude já usou a conexão com sucesso	Nada. Está pronta
Autorizar novamente	O vínculo precisa ser refeito	Abra a conexão e autorize de novo pelo Claude
Última chamada falhou	A conexão existe, mas a chamada mais recente não deu certo	Faça um novo teste

O que dá para fazer

O valor não está em conversar com o Hub, está no trabalho que fica barato quando ele fica ao alcance de uma pergunta. Os casos abaixo são todos possíveis hoje.

Ler a empresa sem abrir a empresa

• “Resuma o funil desta semana: quanto entrou, quanto avançou, quanto travou e onde.”
• “Quais tarefas do projeto do cliente X estão atrasadas, e de quem são?”
• “Quantos clientes novos entraram por indicação nos últimos três meses?”

É a consulta que você faria em três telas, feita em uma pergunta, e no formato que você pediu.

Auditar o atendimento

Peça ao Claude para varrer as conversas de WhatsApp das conexões ativas e levantar o que interessa: tempo de resposta, promessa feita e não cumprida, tom do atendimento, oportunidade que passou batido.

• “Nas conversas dos últimos quinze dias, liste toda promessa de retorno que não teve resposta depois.”

O que antes era ler conversa por conversa vira uma análise sob demanda.

Cadastrar em lote

Tem uma lista de clientes para entrar na base? O Claude cadastra um a um. Para empresa com CNPJ, os dados oficiais chegam sozinhos: razão social, endereço, quadro societário, situação cadastral. Os campos personalizados já entram preenchidos.

Uma disciplina que vale sempre: peça três primeiro e confira na tela. Só depois libere o resto da lista.

Preparar reunião e escrever o depois

• “Monte um resumo do cliente X: histórico, negócios, últimas conversas e o que está em aberto.”
• “Com base nisso, escreva a pauta da reunião de amanhã.”

Depois da reunião, o caminho inverso: o que foi combinado vira tarefa com responsável e prazo.

Organizar conhecimento com revisão humana

O Claude pode organizar um material e propor páginas no Brain. A proposta espera aprovação na Caixa de entrada: nada entra na base de conhecimento da empresa sem alguém dizer sim.

Cruzar o Hub com o que está fora dele

O Claude enxerga o Hub e também os arquivos e sistemas que você já usa com ele. Isso abre a análise que nenhuma tela sozinha faz: comparar uma planilha que você recebeu com a base do Hub, conferir uma lista externa contra os cadastros, apontar o que divergiu.

Limites e erros comuns

Expectativa	Realidade hoje
Conectar dá acesso a tudo	A conexão faz só o que você autorizou, e nunca mais do que você pode fazer no Hub
O Claude altera o conhecimento do Brain direto	Ele propõe, e a proposta espera aprovação humana
Todos os apps do Hub estão ao alcance do Claude	Os apps disponíveis variam conforme o que está habilitado na sua organização. Pergunte ao Claude quais ferramentas ele tem, e ele lista
Criar campo personalizado conversando	A definição do campo é criada na tela de Cadastros. Pelo Claude você consulta os campos que existem e preenche valores, inclusive em lote
Ampliar o acesso de uma conexão já feita vale na hora	Depende do acesso escolhido. Em Acompanhar meus acessos do Hub, o que você ganhar no Hub chega ao Claude sem autorizar de novo. Em Personalizar acesso, um acesso a mais pode exigir nova autorização pelo Claude
Um endereço só serve para o time todo	Cada conexão tem a sua URL exclusiva. Uma URL genérica antiga não aceita autorização nova: a própria conexão avisa em Atualize esta instalação, e o caminho é trocar pela URL da conexão
Reautorizar mantém a conexão como confirmada	Depois de uma autorização nova, a situação volta a Autorizada · falta confirmar até a primeira chamada por ela
Resposta confiante significa ação executada	Peça a confirmação por leitura: “me mostre o registro como ele está agora”. É o hábito que evita a maior parte dos sustos

Erros comuns de quem começa: autorizar tudo para garantir (na dúvida, comece com leitura), e esquecer conexão antiga ativa. Revise a lista de conexões de vez em quando e use Revogar no que não usa, principalmente de quem saiu do time. Uma conexão revogada perde o acesso na hora, e para reconectar é preciso criar outra.

Como saber quais apps o Claude alcança

Vale como primeira pergunta de qualquer trabalho novo:

Quais ferramentas do Hub você tem disponíveis? Agrupe por app e me diga quantas são de cada.

A resposta é a lista real do que ele consegue fazer na sua organização, e evita você pedir por meia hora uma coisa que aquele acesso não alcança.

Próximo passo

• Marvin: dentro do Hub, a IA é ele, com o mesmo cérebro e zero configuração. O Claude é para quando o trabalho acontece fora.
• Skills: o que você faz repetidamente pelo Claude pode virar rotina padronizada dentro do Hub.
• Chave de API: para script e integração escrita pelo seu time técnico, o caminho é a chave, não a conexão do assistente.
• Limitar o alcance de uma chave de API do MDC: o mesmo cuidado de acesso, aplicado à chave do gateway do MDC, que é outra chave, diferente da chave de API do Hub.