.svg)
.svg)
.svg)
.svg)
.svg)
.svg)
.svg)
.svg)
Peça ao Claude para mostrar todos os usuários do seu plano Pro que se cadastraram no mês passado mas ainda não dispararam seu principal evento de ativação, e você tem a resposta em segundos. Sem SQL, sem filtros de dashboard, sem exports em CSV. É isso que o UserGuiding MCP Server oferece: uma conexão direta entre sua ferramenta de IA e os dados do produto que você já registra no UserGuiding.
Foi feito para times de produto, growth, vendas e suporte que querem consultar seus próprios usuários da mesma forma que falam sobre eles. Antes de uma renovação, puxe o histórico recente do cliente em um único prompt. Quando chega um ticket, puxe o perfil completo do usuário antes de responder. Quando quiser saber quais cohorts estão ativando e quais estão abandonando, pergunte em voz alta. Você pula o dashboard, pula os exports e recebe exatamente o usuário, o atributo ou o número que precisava.
Este post explica o que você pode fazer com ele, como conectar Claude, Cursor ou OpenAI Codex em menos de dois minutos, o catálogo completo de ferramentas e como o UserGuiding se compara a outras plataformas de adoção de produto em integração com IA.
Principais destaques
- O UserGuiding MCP Server conecta ferramentas de IA diretamente aos dados em tempo real do seu projeto UserGuiding, permitindo consultas em linguagem natural contra seus usuários, empresas, eventos e Knowledge Base, sem SQL nem exports.
- Funciona com Claude (Desktop e Claude.ai), Cursor, OpenAI Codex e qualquer outra ferramenta de IA compatível com MCP.
- 17 ferramentas disponíveis em cinco áreas de capacidade: gerenciamento de usuários, busca e analytics, rastreamento de eventos, consulta de empresas e gerenciamento de Knowledge Base.
- Disponível em todos os planos UserGuiding. Sem necessidade de ajuda de engenharia para configurar.
- O UserGuiding é uma das primeiras plataformas de adoção de produto a lançar um MCP Server em produção.
- Combina com o No-Code Event Tracking do UserGuiding para cobrir o stack de analytics que a maioria dos times paga para Amplitude, Heap ou Mixpanel. Rastreie eventos sem código e consulte-os em linguagem natural pelo MCP Server.
- Pegue sua API key em Panel > Settings > MCP & API, ou leia o guia completo de configuração na Knowledge Base.
O que é MCP?
MCP (Model Context Protocol) é um padrão aberto lançado pela Anthropic em 2024. Ele permite que assistentes de IA chamem serviços externos de forma estruturada e autenticada, parecido com a forma como um desenvolvedor chama uma API, mas mediado pelo modelo de IA. Em vez de colar dados em uma janela de chat ou montar integrações ad-hoc, a ferramenta de IA se conecta uma vez ao MCP Server e recebe um conjunto bem definido de ferramentas que pode invocar em seu nome.
Claude (Desktop e Claude.ai), Cursor e OpenAI Codex suportam MCP nativamente. Isso significa que qualquer MCP server que você conectar, incluindo o do UserGuiding, fica acessível em todos os seus fluxos de IA: sessões de código, pesquisa, perguntas sobre produto, preparação para demos e qualquer outra coisa que você use essas ferramentas para fazer.
O que você pode fazer com o UserGuiding MCP
O UserGuiding MCP Server transforma os dados de produto que você já registra em algo que você pode consultar de forma conversacional. Cinco casos de uso que os times já estão rodando.
Pesquisa de usuário sem SQL. Filtre seus usuários por qualquer atributo ou evento, combine critérios e segmente por cohort. Sem stack de filtros no dashboard, sem export em CSV. A IA escolhe automaticamente as ferramentas de busca certas.
"Mostre todos os usuários do plano Pro que se cadastraram nos últimos 30 dias e dispararam o evento export_csv pelo menos uma vez."Pesquisa pré-reunião para vendas. Antes de uma renovação ou de uma demo com um prospect, puxe tudo que o usuário já fez no seu produto: plano, data de cadastro, uso de funcionalidades, metas que alcançou, eventos que disparou nesta semana. Entre na reunião com contexto real em vez de perguntar "qual plano você está usando?"
"Busque user@acme.com. Qual é o plano dele, quando se cadastrou e o que fez no produto esta semana?"
Contexto de suporte. Quando chega um ticket, puxe o perfil completo do usuário e o histórico recente de interações em um único prompt. Corta aquelas 2 ou 3 trocas de mensagens que costumam começar com "qual plano você está usando?" e "quando você se cadastrou?"
"Puxe o perfil completo de user@example.com para eu ver o plano, as funcionalidades configuradas e a atividade recente."
Análise de ativação e onboarding. Compare cohorts, encontre diferenças de comportamento e identifique os passos do onboarding que separam usuários ativados dos que abandonam. Sem dashboard, sem segmentos salvos.
"Mostre os usuários que completaram nosso onboarding checklist versus os que pararam no passo 3. O que os que concluíram fizeram que os outros não fizeram?"
Sinais de expansão e churn. Encontre usuários cujos padrões de uso sugerem que estão prontos para fazer upgrade, ou usuários em planos pagos que estão ficando quietos. São leads que vendas e CS costumam perder porque ninguém sinalizou.
"Encontre usuários no plano Starter que dispararam o evento api_rate_limit_hit mais de dez vezes neste mês."Como configurar
A configuração leva dois minutos. Primeiro, pegue sua API key no painel do UserGuiding: Settings > Project Settings > MCP & API. Depois coloque o servidor na configuração MCP da sua ferramenta de IA.
Server URL:
https://mcp.userguiding.com/mcp/sse
Autenticação: passe sua API key como header (UG-API-KEY: <sua-api-key>) ou como parâmetro de query para ferramentas que não suportam headers customizados (?api_key=<sua-api-key>).
Claude Desktop
Edite claude_desktop_config.json:
{"mcpServers":{"userguiding":{"url":"https://mcp.userguiding.com/mcp/sse","headers":{"UG-API-KEY":"<sua-api-key>"}}}}
Cursor
Edite .cursor/mcp.json:
{"mcpServers":{"userguiding":{"url":"https://mcp.userguiding.com/mcp/sse","headers":{"UG-API-KEY":"<sua-api-key>"}}}}
OpenAI Codex
O Codex segue o mesmo formato de configuração MCP do Cursor. Coloque a entrada do servidor UserGuiding no seu mcp.json do Codex usando o JSON acima. Consulte a documentação atual do Codex MCP da OpenAI para o caminho exato do arquivo no seu sistema.
Para o guia completo de configuração multi-ferramenta, incluindo o fluxo de conector de administrador do Claude.ai e autenticação via query parameter, veja o artigo do UserGuiding MCP Server na Knowledge Base.
O que tem dentro: o catálogo completo de ferramentas
O UserGuiding MCP Server expõe 17 ferramentas em cinco áreas de capacidade. Cada uma é acionável em linguagem natural por qualquer assistente de IA compatível com MCP.
User Management
get_user: busca um usuário pelo ID. Retorna atributos, empresa e histórico de interações. Conecta-se a User Identification, Segmentation, Analytics.upsert_user: cria ou atualiza um usuário. Mescla atributos e opcionalmente vincula o usuário a uma empresa. Conecta-se a User Identification, Segmentation.delete_user: exclui um usuário permanentemente. Conecta-se a User Identification.reset_user_history: reseta o histórico de interações de um usuário mantendo os atributos customizados. Conecta-se a Guides, Checklists, Surveys, Hotspots, Resource Centers.list_users: lista todos os usuários com paginação por cursor. Conecta-se a User Identification, Segmentation.
Search and Analytics
search_users: busca e filtra usuários por atributos ou eventos. Conecta-se a Segmentation, Analytics.get_user_count: conta usuários que correspondem a filtros sem trazer os registros completos. Conecta-se a Segmentation, Analytics.list_attributes: descobre todos os atributos de usuário disponíveis e seus tipos de dados. Conecta-se a User Identification, Segmentation.list_events: descobre todos os nomes de eventos rastreados no seu projeto. Conecta-se a Analytics, No-Code Analytics, Custom Alerts.
Events
track_event: registra um evento nomeado para um usuário, opcionalmente com metadados. Conecta-se a Analytics, No-Code Analytics, Custom Alerts, Segmentation.
Companies
get_company: busca uma empresa pelo ID. Retorna atributos e IDs dos usuários membros. Conecta-se a Segmentation, account-level targeting.list_companies: lista e filtra empresas com paginação e ordenação. Conecta-se a Segmentation, account-level targeting.
Knowledge Base
search_kb_articles: busca artigos da Knowledge Base por consulta de texto. Retorna IDs, títulos, descrições e categorias. Conecta-se a Knowledge Base.get_kb_article: recupera o conteúdo completo de um artigo da Knowledge Base pelo ID, incluindo título, corpo, status e locales. Conecta-se a Knowledge Base.create_kb_article: cria um novo artigo da Knowledge Base com título, conteúdo e descrição opcional. Conecta-se a Knowledge Base.update_kb_article: atualiza o título ou conteúdo de um artigo existente da Knowledge Base pelo ID. Conecta-se a Knowledge Base.delete_kb_article: exclui permanentemente um artigo da Knowledge Base pelo ID. Conecta-se a Knowledge Base.
Você pode combinar várias ferramentas em um único prompt. O assistente de IA escolhe as ferramentas certas para responder à sua pergunta.
Veja funcionando
O exemplo da seção anterior saiu de uma terça-feira de verdade. Nosso CTO conectou o UserGuiding MCP Server ao Claude, rodou a consulta dos dez prospects nos nossos próprios usuários e publicou o resultado no LinkedIn. As reações e respostas valem a leitura se você quer ver como outros times de produto, vendas e growth já estão pensando sobre acesso nativo de IA aos dados de produto. O post abaixo tem o contexto completo.
A dupla com o No-Code Analytics
O MCP Server fica ainda mais interessante quando combinado com o No-Code Event Tracking do UserGuiding. Aponte e clique em elementos do seu produto para começar a capturar eventos. Sem código, sem tempo de engenharia, sem SDK novo para instalar. Depois consulte esses eventos pelo MCP Server usando a mesma frase que você usaria para descrever a pergunta em voz alta.
Para a maioria dos times de produto, growth e CS, essa combinação substitui um stack que antes era Amplitude, Heap ou Mixpanel para rastreamento de eventos mais uma ferramenta de analytics separada para exploração. No UserGuiding, a captura de eventos fica na mesma plataforma que seu onboarding, seus checklists e sua Knowledge Base, e o MCP Server transforma product analytics em uma interface de chat dentro do Claude, Cursor ou Codex.
O resultado: product analytics sem analista dedicado, sem contrato de analytics separado e sem backlog de engenharia.
Como o MCP do UserGuiding se compara
Em abril de 2026, nenhuma outra grande plataforma de adoção digital lançou um MCP Server. Verificamos Appcues, Pendo, WalkMe, Whatfix, Userpilot e Chameleon: nenhuma expõe dados de produto para ferramentas de IA via MCP hoje. Isso faz do UserGuiding uma das primeiras plataformas de adoção de produto a lançar uma integração MCP em produção, e a primeira que conhecemos com acesso completo de leitura e escrita para usuários, empresas, eventos e Knowledge Base.
A diferença prática:
- Acesso de dados nativo para IA. UserGuiding: MCP Server com suporte a leitura e escrita. Outras plataformas: sem suporte a MCP no momento da publicação.
- Profundidade de interação. UserGuiding: eventos individuais de guides, checklists, surveys e hotspots com timestamps. Outras plataformas: normalmente contagens agregadas.
- Configuração sem código. UserGuiding: conecte pelas configurações de connector do claude.ai ou por um arquivo JSON. Outras plataformas: não disponível.
- Consultas em linguagem natural. UserGuiding: pergunte sobre usuários em português comum. Outras plataformas: filtros de dashboard ou SQL.
- Dados em tempo real. UserGuiding: consultas refletem o estado atual. Outras plataformas: exports em batch são comuns.
Isso não faz do MCP a única forma de trabalhar com dados de produto. Dashboards continuam mais rápidos para olhar gráficos de relance, e SQL continua sendo a ferramenta certa para analytics profundo. O que muda é o meio-termo: aquelas perguntas ad-hoc que antes significavam puxar um filtro ou abrir um notebook agora acontecem direto na ferramenta de IA que você já está usando.
Comece agora
Começar leva uma API key e poucas linhas de configuração. Encontre a key em Panel > Settings > MCP & API, coloque o servidor na configuração da sua ferramenta de IA e faça sua primeira pergunta. Para a referência completa de configuração, incluindo o fluxo de conector de administrador do Claude.ai e exemplos de sintaxe de filtros, veja o artigo do UserGuiding MCP Server na Knowledge Base.
Perguntas Frequentes
Funciona com ChatGPT ou outras ferramentas de IA?
O suporte a MCP é nativo atualmente no Claude (Desktop e Claude.ai), Cursor e OpenAI Codex. ChatGPT e Gemini não suportam MCP nativamente em abril de 2026. Qualquer ferramenta que adotar MCP como transporte poderá se conectar ao UserGuiding Server sem necessidade de configuração adicional do nosso lado.
Os dados são em tempo real?
Sim. As consultas MCP acessam o banco de dados ao vivo do UserGuiding, não um export cacheado. Se um usuário disparou um evento 30 segundos atrás, sua ferramenta de IA já vê.
E a privacidade dos dados?
Os dados permanecem no seu projeto UserGuiding. A ferramenta de IA envia consultas ao UserGuiding MCP Server e recebe os resultados. Nenhum export em massa ou armazenamento acontece do lado da IA.
Usuários podem quebrar algo com operações de escrita?
As ferramentas de escrita (upsert_user, track_event, delete_user, reset_user_history e as ferramentas de criar/atualizar/excluir artigos da KB) usam a mesma API key das ferramentas de leitura. Trate a key como qualquer credencial de administrador: compartilhe com cuidado. Uso somente de leitura (search, get, list) é seguro em qualquer cenário.
Precisamos de ajuda de engenharia para configurar?
Não. É uma conexão que você habilita nas configurações da sua ferramenta de IA. O tempo total de configuração é cerca de dois minutos.
Quais planos incluem MCP?
O MCP está disponível em todos os planos UserGuiding.
Como isso se compara a Amplitude, Heap ou Mixpanel?
Amplitude, Heap e Mixpanel são plataformas de product analytics com seus próprios SDKs de rastreamento de eventos e interfaces de consulta. O No-Code Event Tracking do UserGuiding captura os mesmos tipos de eventos de usuário sem código ou ajuda de engenharia, e o MCP Server permite consultá-los em linguagem natural em vez de construir dashboards. Para times de produto, growth e CS que querem analytics sem um analista dedicado, ele substitui um contrato separado de analytics por algo que já está no seu plano UserGuiding.
.png)
