guru-mcp

Guru MCP 是通过官方 MCP 服务器访问 Guru 知识库的技能，让 AI 工具能够提问、搜索文档、创建草稿和更新卡片。

用途

该技能用于将 AI 工具连接到 Guru 知识库，实现 AI 驱动的知识问答与文档管理。借助它，用户可以在 AI 工具中直接查询企业内部知识，而无需手动打开 Guru 逐条查找。

主要能力

AI 驱动答案：从 Knowledge Agents 获取综合性回答。
文档搜索：在知识库中查找卡片与内容。
创建草稿：从 AI 工具生成新的卡片草稿。
更新卡片：直接修改已有卡片。
连接来源：通过 Guru 访问 Salesforce、Slack、Google Drive、Confluence、SharePoint。
权限感知：遵循所有现有的 Guru 权限设置。
分析记录：所有查询都会记录在 AI Agent Center 中。

使用方式

1. 获取 API Token

前往 Guru Admin → API Tokens，创建一个新 Token，并记录邮箱和 Token。

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：列出工作区中所有 Knowledge Agents。应始终先调用此工具，以获取其他工具所需的 agent ID。

mcporter call 'guru.guru_list_knowledge_agents()'

返回示例：

[ {"id": "08de66e8-...", "name": "Guru"}, {"id": "abc123...", "name": "Engineering Docs"} ]

guru_answer_generation：从 Knowledge Agent 获取 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. 获取 agent ID

mcporter call 'guru.guru_list_knowledge_agents()'

2. 提问

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

查找并阅读卡片：

1. 搜索卡片

mcporter call 'guru.guru_search_documents( agentId: "08de66e8-...", query: "expense report" )'

2. 获取完整内容

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

工具选择建议

“X 是什么？”/“如何做 Y？”：guru_answer_generation
“查找关于 X 的文档”：guru_search_documents
“显示卡片 XYZ”：guru_get_card_by_id
“为 X 创建新指南”：guru_create_draft
“用……更新此卡片”：guru_update_card

Token 格式

GURU_API_TOKEN 必须为 email:token 格式：

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

注意事项

问题会出现在 Guru 的 AI Agent Center 分析中。
所有权限均被强制执行（用户只能看到自己有权访问的内容）。
Knowledge Agents 可能针对特定领域，应为问题选择正确的 Agent。
卡片内容是 HTML，更新时需保留结构。

适用场景与限制

该技能适用于需要在 AI 工具中查询和更新 Guru 知识库的团队，尤其适合希望让 AI 借助企业内部文档回答问题、查找资料或起草文档的场景。使用前提是拥有 Guru API Token 并完成环境与 mcporter 配置。资料中未提供除上述要求以外的其他平台限制、收费或价格信息。