跳转到内容
Glean

MCP 集成

Glean v0.2.5 版本起可用

模型上下文协议（MCP）集成使 Claude Desktop 和其他 AI 助手能够搜索并与您的 RSS 订阅进行交互，让您可以询问有关阅读材料的问题并获得 AI 驱动的见解。

快速设置

Section titled “快速设置”

步骤 1：创建 API Token

Section titled “步骤 1：创建 API Token”
  1. 在 Glean 账户中进入设置
  2. 导航到 API Tokens
  3. 点击创建新 Token
  4. 输入名称（例如：“Claude Desktop”）
  5. 可选择设置过期日期
  6. 点击创建并立即复制 Token

Token 格式示例：

glean_abc123def456ghi789jkl012mno345

步骤 2：配置 Claude Desktop

Section titled “步骤 2：配置 Claude Desktop”

找到 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

添加 Glean MCP 服务器到配置：

{
  "mcpServers": {
    "glean": {
      "url": "http://your-glean-server:8000/mcp",
      "transport": {
        "type": "streamable-http",
        "headers": {
          "Authorization": "Bearer glean_abc123def456ghi789jkl012mno345"
        }
      }
    }
  }
}

替换：

  • your-glean-server 为您的实际服务器地址
  • Token 为步骤 1 中的 API Token

步骤 3：重启并测试

Section titled “步骤 3：重启并测试”
  1. 重启 Claude Desktop
  2. 通过询问来验证集成： 
    你能帮我搜索 RSS 订阅中关于人工智能的文章吗？

如果配置正确，Claude 将搜索您的 Glean 订阅并返回结果。

可用功能

Section titled “可用功能”

Claude 可以帮助您：

搜索文章

Section titled “搜索文章”

让 Claude 按关键词查找文章：

  • “搜索上个月关于 Python 教程的文章”
  • “查找关于机器学习的文章”
  • “我读过哪些关于气候变化的内容？“

按日期浏览

Section titled “按日期浏览”

获取特定时间段的文章：

  • “显示过去一周的未读文章”
  • “昨天我的订阅源发布了什么？”
  • “2025 年 1 月的文章”

获取完整内容

Section titled “获取完整内容”

通过 Claude 阅读完整文章：

  • “显示那篇关于 LLM 的文章的完整内容”
  • “能总结一下关于优化的文章吗？“

列出订阅

Section titled “列出订阅”

了解您的阅读习惯：

  • “我订阅了哪些 RSS 源？”
  • “哪些订阅源有最多未读文章？”
  • “显示我的技术相关订阅”

使用场景

Section titled “使用场景”

研究助手

Section titled “研究助手”
"搜索我的 RSS 订阅中关于量子计算的最新文章
并总结关键发展"

Claude 将搜索您的订阅源，检索相关文章，并提供 AI 生成的摘要。

趋势分析

Section titled “趋势分析”
"这周我的订阅源都在讨论什么话题？"

Claude 分析您最近的文章并识别趋势主题。

阅读推荐

Section titled “阅读推荐”
"我的订阅源中哪些未读文章与 Web 开发最相关？"

Claude 搜索并根据相关性对文章进行排名。

内容发现

Section titled “内容发现”
"查找同时讨论 AI 和隐私的文章"

Claude 在您的所有订阅中执行高级搜索。

管理 API Token

Section titled “管理 API Token”

查看活跃 Token

Section titled “查看活跃 Token”

进入设置 → API Tokens 查看：

  • Token 名称
  • 前 16 个字符（例如：glean_abc123def456...）
  • 创建日期
  • 最后使用时间戳
  • 过期日期（如果设置）

安全最佳实践

Section titled “安全最佳实践”
  1. 使用描述性名称以跟踪 Token 使用
  2. 为不同客户端创建单独的 Token
  3. 为临时访问设置过期日期
  4. 如果 Token 泄露立即吊销
  5. 定期监控最后使用时间戳

吊销 Token

Section titled “吊销 Token”
  1. 进入设置 → API Tokens
  2. 找到要吊销的 Token
  3. 点击删除或吊销
  4. 确认操作

故障排除

Section titled “故障排除”

”MCP 服务器无响应”

Section titled “”MCP 服务器无响应””

检查服务器状态：

Terminal window
curl http://your-glean-server:8000/api/health

验证 MCP 端点：

Terminal window
curl http://your-glean-server:8000/mcp \
  -H "Authorization: Bearer glean_your_token_here"

解决方案：

  • 验证 Glean 服务器正在运行
  • 检查防火墙规则
  • 确保配置中的服务器 URL 正确
  • 修改配置后重启 Claude Desktop

”未授权”或”无效 Token”

Section titled “”未授权”或”无效 Token””

解决方案：

  • 验证 Token 格式（应以 glean_ 开头）
  • 检查 Token 是否过期
  • 确认 Token 未被吊销
  • 如需要创建新 Token

无搜索结果

Section titled “无搜索结果”

解决方案：

  • 验证您有活跃的订阅
  • 尝试更广泛的搜索词
  • 检查订阅源是否正在更新（查看最后同步时间）
  • 确保日期范围包含已发布的文章

性能缓慢

Section titled “性能缓慢”

解决方案：

  • 减少查询中的结果限制
  • 缩小日期范围（最大：365 天）
  • 搜索特定订阅源而不是所有订阅
  • 检查服务器资源（CPU、内存）

高级配置

Section titled “高级配置”

自定义服务器 URL

Section titled “自定义服务器 URL”

用于反向代理或自定义端口：

{
  "mcpServers": {
    "glean": {
      "url": "https://glean.example.com/mcp",
      "transport": {
        "type": "streamable-http",
        "headers": {
          "Authorization": "Bearer glean_your_token_here"
        }
      }
    }
  }
}

Token 过期

Section titled “Token 过期”

创建 Token 时设置过期时间：

  • 30 天：用于测试
  • 90 天：用于常规使用
  • 365 天：用于长期访问
  • 无过期：仅在绝对必要时使用

安全性

Section titled “安全性”

Token 安全特性

Section titled “Token 安全特性”
特性说明
bcrypt 哈希Token 以安全哈希存储，永不明文
前缀显示UI 中仅显示前 16 个字符
用户隔离Token 仅访问所有者的数据
吊销功能即时 Token 失效
活动跟踪最后使用时间戳用于监控

网络安全

Section titled “网络安全”
  • 生产环境使用 HTTPS（配置反向代理）
  • 将 Glean 服务器放在防火墙后
  • 像对待密码一样对待 Token - 永不分享
  • 定期审查活跃 Token

API 参考

Section titled “API 参考”

MCP 端点

Section titled “MCP 端点”
  • URL：http://your-glean-server:8000/mcp
  • 传输方式：Streamable HTTP（MCP 协议）
  • 认证：Bearer Token（API Token）

REST 端点

Section titled “REST 端点”
端点方法说明
/api/tokensGET列出所有 Token
/api/tokensPOST创建新 Token
/api/tokens/{id}DELETE吊销 Token

下一步

Section titled “下一步”