Knowi

Consulte bancos de dados, crie painéis e analise documentos em linguagem natural a partir do Claude ou de qualquer cliente MCP. Mais de 28 ferramentas, mais de 70 fontes de dados.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Knowi

Conecte o Claude Code, Claude Desktop, Cursor ou qualquer cliente de IA compatível com MCP ao Knowi. Consulte seus dados, crie dashboards, gerencie relatórios e muito mais — em linguagem natural, diretamente do seu assistente de IA.

O servidor MCP está integrado ao aplicativo Knowi. Nenhuma instalação separada é necessária.

Início Rápido

1. Gerar um Token MCP

Faça login no Knowi
Vá para Configurações → Configurações de IA
Em Token MCP, escolha uma expiração e clique em Gerar Token
Copie o token — ele é exibido apenas uma vez

2. Conectar ao Claude Code

claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Para contas knowi.com:

claude mcp add knowi https://www.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

3. Conectar ao Claude Desktop

Edite seu arquivo de configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "knowi": {
      "type": "streamable-http",
      "url": "https://your-instance.knowi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar.

4. Verificar

"What Knowi tools are available?"

Você deve ver ferramentas incluindo knowi_do, knowi_ask, knowi_search, knowi_list_dashboards e outras.

Ferramentas Disponíveis

Ferramentas com IA

Ferramentas de linguagem natural que usam o orquestrador de IA do Knowi para interpretar instruções e encadear operações.

Ferramenta	Descrição
`knowi_do`	Executa qualquer operação do Knowi via linguagem natural
`knowi_ask`	Faça uma pergunta sobre dados — encontra o conjunto de dados, gera uma consulta e retorna resultados
`knowi_search`	Pesquise em todos os dashboards, widgets, conjuntos de dados e relatórios

Ferramentas Determinísticas

Operações diretas e rápidas com comportamento previsível.

Ferramenta	Descrição
`knowi_list_dashboards`	Lista todos os dashboards acessíveis
`knowi_get_data`	Recupera linhas de dados de um widget ou conjunto de dados
`knowi_push_data`	Envia linhas de dados para um conjunto de dados (cria se não existir)
`knowi_get_details`	Obtém metadados completos de qualquer ativo
`knowi_find_widget`	Encontra widgets por nome
`knowi_create_datasource`	Cria uma nova conexão de fonte de dados
`knowi_create_query`	Cria e executa uma consulta contra uma fonte de dados
`knowi_create_widget`	Cria um novo gráfico ou visualização
`knowi_update_widget`	Atualiza um widget existente
`knowi_create_report`	Cria um relatório agendado
`knowi_create_alert`	Cria um alerta de dados
`knowi_list_alerts`	Lista alertas configurados
`knowi_test_alert`	Testa um alerta
`knowi_update_alert`	Atualiza um alerta
`knowi_run`	Dispara a execução de uma consulta ou relatório
`knowi_export_pdf`	Exporta um dashboard ou widget como PDF
`knowi_export_csv`	Exporta dados como CSV
`knowi_get_embed_url`	Gera uma URL de compartilhamento incorporável
`knowi_get_insights`	Obtém insights gerados por IA para um widget
`knowi_layout_dashboard`	Organiza widgets em um dashboard
`knowi_import_file`	Importa um arquivo (CSV, Excel) como conjunto de dados
`knowi_ingest_document`	Ingere um documento para perguntas e respostas com IA
`knowi_ask_document`	Faça perguntas sobre documentos ingeridos
`knowi_extract_document_data`	Extrai dados estruturados de um documento
`knowi_list_documents`	Lista documentos ingeridos
`knowi_delete_document`	Exclui um documento ingerido
`knowi_delete`	Exclui um ativo (requer confirmação explícita)

Exemplos de Uso

"Show me my Knowi dashboards"

"Ask Knowi: what were our top customers by revenue last month?"

"Create a sales dashboard with revenue trends and top products"

"Search Knowi for dashboards related to customer analytics"

"Get the data from the Monthly Revenue widget"

"Export the Executive Summary dashboard to PDF"

"Push these sales records to a Knowi dataset called 'Daily Sales'"

"Set up a daily email report for the executive dashboard"

Gerenciamento de Tokens

Rotacionar um token:

Vá para Configurações → Configurações de IA → Token MCP
Clique em Revogar Token
Gere um novo e atualize sua configuração:

claude mcp remove knowi
claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_NEW_TOKEN"

Um token por usuário. Gerar um novo token revoga automaticamente o anterior.

Referência da API

O servidor MCP expõe tanto endpoints Streamable HTTP (para clientes MCP) quanto REST (para uso programático direto).

Verificação de Saúde

curl https://your-instance.knowi.com/api/2.0/mcp/health

{
  "status": "healthy",
  "toolCount": 28,
  "tools": ["knowi_do", "knowi_ask", "knowi_search", "..."],
  "activeSessions": 0
}

Listar Ferramentas

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-instance.knowi.com/api/2.0/mcp/tools

Chamar uma Ferramenta (REST)

curl -X POST https://your-instance.knowi.com/api/2.0/mcp/tools/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "knowi_list_dashboards",
    "arguments": {}
  }'

Streamable HTTP (JSON-RPC)

Todas as operações de clientes MCP usam POST /api/2.0/mcp com JSON-RPC padrão:

# Initialize
curl -X POST https://your-instance.knowi.com/api/2.0/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

A resposta inclui um cabeçalho Mcp-Session-Id para usar em solicitações subsequentes.

Segurança

Credenciais com escopo: Tokens MCP acessam apenas endpoints MCP — não podem ser usados contra a API de Gerenciamento mais ampla.
Autorização em cada solicitação: Cada ferramenta verifica se o usuário autenticado tem acesso ao recurso solicitado antes de executar.
Proteção contra injeção de prompts: Ferramentas com IA verificam instruções em busca de padrões de injeção conhecidos e os rejeitam antes de chegarem ao modelo de IA.
Proteção para operações destrutivas: knowi_do bloqueia instruções de exclusão/remoção/purga. Exclusões exigem a ferramenta explícita knowi_delete com um parâmetro obrigatório confirm: true.
Truncamento de dados: knowi_get_data e knowi_ask retornam no máximo 100 linhas por padrão.
Segurança de sessão: Sessões Streamable HTTP são vinculadas ao usuário autenticado. IDs de sessão sozinhos não concedem acesso.

Fluxo de Dados

Quando o Claude chama uma ferramenta MCP do Knowi, a resposta da ferramenta (linhas de dados, metadados, insights) é retornada ao Claude e processada na infraestrutura da Anthropic. Isso é inerente ao MCP — o cliente deve receber resultados para agir sobre eles.

Para máxima isolamento de dados, use os agentes de IA integrados do Knowi em vez do MCP.

Solução de Problemas

Ferramentas não aparecendo no Claude:

Reinicie o Claude Code / Claude Desktop completamente
Verifique se o servidor está acessível: curl https://your-instance.knowi.com/api/2.0/mcp/health
Verifique se o token é válido: curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

"Falha ao conectar" no claude mcp list:

Confirme que você usou --transport http (obrigatório para Streamable HTTP)
Remova e adicione novamente o servidor se o transporte foi configurado incorretamente

Erros 401:

O token pode estar expirado ou revogado. Gere um novo token em Configurações → Configurações de IA e atualize sua configuração.

Chamadas de ferramentas retornam acesso negado:

O usuário cujo token você configurou não tem permissão para o recurso solicitado.
Para uso em produção, crie um usuário Knowi dedicado com as permissões mínimas necessárias.

Requisitos

Conta Knowi com Agentes de IA habilitados (Configurações → Configurações de IA)
CLI do Claude Code, Claude Desktop ou qualquer cliente compatível com MCP

Documentação

Referência do Servidor MCP — referência completa da API, todos os esquemas de ferramentas, modelo de segurança
Guia de Configuração do Claude Code — instruções de configuração passo a passo
Documentação do Knowi — documentação completa do produto

Suporte

Documentação: knowi.com/docs
Suporte: support.knowi.com
Problemas com este repositório: Abra uma issue no GitHub