Conectar ao CollabPortals por MCP

Conecte o CollabPortals a um assistente de IA como o Claude ou o ChatGPT e configure os seus portais pedindo. O que ele faz, como adicioná-lo e como funcionam as permissões.

O CollabPortals tem um conector MCP, então você pode configurar os seus portais a partir de um assistente de IA, pedindo em linguagem natural, em vez de clicar pelas telas do painel de administração.

O MCP (Model Context Protocol) é um padrão aberto para conectar assistentes de IA a ferramentas externas. Como o conector é um servidor MCP padrão, ele funciona com qualquer assistente que aceite conectores MCP remotos, como o Claude e o ChatGPT. Você adiciona a mesma URL do conector no assistente que usar.

Depois de conectar, você pode dizer coisas como:

  • “No meu Portal de Clientes, oculta o campo Anotações Internas da função Cliente.”
  • “Adiciona um filtro de registros na tabela Projetos para cada cliente ver só os próprios projetos.”
  • “Mostra a tabela Faturas como uma aba dentro de cada registro de Cliente, em vez de uma página própria.”
  • “Quais funções e permissões estão configuradas no meu portal de Vendas agora?”

O assistente faz a alteração pelo conector, e ela aparece no seu portal exatamente como se você a tivesse feito no painel de administração.

O que o conector faz

O conector configura os portais que a sua conta já gerencia:

Toda alteração que ele faz é uma que você mesmo poderia fazer no painel, então você sempre pode revisá-la lá.

O que o conector não faz

O conector é limitado de propósito. Ele não pode:

  • Criar, duplicar ou excluir portais, nem excluir uma página. Faça isso no painel.

  • Configurar incorporações no registro ou o acompanhamento. Uma incorporação coloca a página de outro site dentro do seu portal, e o acompanhamento envia a atividade dos seus usuários ao Google, então os dois ficam no painel.

  • Alterar os registros dentro da sua base do Airtable. Ele configura o portal, não os seus dados.

  • Ler o histórico de atividades. Ele guarda os e-mails e os endereços IP dos seus usuários, então fica no painel.

  • Enviar um arquivo de logotipo ou de favicon, mudar como os usuários do portal fazem login (o método de login e o autocadastro), permitir que o portal seja incorporado em outros sites ou configurar um domínio personalizado. Essas tarefas ficam no painel. Ele pode apontar a identidade visual para a URL de uma imagem que já esteja hospedada, mas o envio em si acontece lá.

    O login e a incorporação ficam de fora pelo mesmo motivo: cada um decide quem pode chegar ao portal e em que condições, então quem muda isso é o administrador do portal, no painel, e não um assistente a pedido.

  • Mexer em qualquer portal fora da sua própria conta. Ele sempre age como você.

Algumas alterações de maior risco precisam da sua confirmação antes de o assistente fazê-las: mudar uma tabela para mostrar todos os registros (em vez de só os de cada usuário) e remover uma função. O assistente pergunta antes nos dois casos.

Como conectar

O conector é um servidor MCP padrão em uma única URL:

https://www.collabportals.com/api/mcp

Adicione essa URL como um conector personalizado no seu assistente, depois faça login no CollabPortals e aprove a tela de consentimento. Os menus exatos variam de um aplicativo para outro.

No Claude, que testamos de ponta a ponta:

  1. 1

    Adicione um conector personalizado

    Abra Settings (configurações), depois Connectors (conectores), e escolha adicionar um conector personalizado. Informe a URL do conector acima.

  2. 2

    Faça login no CollabPortals

    O Claude abre uma página do CollabPortals. Faça login com a sua conta do CollabPortals, se ainda não tiver feito login.

  3. 3

    Aprove a tela de consentimento

    A tela de consentimento, com o título Authorize (autorizar) e o nome do aplicativo, mostra a conta com a qual ele está se conectando e o que ele vai poder fazer. Leia-a e clique em Allow (permitir). Deny (negar) cancela sem conectar.

  4. 4

    Peça uma alteração

    O assistente está conectado. Peça a ele para fazer uma alteração em um dos seus portais e depois confira o resultado no painel de administração.

Outros clientes MCP (ChatGPT, Cursor e outros) seguem o mesmo fluxo: adicionar a URL, fazer login, aprovar a tela de consentimento. Se o seu login do CollabPortals ainda não estiver aberto no mesmo navegador, a etapa de consentimento pede que você faça login primeiro. Isso é esperado.

Ao aprovar o conector, você dá ao assistente acesso para configurar os seus portais existentes como se fosse você, e só os portais da sua conta. O acesso é:

  • Por usuário. A conexão fica vinculada à sua conta. Ela vê o que você pode ver e altera o que você pode alterar, nada além disso.
  • Restrito. Ele configura portais. Não lê nem grava os seus registros do Airtable, e não pode criar, duplicar ou excluir portais.
  • Revogável. Você pode desconectá-lo a qualquer momento nas configurações de conectores do seu assistente, e o acesso para de funcionar na hora.

A conexão usa um login OAuth padrão, o mesmo fluxo que você usa para conectar qualquer conta a outro aplicativo. O assistente nunca recebe a sua senha do CollabPortals, e nós nunca vemos as suas conversas com ele.

Se algo parecer errado

Toda alteração que o conector faz é uma que você mesmo poderia fazer no painel, então você sempre pode revisá-la e ajustá-la lá. Se uma alteração não for o que você queria, abra o portal no CollabPortals e volte a configuração ao que era.

Fale com a gente se tiver dúvidas ou se notar algo estranho com o conector.