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:
- Permissões de tabela e de campo (quem pode visualizar, criar, editar, excluir), e a ordem em que os campos aparecem
- Funções: adicionar uma função, renomeá-la, definir a função Default (padrão) e apontar o portal para o campo do Airtable que guarda a função de cada usuário, para ativar o controle de acesso baseado em funções
- Filtros de registros e propriedade dos registros: se uma tabela fica restrita aos registros de cada usuário, e qual campo decide quem é o proprietário de um registro
- Filtragem de registros vinculados: limitar as opções de um campo de vínculo a registros específicos, ou a registros que correspondam a outro campo
- Abas de registros relacionados e quais tabelas aparecem como página própria
- O filtro, o ícone de menu e o endereço de uma página
- Configuração da visualização (tabela, galeria, kanban, calendário, perguntas frequentes), ordenação padrão, quais campos aparecem no resumo e quais na página do registro, e se os campos vazios são omitidos da página do registro
- Cores de linha que destacam os registros que atendem a uma regra
- Se os usuários do portal podem exportar uma página em CSV ou Excel e editar ou excluir vários registros de uma vez
- O layout da página do registro: seções, títulos, colunas e campos de largura total
- Os controles para filtrar, buscar e ordenar que os usuários do portal têm em uma tabela
- Os rótulos de uma tabela, como chamar um registro de “serviço” em vez de “registro”
- Mostrar uma duração calculada como
2:30em vez de um número de segundos - A página inicial em que os usuários do portal entram
- A identidade visual: cores do tema, e apontar para um logotipo ou favicon que já esteja hospedado
- Ler a sua configuração atual: portais, funções, permissões e a estrutura do Airtable conectado
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
Adicione um conector personalizado
Abra Settings (configurações), depois Connectors (conectores), e escolha adicionar um conector personalizado. Informe a URL do conector acima.
- 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
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
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.
Permissões e consentimento
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.