Este tutorial instala o conector MCP da Laiki no Claude ou no ChatGPT. Com ele, você consulta leads, eventos, segmentos, campanhas e dashboards da sua conta direto na conversa, sem exportar planilha e sem sair do agente de IA que já usa no dia a dia.
Antes de começar
Você vai precisar de duas coisas: um plano do Claude ou do ChatGPT que permita conectores personalizados, e o acesso de login da sua conta Laiki. O processo leva poucos minutos e é feito uma única vez por dispositivo.
MCP (Model Context Protocol) é o padrão que permite ao agente de IA conversar com sistemas externos. O conector da Laiki é somente leitura na maior parte das ferramentas: o agente consulta os dados da sua conta, mas não altera configurações da plataforma sem a sua ação.
Vale entender por que isso difere de simplesmente colar uma planilha no chat. Uma planilha colada é uma foto de um momento, e alguém precisa exportar e atualizar esse arquivo toda vez que a pergunta muda. O conector consulta a fonte direto, então a resposta reflete o dado real da conta no momento da pergunta, sem esse trabalho de preparação.
Instalar no Claude
O passo a passo abaixo funciona tanto no aplicativo desktop do Claude quanto no claude.ai pelo navegador; a tela de Configurações é a mesma nos dois ambientes.
- Abra as Configurações do Claude. Clique no nome da sua conta, no canto inferior esquerdo da tela, e selecione Configurações no menu que se abre.
- Vá até a aba Conectores. Na coluna da esquerda das Configurações, dentro do bloco Personalizar, clique em Conectores. É onde ficam todas as integrações do Claude, as pré-construídas e as personalizadas.
- Clique em Adicionar → Adicionar conector personalizado. No topo direito da tela de Conectores, abra o botão Adicionar e escolha a segunda opção, Adicionar conector personalizado. A opção Navegar conectores lista apenas integrações prontas, e a Laiki não está nessa lista, por isso o caminho é o personalizado.
- Preencha o nome e a URL do servidor. No primeiro campo, escreva o nome que você quer ver na lista de conectores (recomendamos Laiki). No segundo campo, cole exatamente a URL:
https://app.laiki.co/api/mcp. Deixe os campos de Configurações avançadas (ID do Cliente OAuth e Client Secret OAuth) em branco, eles são opcionais e não são usados na conexão padrão da Laiki. Clique em Adicionar para concluir. - Autentique e ajuste as permissões. Ao adicionar, o Claude abre a tela de login da Laiki no navegador. Entre com o seu usuário e autorize o acesso. Feito isso, o conector aparece na lista já vinculado. Na tela do conector você controla o que o Claude pode fazer: as ferramentas somente leitura podem ficar em Sempre permitir, para que as consultas rodem sem interrupção a cada chamada. Requer aprovação faz o Claude pedir sua confirmação a cada uso da ferramenta, útil enquanto você está conhecendo a integração, mas em análises longas gera muitos cliques. Bloqueado desliga a ferramenta por completo.
Instalar no ChatGPT
- Abra as Configurações e vá até Apps & Conectores. Clique no ícone da sua conta, no canto inferior esquerdo da tela, e selecione Configurações.
- Ative o Modo Desenvolvedor. Dentro de Apps & Conectores, role até o final e clique em Configurações Avançadas. Ative a opção Modo Desenvolvedor, uma etapa necessária para adicionar conectores personalizados no ChatGPT. Se você usa o aplicativo desktop do ChatGPT, essa configuração precisa ser feita primeiro na versão web.
- Volte a Conectores e clique em Criar. O botão fica ao lado de Navegar Conectores, na mesma tela.
- Preencha nome, descrição e URL do servidor. Use Laiki como nome, uma descrição curta como “Acesso a leads, eventos, segmentos e dashboards da Laiki” e cole a mesma URL do conector:
https://app.laiki.co/api/mcp. - Autentique e confirme. O ChatGPT abre a tela de login da Laiki para autenticação OAuth. Entre com o seu usuário e autorize o acesso. Marque a opção de confiança no aplicativo quando solicitado, e clique em Criar.
- Use na conversa. No campo de mensagem, clique no ícone de + e selecione o conector Laiki na lista. A partir daí, qualquer pergunta na conversa já pode consultar os dados da sua conta.
Depois de instalar
Confirme que a conexão está de pé. Peça ao agente: “liste minhas organizações na Laiki”. Se voltar a lista de contas com os IDs, está tudo certo.
Guarde o org_id da conta que você mais usa. Toda consulta parte do org_id. Informá-lo logo no início da conversa evita rodadas desnecessárias de descoberta, principalmente se a sua Laiki tem mais de uma conta cadastrada.
Tenha o Data Knowledge Base da conta em mãos. É o documento que descreve funil, nomes de evento, campos personalizados e convenção de UTM. Sem ele, o agente adivinha a estrutura da conta e as conclusões ficam menos confiáveis. Peça o seu ao time da Laiki, caso ainda não tenha recebido.
Comece por uma pergunta simples. Exemplos: “quantos leads entraram este mês?”, “como está o funil dos últimos 30 dias?”, “qual o CPL por canal?”. Perguntas mais específicas, como cruzar segmentação com atribuição de mídia, rendem melhor depois que a conexão já está validada com um exemplo simples.
Refaça este processo em cada dispositivo. O conector é vinculado ao ambiente em que foi instalado. Se você usa o Claude ou o ChatGPT no computador do escritório e também no navegador de casa, repita os passos nos dois; não existe uma instalação única que cubra todos os dispositivos de uma vez.
Se algo não funcionar
Erro ao adicionar o conector costuma ser URL com espaço extra ou caractere colado errado. Digite a URL manualmente em vez de copiar de um documento formatado, que às vezes insere caracteres invisíveis junto do texto.
Conector vinculado mas sem responder. No Claude, use Desvincular na tela do conector e refaça o login. No ChatGPT, remova o conector em Apps & Conectores e adicione de novo. Na maioria dos casos, isso reinicia a sessão de autenticação e resolve.
Se persistir, fale com o time da Laiki em laiki.co.
O que fica depois da instalação
Com o conector ativo, o próximo passo natural é saber o que perguntar. O Guia de Prompts da Laiki traz 70 prompts prontos para copiar e colar, organizados por área e por fonte de dado, pensados exatamente para quem acabou de instalar o conector e ainda está descobrindo o que pedir. Para entender melhor como o MCP funciona por trás dessas perguntas, os artigos sobre o que é MCP e como o MCP da Laiki funciona detalham o mecanismo e os recursos reais por trás da conexão.
