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

  1. Vá para Configurações > Perfil na Kyomi
  2. Clique em Conectar com o Cursor
  3. O Cursor solicitará que você confirme a instalação
  4. 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.