Knowi MCP 服务器

将 Claude Code、Claude Desktop、Cursor 或任何兼容 MCP 的 AI 客户端连接到 Knowi。直接从您的 AI 助手处，以自然语言查询数据、创建仪表板、管理报告等。

MCP 服务器内置于 Knowi 应用程序中。无需单独安装。

快速入门

1. 生成 MCP 令牌

1. 登录 Knowi

2. 前往 设置 (Settings) → AI 设置 (AI Settings)

3. 在 MCP 令牌 (MCP Token) 下，选择有效期并点击 生成令牌 (Generate Token)

4. 复制令牌 — 它仅显示一次

2. 连接到 Claude Code

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

对于 knowi.com 账户：

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

3. 连接到 Claude Desktop

编辑您的配置文件：

• 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"
      }
    }
  }
}

保存后重启 Claude Desktop。

4. 验证

"What Knowi tools are available?"

您应该能看到包括 knowi_do、knowi_ask、knowi_search、knowi_list_dashboards 等在内的工具。

Related MCP server: AgenticBI

可用工具

AI 驱动工具

使用 Knowi 的 AI 编排器来解释指令并串联操作的自然语言工具。

确定性工具

行为可预测的直接、快速操作。

使用示例

"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"

令牌管理

轮换令牌：

1. 前往 设置 → AI 设置 → MCP 令牌

2. 点击 撤销令牌 (Revoke Token)

3. 生成新令牌并更新您的配置：

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"

每个用户一个令牌。 生成新令牌会自动撤销之前的令牌。

API 参考

MCP 服务器同时公开了流式 HTTP（用于 MCP 客户端）和 REST 端点（用于直接编程使用）。

健康检查

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

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

列出工具

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

调用工具 (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": {}
  }'

流式 HTTP (JSON-RPC)

所有 MCP 客户端操作都使用 POST /api/2.0/mcp 和标准 JSON-RPC：

# 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":{}}'

响应包含一个 Mcp-Session-Id 标头，用于后续请求。

安全性

• 作用域凭据：MCP 令牌仅访问 MCP 端点 — 它们不能用于更广泛的管理 API。

• 每次请求授权：每个工具在执行前都会验证经过身份验证的用户是否拥有对所请求资源的访问权限。

• 提示注入保护：AI 驱动的工具会扫描指令中的已知注入模式，并在到达 AI 模型之前拒绝它们。

• 破坏性操作保护：knowi_do 会阻止删除/丢弃/清除指令。删除操作需要使用带有必需 confirm: true 参数的显式 knowi_delete 工具。

• 数据截断：knowi_get_data 和 knowi_ask 默认最多返回 100 行。

• 会话安全：流式 HTTP 会话绑定到经过身份验证的用户。仅凭会话 ID 无法获得访问权限。

数据流

当 Claude 调用 Knowi MCP 工具时，工具响应（数据行、元数据、见解）将返回给 Claude 并在 Anthropic 的基础设施上进行处理。这是 MCP 的固有特性 — 客户端必须接收结果才能对其采取行动。

为了实现最大的数据隔离，请使用 Knowi 的产品内 AI 代理，而不是 MCP。

故障排除

工具未在 Claude 中显示：

• 完全重启 Claude Code / Claude Desktop

• 验证服务器是否可达：curl https://your-instance.knowi.com/api/2.0/mcp/health

• 验证令牌是否有效：curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

claude mcp list 中出现 "Failed to connect"：

• 确认您使用了 --transport http（流式 HTTP 所必需）

• 如果传输设置不正确，请删除并重新添加服务器

401 错误：

• 令牌可能已过期或被撤销。从“设置 → AI 设置”生成新令牌并更新您的配置。

工具调用返回访问被拒绝：

• 您配置令牌的用户没有请求资源的权限。

• 对于生产环境，请创建一个具有最低所需权限的专用 Knowi 用户。

要求

• 启用了 AI 代理 (AI Agents) 的 Knowi 账户（设置 → AI 设置）

• Claude Code CLI、Claude Desktop 或任何兼容 MCP 的客户端

文档

• MCP 服务器参考 — 完整的 API 参考、所有工具架构、安全模型

• Claude Code 设置指南 — 分步设置说明

• Knowi 文档 — 完整的产品文档

支持

• 文档： knowi.com/docs

• 支持： support.knowi.com

• 此仓库的问题： 提交 GitHub Issue