Kubit MCP Server

oficial

Integre o Kubit ao seu fluxo de trabalho de IA - consulte seu warehouse com linguagem natural

Documentação

Kubit MCP Server

Análise nativa do warehouse encontra IA conversacional

Traga todo o poder do Kubit diretamente para o seu fluxo de trabalho de IA. Consulte, analise e explore seu data warehouse através de linguagem natural — sem necessidade de sintaxe complexa.

O que é o Kubit MCP?

O servidor Kubit MCP (Model Context Protocol) transforma a forma como as equipes interagem com sua plataforma de análise. Ao conectar seu assistente de IA ao Kubit, você pode:

Explorar esquemas - Descubra eventos, propriedades e dimensões em linguagem natural
Gerar relatórios - Crie consultas analíticas através de conversas
Exportar dados - Extraia dados brutos em formato CSV para análise aprofundada
Pesquisar conteúdo - Encontre relatórios e dashboards existentes instantaneamente
Fazer perguntas - Obtenha insights sem aprender sintaxe de consulta

Aviso Beta

Este servidor está em desenvolvimento ativo. Você pode encontrar bugs, problemas de desempenho ou limites de taxa enquanto continuamos a melhorar a plataforma.

Início Rápido

O Que Você Vai Precisar

Requisito	Descrição
Conta Kubit	Acesso ativo a uma organização Kubit
Cliente de IA	Ferramenta compatível com MCP (Claude, Cursor, etc.)
Permissões	Acesso ao esquema no seu espaço de trabalho Kubit

Passos de Conexão

Configurar o servidor Kubit MCP é simples:

Adicione o servidor MCP à configuração do seu cliente de IA
Use a URL do servidor: https://mcp.kubit.ai/mcp
Complete a autenticação OAuth quando solicitado
Comece a consultar seus dados do Kubit

Nota: Verifique a documentação do seu cliente de IA para instruções específicas de configuração do servidor MCP.

Autenticação e Acesso

O servidor usa autenticação OAuth 2.0 e respeita suas permissões existentes do Kubit. Você verá apenas dados de esquemas aos quais já tem acesso — sem necessidade de permissões adicionais.

Ferramentas e Capacidades

Seu assistente de IA ganha acesso a cinco ferramentas poderosas:

Ferramenta	Propósito
`getUserContext`	Inicializar sessão e recuperar esquemas disponíveis
`getSchema`	Explorar eventos, propriedades e dimensões em detalhes
`createReport`	Gerar e executar consultas analíticas
`getRawData`	Exportar dados CSV de relatórios existentes
`searchKubit`	Encontrar relatórios e dashboards em toda a sua organização

Exemplos de Conversas

Entendendo o Comportamento do Usuário

"Show me conversion funnel for mobile app sign-ups in the last quarter"
"What are the most popular features used by premium users?"
"How has user retention changed month-over-month?"

Desempenho do Produto

"What are the top events by volume this week?"
"Show me user engagement trends for the last 30 days"
"Compare conversion rates across different traffic sources"

Descoberta de Dados

"What events and properties are available in the mobile app schema?"
"Show me all custom properties for the checkout event"
"What dimensions can I use for user segmentation?"

Fluxo de Trabalho Típico

Veja como a maioria das sessões de análise flui:

Initialize → Explore → Search → Create → Export

Inicializar - Chame getUserContext para ver os esquemas disponíveis
Explorar - Use getSchema para entender eventos e propriedades
Pesquisar - Verifique searchKubit para análises existentes
Criar - Gere novos relatórios com consultas personalizadas
Exportar - Extraia getRawData para análise externa

Melhores Práticas

Elaborando Prompts Eficazes

Seja Específico
Inclua intervalos de tempo, eventos e segmentos em suas perguntas.

- "Show me users"
+ "Show me active users in the US who signed up last month"

Forneça Contexto
Explique o que você está tentando entender.

- "What's the conversion rate?"
+ "What's the conversion rate from free trial to paid for users who engaged with feature X?"

Referencie Esquemas
Use nomes de esquemas ao trabalhar com múltiplas fontes de dados.

- "Show me sign-up events"
+ "In the mobile_events schema, show me sign-up events"

Divida em Partes
Análises complexas funcionam melhor como múltiplas perguntas focadas.

- "Show me everything about user behavior across all channels with retention and conversion"
+ Start with "Show me user retention by channel" then follow up

Otimização de Desempenho

Use searchKubit primeiro - Aproveite análises existentes antes de criar novos relatórios
Especifique intervalos de datas - Janelas de tempo reduzidas melhoram o desempenho da consulta
Exporte seletivamente - Use getRawData apenas quando precisar de análise externa detalhada

Segurança e Conformidade

Consideração	O Que Significa
Modelo de Permissão	Você só pode acessar esquemas que está autorizado a visualizar
Processamento de IA	Modelos de IA de terceiros processarão seus dados de consulta
Revisão de Política	Confirme se sua organização permite análise de dados assistida por IA

Solução de Problemas

Problemas Comuns e Soluções

Falhas de Autenticação
Verifique suas credenciais do Kubit e o nome da organização

Nenhum Esquema Disponível
Verifique se você tem acesso a pelo menos um esquema no Kubit

Erros de Conexão
Confirme se está usando a URL correta do servidor: https://mcp.kubit.ai/mcp

Problemas de Geração de Relatórios
Verifique se o esquema e os eventos que você está referenciando existem usando getSchema

Precisa de Ajuda?

Teste com consultas simples primeiro para verificar sua conexão
Verifique o acesso ao esquema através da interface web do Kubit
Use getSchema para confirmar eventos e propriedades disponíveis

Suporte e Recursos

Documentação
docs.kubit.ai - Documentação completa da plataforma

Sucesso do Cliente
Entre em contato com sua equipe de sucesso do cliente Kubit para assistência

Sobre o Kubit
kubit.ai - Saiba mais sobre análise nativa do warehouse

Protocolo MCP
modelcontextprotocol.io - Explore o Model Context Protocol