Guia do Usuário do Servidor MCP

Conecte suas ferramentas de IA diretamente ao seu projeto UserGuiding por meio do Servidor MCP. Uma vez conectadas, ferramentas como Claude, Cursor, OpenAI Codex ou qualquer assistente compatível com MCP podem analisar o uso do produto, pesquisar usuários e empresas, criar segmentos, ler resultados de pesquisas, gerenciar artigos da Base de Conhecimento e publicações de Atualizações de Produto, além de moderar seu roadmap público, tudo por meio de linguagem natural.

O MCP está disponível em todos os planos UserGuiding e leva cerca de dois minutos para ser configurado. Não é necessária ajuda de um desenvolvedor.

Como funciona

O MCP (Model Context Protocol) é um padrão aberto lançado pela Anthropic em 2024 que permite que ferramentas de IA acessem serviços externos de forma estruturada e autenticada. Em vez de colar dados em uma janela de bate-papo ou configurar integrações ad hoc, a ferramenta de IA se conecta uma única vez a um servidor MCP e obtém um conjunto bem definido de ferramentas que pode invocar em seu nome.

   AI tools (Claude, Cursor, OpenAI Codex, and others)
        |
        |  Streamable HTTP + JSON-RPC
        v
   UserGuiding MCP Server  (US or EU)
        |
        |  OAuth sign-in, scoped to one project
        v
   Your UserGuiding project data

É importante saber duas coisas de antemão:

• A conexão está vinculada a um projeto específico. Você o escolhe ao fazer login, e nenhum argumento da ferramenta pode direcionar o assistente para um projeto diferente ou outra conta.
• Existe um servidor para cada região de dados. Contas dos EUA usam https://mcp.userguiding.com/mcp/ e contas da UE usam https://eu-mcp.userguiding.com/mcp/ . O painel mostra o servidor correto para a sua conta.

O que você pode fazer com o UserGuiding MCP

O servidor MCP transforma os dados de produtos que você já rastreia em algo que você pode consultar de forma conversacional.

Análise de produtos sem dashboards. Resumos de engajamento, funis de conversão, adoção de recursos, retenção de coortes e conclusão de metas, tudo em uma frase.

"Mostre-me o funil de etapas do guia de integração dos últimos 90 dias. Onde as pessoas desistem?"

Pesquisa de usuários sem SQL. Filtre usuários por qualquer atributo ou evento, combine critérios e salve o resultado como um segmento.

"Crie um segmento para usuários do plano Pro que se inscreveram nos últimos 30 dias e acionaram o evento export_csv pelo menos uma vez."

Pesquisa prévia para as equipes de vendas e atendimento ao cliente. Antes de uma ligação para renovação, reúna todas as informações sobre a conta: plano, data de inscrição, uso de recursos, membros ativos e se o uso está diminuindo em comparação com o mês anterior.

"Qual é o nível de engajamento da Acme Corp neste mês em comparação com o mês passado? Eles estão ficando mais quietos?"

Contexto de suporte em uma única mensagem. Perfil completo e histórico de interações recentes, além do artigo de ajuda para enviar de volta.

"Obtenha o perfil completo do usuário [email protected] e, em seguida, encontre o melhor artigo da base de conhecimento sobre a configuração de SSO."

Operações de conteúdo. Redija e atualize artigos da Base de Conhecimento mantendo seu estilo habitual, reorganize categorias, escreva posts sobre atualizações de produtos e limpe a caixa de entrada de solicitações de recursos.

"Leia nossas últimas cinco postagens sobre atualizações de produtos e, em seguida, escreva uma sobre os novos filtros do painel, no mesmo tom."

Mais instruções para copiar: Casos de uso e exemplos de instruções do Guia do Usuário MCP .

Começando

• Passo 1. No painel, acesse Configurações > Configurações do Projeto > MCP e Chave de API e copie a URL do servidor exibida. Ela já corresponde à sua região de dados.
• Passo 2. Adicione-o ao seu assistente como um conector personalizado ou servidor MCP. A mesma página contém trechos de código prontos para colar para Claude Code, Codex CLI, Cursor e outros clientes JSON-config.
• Passo 3. Conecte-se. Seu navegador abrirá uma página de login do UserGuiding, você selecionará o projeto ao qual o assistente poderá ter acesso e aprovará as permissões solicitadas.

Instruções completas, incluindo configuração da chave de API e resolução de problemas: Configurando o servidor UserGuiding MCP .

Está atualizando de uma configuração antiga? O servidor agora utiliza Streamable HTTP em /mcp/ . Os endpoints legados de Eventos Enviados pelo Servidor ( /mcp/sse e /mcp/messages ) foram desativados e respondem com o código 410 Gone , portanto, atualize a URL no seu cliente. A autenticação por chave de API ainda funciona, mas está sendo substituída pelo OAuth.

Ferramentas disponíveis

O servidor MCP disponibiliza 58 ferramentas em nove áreas. Você nunca as chama pelo nome: você faz uma pergunta e o assistente seleciona as ferramentas, muitas vezes encadeando várias para responder a uma única solicitação.

• Usuários e atributos. Consulte, pesquise, conte, crie, atualize e exclua usuários, leia o feed de atividades brutos deles e descubra quais atributos e eventos seu projeto possui.
• Análise de eventos e produtos. Contagem de eventos, séries temporais com intervalos de dia, semana ou mês, adoção de recursos com índice de fidelização e matrizes de retenção de coortes.
• Segmentos. Liste segmentos, crie e atualize-os a partir de uma descrição em linguagem simples, veja o que os membros de um segmento realmente fizeram e veja o desempenho dos materiais direcionados a um segmento.
• Empresas. Perfis de empresas, listas filtradas e nível de engajamento da conta com comparação ao período anterior.
• Análise de materiais. Visão geral do projeto, desempenho por material, funis de etapas do guia, progresso do guia por usuário, estatísticas de itens da lista de verificação, estatísticas de pontos de acesso, cliques em botões de banner, visualizações de guias da central de recursos e conclusões de metas.
• Pesquisas. Um relatório completo da pesquisa com distribuição de pontuações e taxas de abandono, além de respostas individuais para leitura de respostas em texto livre.
• Base de conhecimento. Pesquise e leia artigos, crie e atualize-os, gerencie categorias e subcategorias, mova artigos em massa e detecte em qual plataforma um centro de ajuda existente está sendo executado antes de uma migração.
• Atualizações de produtos. Liste, crie, atualize e exclua publicações, com etiquetas e conteúdo por idioma.
• Roteiro e solicitações de recursos. Visão geral da contagem de solicitações, solicitações pendentes e aprovadas com contagem de votos em tempo real, o quadro público e a opção de aprovar ou rejeitar ações.

Todas as ferramentas, o que elas retornam e as permissões necessárias: Guia do Usuário: Referência da Ferramenta MCP .

Permissões e segurança

• Acesso com escopo definido. Uma conexão OAuth carrega apenas as permissões que você aprova, desde users:read até roadmap:write . Uma ferramenta fora desses escopos é recusada, portanto, uma conexão somente leitura permanece somente leitura.
• Um projeto, sempre. O projeto é fixo quando você se conecta. O acesso entre projetos e entre contas não é possível.
• Nada é publicado automaticamente. Artigos da Base de Conhecimento e posts de Atualizações de Produto escritos pelo MCP são salvos como rascunhos. Uma pessoa com permissão de publicação ainda precisa clicar em Publicar no painel.
• Tudo é registrado. As chamadas de ferramentas são retidas por aproximadamente três meses, e as gravações aparecem no Registro de Atividades do painel com o nome do usuário do painel que está conectado.
• Medidas de segurança na análise. Os intervalos de datas são limitados a um ano, o projeto tem uma taxa de processamento limitada a 60 chamadas de ferramentas por minuto e solicitações com dados excessivos são rejeitadas com uma explicação, em vez de serem respondidas com dados simplesmente cortados.

Emparelhamento com rastreamento de eventos sem código

O MCP Server integra-se perfeitamente com o recurso de Rastreamento de Eventos Sem Código da UserGuiding. Basta apontar e clicar em elementos do seu produto para começar a capturar eventos, sem código, sem tempo de engenharia e sem novo SDK. Em seguida, consulte esses eventos por meio do MCP Server em linguagem natural.

Para a maioria das equipes de produto, crescimento e sucesso do cliente, essa combinação substitui uma estrutura que antes exigia um produto de análise separado para rastreamento de eventos, além de outra ferramenta para exploração. A captura de eventos reside na mesma plataforma que seu processo de integração, suas listas de verificação e sua Base de Conhecimento, e o Servidor MCP transforma a análise de produtos em uma interface de bate-papo dentro do Claude, Cursor ou Codex.

Perguntas frequentes

Quais planos incluem o MCP? Todos os planos UserGuiding.

Precisamos de ajuda técnica para configurar? Não. É uma conexão que você habilita nas configurações da sua ferramenta de IA. O tempo total de configuração é de aproximadamente dois minutos.

Qual URL de servidor devemos usar? A que é exibida em Configurações > Configurações do Projeto >

MCP e Chave de API . Ela define a região dos seus dados: mcp.userguiding.com para contas dos EUA e eu-mcp.userguiding.com para contas da UE.

O servidor da UE funciona da mesma forma? Sim. Ambas as regiões compartilham um serviço de login, mas os tokens são vinculados à região e cada servidor aceita apenas os seus próprios. É isso que mantém os dados da UE dentro do ambiente da UE. Uma conta da UE apontando para um URL dos EUA falha na verificação do token em vez de ler silenciosamente os dados incorretos.

Minha conexão parou de funcionar após uma atualização. Configurações antigas usavam o endpoint de Eventos Enviados pelo Servidor (Server-Sent Events), que foi desativado. Altere o URL para terminar em /mcp/ e tente reconectar.

Devemos usar OAuth ou uma chave de API? OAuth, para qualquer novidade. Ele nunca coloca um segredo em um arquivo de configuração, permite conceder apenas as permissões necessárias e identifica o usuário do painel por trás de cada gravação no seu Registro de Atividades. As chaves de API ainda funcionam, mas estão sendo descontinuadas.

A que dados o servidor MCP pode aceder? Apenas ao projeto que selecionou ao ligar-se e apenas dentro das permissões que aprovou.

A conexão é segura? Sim. Toda a comunicação é feita via HTTPS, cada solicitação é autenticada e os tokens de acesso têm curta duração e são renovados automaticamente.

E quanto à privacidade dos dados? Os dados permanecem no seu projeto UserGuiding. A ferramenta de IA envia consultas e recebe resultados. Não há exportação ou armazenamento em massa por parte da IA.

Os dados são em tempo real? Sim, para consultas de usuários, empresas e materiais. A visão geral de todo o projeto exibe as mesmas métricas diárias pré-agregadas do painel, portanto, os números de hoje aparecem assim que o resumo diário for executado.

Funciona com o ChatGPT ou outras ferramentas de IA? Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP pode se conectar. Claude (web, desktop e Claude Code), Cursor e OpenAI Codex são compatíveis atualmente. Para outras ferramentas, verifique se elas suportam conectores MCP personalizados ou remotos.

É possível causar danos com operações de escrita? Somente dentro dos escopos que você aprovou. Quatro ferramentas são irreversíveis ( delete_user , reset_user_history , delete_kb_article e delete_product_updates_post ) e estão marcadas como destrutivas, portanto, os assistentes devem confirmar antes de executá-las. Se uma conexão for apenas para análise, aprove os escopos de leitura e nada mais.

Existe um limite de taxa? Sim, 60 chamadas de ferramentas por minuto por projeto, compartilhadas entre todas as conexões desse projeto.