介绍
# Guru MCP
通过官方 MCP 服务器访问您的 Guru 知识库。询问 AI 驱动的问题、搜索文档、创建草稿以及更新卡片。
## 功能特性
- **AI 驱动的答案** — 从知识代理 获取全面的答案 - **文档搜索** — 在整个知识库中查找卡片和内容 - **创建草稿** — 使用 AI 工具生成新的卡片草稿 - **更新卡片** — 直接修改现有卡片 - **关联源** — 通过 Guru 访问 Salesforce、Slack、Google Drive、Confluence、SharePoint - **权限感知** — 遵守所有现有的 Guru 权限 - **分析** — 所有查询均记录在 AI Agent Center 中
## 设置
### 1. 获取 API 令牌
1. 前往 **Guru Admin → API Tokens** 2. 创建一个新令牌 3. 记下您的电子邮件和令牌
### 2. 配置环境
添加到 `~/.clawdbot/.env`： ```bash [email protected]:your-api-token ```
### 3. 配置 mcporter
添加到 `config/mcporter.json`： ```json { "mcpServers": { "guru": { "baseUrl": "https://mcp.api.getguru.com/mcp", "headers": { "Authorization": "Bearer ${GURU_API_TOKEN}" } } } } ```
### 4. 验证
```bash mcporter list guru ```
## 可用工具
### `guru_list_knowledge_agents`
列出您工作区中的所有知识代理。**始终首先调用此工具**以获取其他工具所需的代理 ID。
```bash mcporter call 'guru.guru_list_knowledge_agents()' ```
返回： ```json [ {"id": "08de66e8-...", "name": "Guru"}, {"id": "abc123...", "name": "Engineering Docs"} ] ```
### `guru_answer_generation`
从知识代理获取 AI 驱动的答案。最适合“什么是 X？”或“我如何做 Y？”等具体问题。
```bash mcporter call 'guru.guru_answer_generation( agentId: "YOUR_AGENT_ID", question: "How do I submit expenses?" )' ```
可选过滤器： - `collectionIds` — 限制为特定集合 - `sourceIds` — 限制为特定源
返回包含来源的全面答案。
### `guru_search_documents`
查找文档、卡片和源。最适合浏览内容，如“查找关于 X 的文档”或“我们是否有关于 Y 的卡片？”。
```bash mcporter call 'guru.guru_search_documents( agentId: "YOUR_AGENT_ID", query: "onboarding process" )' ```
返回包含摘要的匹配文档列表。
### `guru_get_card_by_id`
以 HTML 格式获取完整的卡片内容。
```bash mcporter call 'guru.guru_get_card_by_id(id: "CARD_ID")' ```
返回卡片 ID、标题和 HTML 内容。
### `guru_create_draft`
创建一个新的卡片草稿。
```bash 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` 检索当前内容，然后进行修改。
```bash mcporter call 'guru.guru_update_card( cardId: "CARD_ID", title: "Updated Title", content: "<p>Updated HTML content...</p>" )' ```
**重要：** 更新时保留 HTML 结构。在现有的 DOM 层次结构中插入/替换内容。
## 使用模式
### 提出问题
```bash # 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?" )' ```
### 查找并阅读卡片
```bash # 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")' ```
### 创建新文档
```bash 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` |
## 令牌格式
`GURU_API_TOKEN` 必须采用 `email:token` 格式： ``` [email protected]:a1b2c3d4-e5f6-7890-abcd-ef1234567890 ```
## 注意事项
- 问题会出现在 Guru 的 **AI Agent Center** 分析中 - 强制执行所有权限（用户只能看到他们有权访问的内容） - 知识代理可能特定于某个领域 — 请为您的选择合适的问题代理 - 卡片内容是 HTML 格式 — 更新时请保留结构
## 资源
- [Guru MCP 文档](https://help.getguru.com/docs/connecting-gurus-mcp-server) - [Guru API 参考](https://developer.getguru.com) - [AI Agent Center](https://app.getguru.com/ai-agent-center) - [MCP 反馈](https://help.getguru.com/docs/connecting-gurus-mcp-server#feedback)