FeedNest

FeedNest MCP 服务

你的信息源，而非整个网络。向 AI 询问你的订阅源——它已经了解这些内容。

ChatGPT 会搜索互联网。Perplexity 会爬取数十亿个网页。当你询问所在行业、兴趣或世界时，它们会提供一切，却唯独遗漏真正重要的内容。

FeedNest 与众不同。你的 AI 只会使用你选择的信息源：你信任的博客、关注的刊物、认可的专家。没有算法噪声。没有黑箱结果。基于你的世界提供智能信息。

此 MCP 服务让任何 AI 助手——ChatGPT、Codex、Claude、Gemini、Grok、Cursor、Windsurf、Cline、Le Chat 等——都能通过自然语言直接访问你的订阅源、文章、摘录、笔记和标签。

---

你的 AI 能做什么

只管提问，剩下的交给 AI。

• 晨间简报 - 醒来即可查看订阅源一夜之间发生的所有事情的摘要
• 对比报道 - 并排查看不同信息源如何报道同一事件
• 及早发现趋势 - 在趋势进入主流视野之前，让 AI 发现新兴规律
• 深入探索任意主题 - 汇总你关注的所有信息源，获得全面综述
• 追踪进展中的事件 - 随着事件发展，追踪它在所有订阅源中的后续报道
• 即时搜索 - 几秒钟内就能在所有信息源中找到任意文章
• 摘录和笔记 - 保存重要内容，并添加自己的想法

---

快速开始

前提条件

1. 一个 FeedNest 账户。通过 OAuth 连接的应用（ChatGPT、Claude）适用于所有套餐：免费套餐可读取订阅源和文章，每小时最多 20 次请求；Plus 和 Pro 套餐还允许保存、添加标签、摘录、记笔记，以及将文章标记为已读。
2. 对于使用 API 密钥配置的客户端：需要从 Settings → Developer API 获取密钥，并订阅 Pro 套餐

ChatGPT

选项 A：网页界面（OAuth - 推荐）

1. 前往 Settings → Apps & Connectors → Advanced，启用 Developer Mode
2. 前往 Settings → Apps → Create。将应用命名为 FeedNest，并将 URL 设为 https://mcp.feednest.com
3. ChatGPT 会将你重定向到 FeedNest——登录并授权

无需 API 密钥。ChatGPT 会自动处理 OAuth 流程。

选项 B：Responses API

在 API 请求中将 FeedNest 作为 MCP 工具：

{
  "type": "mcp",
  "server_url": "https://mcp.feednest.com",
  "server_label": "feednest",
  "authorization": "fn_live_YOUR_API_KEY"
}

Codex

选项 A：插件（推荐）

该插件将技能、MCP 配置和品牌素材打包在一次安装中。目前它尚未收录在 Codex 插件目录中，因此请从此代码库安装：参见 Codex 插件 README 中的本地安装。

选项 B：在 config.toml 中配置 MCP

添加到 ~/.codex/config.toml：

[mcp_servers.feednest]
url = "https://mcp.feednest.com"
bearer_token_env_var = "FEEDNEST_API_KEY"

export FEEDNEST_API_KEY="fn_live_YOUR_API_KEY"

或通过 CLI：

codex mcp add feednest --transport http https://mcp.feednest.com

Claude

连接器目录（OAuth - 推荐）

FeedNest 已列入 Claude 的连接器目录。

1. 打开 claude.ai/directory/feednest，或在 Customize → Connectors 中搜索 FeedNest
2. 点击 Connect to Claude，登录 FeedNest 并授权

无需 API 密钥，而且该连接器会随你的 Claude 账户同步到 Claude Desktop 和移动应用。

若要改用 URL 添加，请在 Customize → Connectors 中添加自定义连接器，URL 填写 https://mcp.feednest.com，OAuth Client ID 和 Secret 留空。

Claude Code 和 Cowork：插件（OAuth - 推荐）

Claude 插件提供 FeedNest 服务、一个指导 Claude 如何更好地使用工具的技能，以及 /feednest:briefing 命令。它通过 OAuth 登录，因此适用于所有 FeedNest 套餐。

/plugin marketplace add feednest-app/mcp
/plugin install feednest@feednest

然后运行 /mcp，选择 feednest 并登录。

使用 API 密钥的 Claude Code

claude mcp add --transport http feednest https://mcp.feednest.com \
  --header "Authorization: Bearer fn_live_YOUR_API_KEY"

添加 -s user 即可在所有项目中全局使用。API 密钥需要 FeedNest Pro。

Claude Desktop 配置文件（需要桥接程序）

上面的目录连接器已可在 Claude Desktop 中使用。若要改为在 claude_desktop_config.json 中配置 FeedNest（该文件仅运行 stdio 服务），请使用 mcp-remote 桥接程序：

{
  "mcpServers": {
    "feednest": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.feednest.com",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

配置路径：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）、%APPDATA%\Claude\claude_desktop_config.json（Windows）或 ~/.config/Claude/claude_desktop_config.json（Linux）。

Cursor

将以下内容添加到项目中的 .cursor/mcp.json（全局配置则添加到 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "feednest": {
      "url": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

提示： Cursor 支持环境变量插值："Bearer ${env:FEEDNEST_API_KEY}"。不要添加 "type" 字段——Cursor 会根据 "url" 键自动检测。

Le Chat（Mistral）

所有套餐均可使用，包括免费套餐。

1. 前往 侧边栏 → 智能 → 连接器
2. 点击 + 添加连接器 → 自定义 MCP 连接器
3. 将 名称设为 FeedNest，将 服务 URL设为 https://mcp.feednest.com
4. 将 身份验证类型设为 API 令牌身份验证，将 授权设为 Bearer fn_live_YOUR_API_KEY

Windsurf

将以下内容添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "feednest": {
      "serverUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

重要： Windsurf 使用 "serverUrl"（而非 "url"）。使用错误的键会导致静默失败。

Cline

在 VS Code 中，打开 Cline 扩展设置 → MCP Servers 配置（JSON）：

{
  "mcpServers": {
    "feednest": {
      "type": "streamableHttp",
      "url": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

关键： "type": "streamableHttp" 字段是 Cline 的必填项。若缺少此字段，自定义标头可能会静默失效，身份验证也无法正常工作。

Gemini CLI

将以下内容添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "feednest": {
      "httpUrl": "https://mcp.feednest.com",
      "headers": {
        "Authorization": "Bearer fn_live_YOUR_API_KEY"
      }
    }
  }
}

注意： Gemini CLI 使用 "httpUrl"（而非 "url"）。"url" 字段保留用于 SSE 传输。仅限 CLI——gemini.google.com 不支持外部 MCP 服务。

Grok（xAI）

只能通过 xAI API/SDK 使用，无法在 grok.com 聊天界面中使用。

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-3",
    "tools": [{
      "type": "mcp",
      "server_url": "https://mcp.feednest.com",
      "server_label": "feednest",
      "authorization": "Bearer fn_live_YOUR_API_KEY"
    }],
    "input": "What are my unread articles?"
  }'

其他 MCP 客户端

任何支持 Streamable HTTP 的客户端都可以通过以下方式连接：

• URL：https://mcp.feednest.com
• 标头：Authorization: Bearer fn_live_YOUR_API_KEY

对于仅支持 stdio 的客户端，请使用 mcp-remote 桥接程序：

{
  "mcpServers": {
    "feednest": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.feednest.com",
        "--header", "Authorization:Bearer fn_live_YOUR_API_KEY"
      ]
    }
  }
}

---

工具（25）

文章

工具	说明	关键参数
get_articles	列出文章及其标题、来源、日期和摘要预览。视图：新闻源、按 Feed、按文件夹、按标签、已标记、已高亮、已添加笔记。	view*、feed_id、folder_id、tag_id、limit、query、sort、unread_only、date_from、date_to、count_only
get_article	获取文章全文，包括高亮、笔记和阅读时长。	article_id*
extract_article	当 RSS 内容被截断时，从原始 URL 获取全文。	article_id*

阅读状态

工具	说明	关键参数
mark_as_read	将文章标记为已读。	article_id*
mark_as_unread	将文章标记为未读。	article_id*
mark_all_as_read	将所有文章标记为已读，可按 Feed 或文件夹筛选。	feed_id、folder_id

保存

工具	说明	关键参数
save_article	保存文章以便稍后阅读。	article_id*
unsave_article	从已保存项目中移除文章。	article_id*
save_url	保存外部 URL 以便稍后阅读。	url*
get_saved	列出已保存文章，支持搜索、日期筛选和排序。	limit、query、sort、date_from、date_to

订阅源与结构

工具	说明	关键参数
get_feeds	列出已订阅的订阅源及未读数量。支持按名称搜索。	folder_id、query、limit
get_folders	列出所有订阅源文件夹及订阅源数量。	-
get_tags	列出所有标签及文章数量。	-

标记

工具	说明	关键参数
create_tag	创建新标签，用于对文章分类。	name*、color
delete_tag	根据 ID 删除标签。	tag_id*
tag_article	为文章添加或移除标签。	article_id*、tag_id*、action*（add/remove）

高亮

工具	说明	关键参数
get_highlights	获取文章中的所有文本高亮。	article_id*
add_highlight	高亮一段文本。该文本必须与文章中的内容完全一致。	article_id*、text*、color
remove_highlight	移除文章中的一个高亮。	article_id*、highlight_id*

笔记

工具	说明	关键参数
get_notes	获取文章上的笔记。	article_id*
add_note	添加或更新文章上的笔记。	article_id*、content*
delete_note	删除文章上的笔记。	article_id*

历史记录

工具	说明	关键参数
get_recently_read	获取最近打开的文章。支持搜索和日期筛选。	limit、since、date_to、query、sort

输出订阅源

工具	说明	关键参数
get_output_feeds	列出用户创建的公开 RSS 输出订阅源。	-

AI

托管的 MCP 服务不提供 text_to_speech：该工具使用 AI 模型生成音频，而 Claude connectors 目录不允许此类功能。FeedNest 应用和 OpenClaw 插件仍支持朗读文章。

统计数据

工具	说明	关键参数
get_stats	阅读连续天数、今日已读文章数、阅读时长、订阅源总数、未读数量、已保存数量。	-

* = 必填参数

---

对话示例

You: "What's happening in AI today?"

ChatGPT: "Based on your tech feeds, here are today's 3 biggest stories:

1. OpenAI announced GPT-5, covered first in your Hacker News feed
2. EU AI Act enforcement begins, mentioned across 4 of your sources
3. Google published new Gemini research, from your AI folder

Want me to summarize any of them?"

你还可以这样提问

• “根据我的订阅源为我准备一份晨间简报”
• “比较 Bloomberg 和 Reuters 对这则新闻的报道”
• “我昨天读了什么？”
• “保存这篇文章并高亮关键发现”
• “为所有与 AI 相关的文章添加‘Machine Learning’标签”
• “我的阅读连续记录怎么样？”

---

身份验证

API 密钥（个人使用）

在 FeedNest 控制面板中，前往 Settings → Developer API 生成密钥。密钥以 fn_live_ 开头，后接 32 个十六进制字符。

Authorization: Bearer fn_live_abc123...

OAuth 2.1（第三方应用）

该服务支持完整的 OAuth 2.1 和 PKCE。发现端点：

https://mcp.feednest.com/.well-known/oauth-protected-resource

ChatGPT 和 Claude.ai 会自动处理 OAuth——无需 API 密钥。

套餐

通过 OAuth 连接的应用适用于所有 FeedNest 套餐。使用 API 密钥需要 Pro 套餐。

	Free	Plus	Pro
读取订阅源、文件夹、文章、已保存文章、标签、阅读历史记录和输出订阅源	是	是	是
文章高亮	是	是	是
笔记、highlighted 和 noted 视图、阅读统计数据	否	是	是
修改：标记为已读、保存、添加标签、高亮、添加笔记、加载文章全文	否	是	是
日期筛选（date_from、date_to、since）	否	否	是
每小时请求数	20 次工具调用	1,000	1,000
API 密钥	否	否	是

已连接的应用会在下次刷新令牌时（通常在一小时内）或重新连接 FeedNest 后立即应用套餐变更。

权限范围

权限范围	访问权限
read	所有只读工具（get_articles、get_feeds、get_stats 等）
write	所有修改类工具（mark_as_read、save_article、add_highlight 等）
ai	目前没有 MCP 工具（见上文的 AI 部分）

---

您始终掌控一切

• 由您决定显示哪些内容 - 精确选择 AI 可以访问的订阅源、文件夹和操作
• 加密且经过验证 - 每个请求都受到保护，确保他人无法访问您的数据
• 内置使用限制 - 每小时 1,000 次请求（Free 版可调用工具 20 次），保护您的账户安全
• 立即撤销访问权限 - 在仪表板中点击一次即可

---

故障排除

问题	解决方案
"Bearer token required"	检查 Authorization 标头是否设置正确
"Invalid API key format"	密钥必须以 fn_live_ 开头，后接 32 个十六进制字符
"Invalid or revoked API key"	在 Settings → Developer API 中重新生成
"API access requires a Pro subscription"	API 密钥需要 Pro 订阅。请在 feednest.com 升级，或通过 OAuth 连接，所有套餐均可使用
"...included in FeedNest Plus and Pro"	该账户使用的是 Free 版，应用可以读取订阅源、文章、已保存的文章、标签和高亮内容，但无法进行任何更改。升级后，请重新连接 FeedNest，让应用获取新的套餐权限。请参阅套餐
"Filtering by date is included in FeedNest Pro"	日期筛选需要 Pro 订阅。没有该功能时，文章仍会按从新到旧的顺序显示
"...includes 20 requests an hour from AI assistants"	Free 版的每小时请求额度已用完。请等待提示所示的时间后重试
"Rate limit reached"	请等待几分钟后重试
"Insufficient scope"	您的 API 密钥不具备所需的权限范围
Tools not appearing	更改 MCP 配置后，请重启您的 AI 客户端

---

软件包

此代码库是一个单仓库，包含 FeedNest MCP 服务的客户端库和插件。

软件包	npm	描述
@feednest/sdk		TypeScript SDK — FeedNest API v1 的类型化 HTTP 客户端
@feednest/openclaw		OpenClaw 插件 — 为 AI 助手提供 26 个 Agent 工具
Codex 插件	—	适用于 ChatGPT 和 Codex 的插件：包含技能和通过 OAuth 登录的 MCP 配置
Claude 插件	—	适用于 Claude Code 和 Cowork 的插件：包含支持 OAuth 的 MCP 服务、相同的技能，以及 /feednest:briefing 命令
@feednest/shared-tool-defs	private	共享的 Zod 架构和文本格式化工具（打包在插件中）

开发

npm install
npm run build    # Build all packages (sdk → shared-tool-defs → openclaw-plugin)
npm test         # Run all tests, including the Codex and Claude plugin checks
npm run type-check
npm run pack:codex-plugin   # ZIP of the Codex plugin for platform.openai.com/plugins

---

链接

• FeedNest - 应用
• 文档 - 包含各平台设置指南的完整文档
• 集成 - 查看所有 AI 集成

许可证

MIT