名称： guru-mcp
描述： 通过 MCP 访问 Guru 知识库——向 AI 提问、搜索文档、创建草稿、更新卡片。可连接所有 Guru 数据源，包括 Slack、Drive、Confluence 和 SharePoint。
主页： https://www.getguru.com
元数据： {"clawdbot":{"emoji":"🧠","requires":{"bins":["mcporter"],"env":["GURU_API_TOKEN"]}}}

Guru MCP

通过官方 MCP 服务器访问您的 Guru 知识库。使用 AI 功能提问、搜索文档、创建草稿和更新卡片。

功能特性

• AI 智能问答 — 从知识代理获取全面的答案
• 文档搜索 — 在知识库中查找卡片和内容
• 创建草稿 — 通过 AI 工具生成新的卡片草稿
• 更新卡片 — 直接修改现有卡片
• 连接数据源 — 通过 Guru 访问 Salesforce、Slack、Google Drive、Confluence、SharePoint
• 权限感知 — 遵循所有现有的 Guru 权限设置
• 分析记录 — 所有查询均记录在 AI 代理中心

安装配置

1. 获取 API 令牌

1. 进入 Guru 管理后台 → API 令牌
2. 创建新令牌
3. 记录您的邮箱和令牌

2. 配置环境变量

添加到 ~/.clawdbot/.env：

GURU_API_TOKEN=your.email@company.com:your-api-token

3. 配置 mcporter

添加到 config/mcporter.json：

{
  "mcpServers": {
    "guru": {
      "baseUrl": "https://mcp.api.getguru.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GURU_API_TOKEN}"
      }
    }
  }
}

4. 验证连接

mcporter list guru

可用工具

guru_list_knowledge_agents

列出工作空间中的所有知识代理。请首先调用此工具以获取其他工具所需的代理 ID。

mcporter call 'guru.guru_list_knowledge_agents()'

返回示例：

[
  {"id": "08de66e8-...", "name": "Guru"},
  {"id": "abc123...", "name": "工程文档"}
]

guru_answer_generation

从知识代理获取 AI 驱动的答案。最适合具体问题，如“什么是 X？”或“如何做 Y？”。

mcporter call 'guru.guru_answer_generation(
  agentId: "YOUR_AGENT_ID",
  question: "如何提交报销？"
)'

可选筛选条件：
- collectionIds — 限制到特定集合
- sourceIds — 限制到特定数据源

返回包含来源的完整答案。

guru_search_documents

查找文档、卡片和数据源。最适合浏览内容，如“查找关于 X 的文档”或“我们有关于 Y 的卡片吗？”。

mcporter call 'guru.guru_search_documents(
  agentId: "YOUR_AGENT_ID",
  query: "入职流程"
)'

返回匹配文档列表及内容片段。

guru_get_card_by_id

获取卡片的完整 HTML 格式内容。

mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID")'

返回卡片 ID、标题和 HTML 内容。

guru_create_draft

创建新的卡片草稿。

mcporter call 'guru.guru_create_draft(
  title: "新流程指南",
  content: "<h2>概述</h2><p>本指南涵盖...</p>"
)'

返回草稿 ID 和 URL。

guru_update_card

更新现有卡片。请先使用 guru_get_card_by_id 获取当前内容，再进行修改。

mcporter call 'guru.guru_update_card(
  cardId: "CARD_ID",
  title: "更新后的标题",
  content: "<p>更新后的 HTML 内容...</p>"
)'

重要提示： 更新时请保留 HTML 结构。在现有 DOM 层次结构中插入或替换内容。

使用模式

提问

# 1. 获取代理 ID
mcporter call 'guru.guru_list_knowledge_agents()'

# 2. 提问
mcporter call 'guru.guru_answer_generation(
  agentId: "08de66e8-...",
  question: "带薪休假政策是什么？"
)'

查找并阅读卡片

# 1. 搜索卡片
mcporter call 'guru.guru_search_documents(
  agentId: "08de66e8-...",
  query: "费用报销"
)'

# 2. 获取完整内容
mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID_FROM_SEARCH")'

创建新文档

mcporter call 'guru.guru_create_draft(
  title: "API 认证指南",
  content: "<h2>概述</h2><p>本指南说明如何对我们的 API 进行认证。</p><h2>步骤</h2><ol><li>生成 API 密钥</li><li>添加到请求头</li></ol>"
)'

选择合适工具

令牌格式

GURU_API_TOKEN 必须为 邮箱:令牌 格式：

your.email@company.com:a1b2c3d4-e5f6-7890-abcd-ef1234567890

注意事项

• 问题会出现在 Guru 的 AI 代理中心 分析中
• 所有权限均强制执行（用户只能看到其有权访问的内容）
• 知识代理可以是特定领域的——请根据问题选择正确的代理
• 卡片内容为 HTML 格式——更新时请保留结构

相关资源

• Guru MCP 文档
• Guru API 参考
• AI 代理中心
• MCP 反馈