Kyomi MCP
Plataforma de inteligência de dados - consulte seu banco de dados em linguagem natural, crie dashboards e configure alertas automatizados que monitoram suas métricas 24 horas por dia, 7 dias por semana.
Documentação
Integração MCP
Acesse sua inteligência de dados diretamente do Cursor ou Claude Code. Consulte seu data warehouse, pesquise seu catálogo e aproveite o conhecimento acumulado da sua equipe—tudo sem sair do seu IDE.
O que é MCP?
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem a ferramentas externas e fontes de dados. O servidor MCP da Kyomi expõe sua inteligência de dados a qualquer cliente compatível com MCP.
Ferramentas Disponíveis
Quando você conecta a Kyomi via MCP, seu assistente de IA ganha acesso a:
Catálogo de Dados
- search_catalog - Busca semântica em todas as suas fontes de dados conectadas. Pergunte "encontre tabelas de receita de clientes" e obtenha resultados instantâneos.
- get_table_info - Obtenha informações detalhadas de esquema para qualquer tabela, incluindo tipos de coluna e descrições.
- list_datasources - Veja todas as fontes de dados conectadas ao seu workspace.
Execução de Consultas
- query_datasource - Execute consultas SQL em BigQuery, Snowflake, PostgreSQL e outras 6 plataformas.
- validate_sql - Verifique a sintaxe da consulta antes de executar.
Base de Conhecimento
- search_learnings - Acesse o conhecimento acumulado da sua equipe sobre seus dados.
- save_learning - Capture novos insights sobre tabelas, métricas ou regras de negócio.
Dashboards
- search_dashboards - Encontre dashboards existentes por conteúdo ou título.
- get_dashboard_info - Veja detalhes do dashboard e conteúdo ChartML.
- create_dashboard - Crie novos dashboards com visualizações ChartML.
Monitoramentos
- search_watches - Encontre monitores de dados existentes.
- create_watch - Configure monitoramento automatizado de dados com alertas.
Analytics de Sites
- create_analytics_site - Configure o rastreamento de analytics do site. Retorna um snippet
<script>e provisiona uma fonte de dados consultável. - list_analytics_sites - Veja todos os sites de analytics e seus snippets de rastreamento.
- update_analytics_site - Altere o nome do site ou os domínios permitidos.
- delete_analytics_site - Remova um site de analytics e todos os seus dados.
Conectando a partir do Cursor
- Vá para Configurações > Perfil na Kyomi
- Clique em Conectar com o Cursor
- O Cursor solicitará que você confirme a instalação
- Autorize a Kyomi quando solicitado no seu navegador
Pronto! As ferramentas da Kyomi agora estão disponíveis no Cursor.
Conectando a partir do Claude Code
Execute este comando no seu terminal:
claude mcp add kyomi --transport http https://app.kyomi.ai/mcp
Em seguida, reinicie o Claude Code. Ao usar uma ferramenta da Kyomi pela primeira vez, você será solicitado a autorizar a conexão no seu navegador.
Configuração Manual
Se preferir editar seu arquivo de configuração MCP diretamente, adicione isto à sua configuração:
{
"mcpServers": {
"kyomi": {
"type": "http",
"url": "https://app.kyomi.ai/mcp"
}
}
}
Locais dos arquivos de configuração:
- Cursor:
~/.cursor/mcp.json - Claude Code:
~/.claude/claude_desktop_config.json
Exemplo de Uso
Depois de conectado, você pode fazer perguntas ao seu assistente de IA, como:
"Pesquise tabelas relacionadas a pedidos de clientes"
"Quais colunas estão na tabela sales.transactions?"
"Execute uma consulta para obter a receita de ontem por categoria de produto"
"O que nossa equipe sabe sobre calcular MRR?"
"Crie um dashboard mostrando a tendência de usuários ativos semanais"
"Configure analytics do site para my-app.com e me dê o snippet de rastreamento"
"Quanto tráfego meu site recebeu esta semana?"
A IA usará as ferramentas da Kyomi para responder suas perguntas, com acesso total ao seu data warehouse e ao conhecimento acumulado da sua equipe.
Autenticação
- OAuth baseado em navegador - Ao conectar pela primeira vez, você autorizará pelo seu navegador
- Atualização automática - Os tokens são atualizados automaticamente, sem necessidade de reconectar
- Mesmas permissões - O MCP usa suas credenciais existentes da Kyomi e o acesso às fontes de dados
Segurança
- Todas as consultas usam suas credenciais e respeitam as permissões das fontes de dados
- Mesmo limite de pré-visualização de 20 linhas do aplicativo web da Kyomi para consultas de IA
- Isolamento do workspace - você só vê os dados do seu workspace
- Desconecte a qualquer momento em Configurações > Perfil
Disponibilidade
A integração MCP está disponível nos planos Pro, Team e Enterprise.
Solução de Problemas
Erros de "Não autorizado"
Seu token pode ter expirado. Desconecte e reconecte em Configurações > Perfil.
Ferramentas não aparecendo
Certifique-se de ter autorizado a Kyomi no seu navegador. Verifique se sua assinatura inclui acesso MCP.
Tempo limite de conexão
Verifique se sua rede consegue acessar app.kyomi.ai. Alguns firewalls corporativos podem bloquear conexões MCP.