Agent · 接入指南
将 OPC Feed 接入你的 AI Agent
一站式配置指南,支持 Claude Desktop、Cursor、Qwen Code 等主流 AI Agent。选择你的工具,按照步骤完成配置,让 Agent 帮你自动记录项目决策和进度。
快速开始
在开始配置之前,请确保你已完成以下准备工作:
- 拥有一个 OPC Feed 账号(登录)
- 获取 API 令牌(管理后台 → API 令牌)
- 选择你想使用的 AI Agent 工具
安全提示:请勿将 API 令牌提交到公开仓库或分享给他人的。每个 Agent 建议使用独立的令牌。
推荐
推荐使用的 Agent
以下工具经过验证,与 OPC Feed 集成良好,适合大多数场景
Claude Desktop
Anthropic 官方桌面应用,适合日常对话和快速记录
配置文件位置
~/Library/Application Support/Claude/claude_desktop_config.json配置步骤
- 1
获取 API 令牌
登录管理后台,在"API 令牌"页面创建个人令牌
推荐创建一个专用令牌,方便后续管理 - 2
找到配置文件
打开终端,创建或编辑 Claude Desktop 配置文件
bashmkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json - 3
添加配置
在配置文件中添加以下 JSON,替换 <你的令牌> 为实际值
json{ "mcpServers": { "opc-feed": { "url": "https://opcfeed.com/mcp", "headers": { "Authorization": "Bearer <你的令牌>" } } } }确保 JSON 格式正确,无语法错误 - 4
重启 Claude Desktop
完全退出并重新打开 Claude Desktop 应用
- 5
验证连接
在对话中让 Claude 调用 projects_list 工具,确认能获取到项目列表
验证连接
在 Claude 对话框中输入"列出所有项目",如果 Claude 能成功调用 projects_list 并返回项目列表,说明配置成功
注意事项
- •配置文件必须是有效的 JSON,注意引号和逗号
- •令牌不要包含换行符或额外空格
- •可以配置多个 MCP Server,每个用不同的名称
- •如果看不到工具列表,检查配置文件路径是否正确(macOS vs Windows)
Claude Code
Anthropic 官方 CLI 工具,适合命令行重度用户和自动化工作流
配置文件位置
~/.claude/settings.json配置步骤
- 1
获取 API 令牌
登录管理后台,创建个人 API 令牌
或使用入门页的一键配置功能自动生成配置 - 2
打开配置文件
在终端中打开 Claude Code 配置文件
bash# Windows notepad %USERPROFILE%\.claude\settings.json # macOS/Linux nano ~/.claude/settings.json - 3
添加 MCP 配置
在配置文件的 mcpServers 部分添加以下配置
json{ "mcpServers": { "opc-feed": { "transport": "http", "url": "https://opcfeed.com/mcp", "headers": { "Authorization": "Bearer <你的令牌>" } } } }如果 mcpServers 部分已存在,只需添加 opc-feed 配置项 - 4
保存并重启
保存配置文件后,重启 Claude Code 或重新加载终端
- 5
验证连接
在 Claude Code 对话中,让它调用 projects_list 工具
验证连接
在 Claude Code 中输入"列出所有项目",检查是否能成功调用工具并返回结果
注意事项
- •Claude Code 支持三种 MCP 传输协议:HTTP、SSE、stdio
- •HTTP 协议是最稳定的选择,推荐使用
- •配置文件必须是有效的 JSON,注意引号和逗号
- •可以在项目、用户、本地三个范围配置 MCP
Cursor
AI 代码编辑器,适合开发过程中自动记录决策和进度
配置步骤
- 1
获取 API 令牌
登录管理后台,创建个人 API 令牌
- 2
打开 Cursor MCP 设置
在 Cursor 中,打开 Settings > Features > MCP Servers
- 3
添加远程 MCP Server
点击"Add Server",选择"Streamable HTTP"类型,填入以下信息:
text名称: opc-feed 类型: Streamable HTTP (或 HTTP MCP) URL: https://opcfeed.com/mcp Headers: Authorization: Bearer <你的令牌>字段名称可能因 Cursor 版本略有不同 - 4
保存并重启
保存配置后,重启 Cursor 或重新加载窗口
- 5
验证连接
在 Cursor Agent 对话中,让它调用 projects_list 或 events_search 工具
验证连接
在 Cursor 的 Agent 模式下,输入"列出 OPC Feed 的项目",检查是否能成功调用工具并返回结果
注意事项
- •选择「Streamable HTTP」/「HTTP MCP」,勿选需本地 command 的 stdin 模式
- •Cursor 规则文件 .cursor/rules/opc-pm-partner.mdc 已包含项目管理习惯
- •开发过程中可以让 Agent 自动记录提交和决策到时间线
- •如遇 406 错误,检查 Accept header 是否同时包含 application/json 和 text/event-stream
Qwen Code(通义千问)
阿里的 AI 编程助手,支持 MCP 协议
配置步骤
- 1
获取 API 令牌
登录管理后台,创建个人 API 令牌
- 2
配置 MCP 连接
在 Qwen Code 的设置或配置文件中添加远程 MCP Server
json{ "mcpServers": { "opc-feed": { "url": "https://opcfeed.com/mcp", "headers": { "Authorization": "Bearer <你的令牌>" } } } }具体配置方式请参考 Qwen Code 官方文档中的 MCP 配置说明 - 3
验证连接
在 Qwen Code 对话中测试工具调用
验证连接
在 Qwen Code 中让它"搜索 OPC Feed 项目",确认能调用 projects_search 并返回结果
注意事项
- •Qwen Code 对中文支持良好,可以用自然语言描述意图
- •确保使用最新版本的 Qwen Code 以支持远程 MCP
- •配置方式与 Cursor 类似,都是添加远程 MCP Server
常见问题
常见问题
配置过程中可能遇到的问题及解决方案
浏览器已登录,为什么还显示 401?
远程 MCP 不接受浏览器 Cookie 或登录态。你必须在配置中显式添加 Authorization: Bearer <token> Header。这是为了保证 API 调用的安全性和可追溯性。
能连接上 MCP,但工具调用失败?
这通常是业务参数的问题,而非连接失败。请检查:
title是否 ≥ 4 字符summary是否 ≥ 12 字符- 是否传入了正确的
projectSlug
为什么只提供远程 MCP?
本站通过 HTTPS 的 Streamable HTTP(/mcp)暴露 MCP,无需 clone 仓库。请在客户端选择远程 MCP 类型并配置 URL 与 Bearer 令牌;若客户端仅支持本地 stdio,请升级到支持远程 MCP 的版本。
406 Not Acceptable 错误如何解决?
这通常是因为 Accept Header 不完整。确保同时包含 application/json 和 text/event-stream。
大多数客户端会自动处理,如果遇到此问题,检查客户端文档确认配置方式。
相关文档
需要更多帮助?