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": "Engineering Docs"}
]

guru_answer_generation

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

mcporter call 'guru.guru_answer_generation(
  agentId: "YOUR_AGENT_ID",
  question: "How do I submit expenses?"
)'

可选过滤器：

• collectionIds— 限制在特定集合
• sourceIds— 限制特定来源

返回附带来源的全面答案。

guru_search_documents

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

mcporter call 'guru.guru_search_documents(
  agentId: "YOUR_AGENT_ID",
  query: "onboarding process"
)'

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

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: "New Process Guide",
  content: "<h2>Overview</h2><p>This guide covers...</p>"
)'

返回草稿ID和URL。

guru_update_card

更新现有卡片。首先使用guru_get_card_by_id检索当前内容，然后进行修改。

mcporter call 'guru.guru_update_card(
  cardId: "CARD_ID",
  title: "Updated Title",
  content: "<p>Updated HTML content...</p>"
)'

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

使用模式

提问

# 1. Get agent ID
mcporter call 'guru.guru_list_knowledge_agents()'

# 2. Ask question
mcporter call 'guru.guru_answer_generation(
  agentId: "08de66e8-...",
  question: "What is the PTO policy?"
)'

查找并阅读卡片

# 1. Search for cards
mcporter call 'guru.guru_search_documents(
  agentId: "08de66e8-...",
  query: "expense report"
)'

# 2. Get full content
mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID_FROM_SEARCH")'

创建新文档

mcporter call 'guru.guru_create_draft(
  title: "API Authentication Guide",
  content: "<h2>Overview</h2><p>This guide explains how to authenticate with our API.</p><h2>Steps</h2><ol><li>Generate API key</li><li>Add to headers</li></ol>"
)'

选择合适的工具

令牌格式

GURU_API_TOKEN必须采用邮箱:令牌的格式注意事项

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

问题会出现在Guru的

• AI智能中心分析报告中analytics
• 所有权限均已强制执行（用户仅能看到其有权访问的内容）
• 知识代理可针对特定领域——请根据您的问题选择合适的代理
• 卡片内容为HTML格式——更新时请保持原有结构

资源

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