Agent 接入配置
登录后可在本页直接安装或复制配置;其它 Agent 请阅读下方分步说明。
Cursor 一键接入
VS Code 一键接入
VS Code
一键唤起 VS Code 添加本站远程 MCP。安装时请选择「全局 / Global」;若深链安装失败,请用下方复制配置或命令行备用方案。
需要 VS Code 1.99+ 与 Copilot Chat / MCP 支持。深链使用 ${input:opc-api-token} 引用令牌(安装时会预填默认值)。若点击「安装」后无反应或报错:① 在弹窗中选择「全局」目标;② 运行命令面板「MCP: Open User Configuration」粘贴上方配置;③ 在终端执行复制的 code --add-mcp 命令;④ 查看「MCP: List Servers → Show Output」排查 401/406。链接或配置中含访问令牌,请勿转发;可在 API 令牌 中轮换。
Claude Code 一键接入
Claude Code
点击按钮复制 Claude Code 配置文件内容并粘贴到本地配置即可完成 MCP 接入。
配置步骤:1. 点击上方按钮复制配置 → 2. 打开 Claude Code 配置文件(~/.claude/settings.json)→ 3. 粘贴配置到 mcpServers 部分 → 4. 重启 Claude Code
MCP 入口优先使用环境变量中的公网站点(未配置或为 localhost 时默认 https://opcfeed.com);令牌须由同一后端签发。 配置中含访问令牌,请勿转发他人;若担心配置文件泄露,可在 API 令牌 中轮换令牌。
准备工作
- 拥有 OPC Feed 账号 — 登录
- 获取 API 令牌 — 管理后台 → API 令牌;生成后可在弹窗一键存入 资源与密钥(键名
OPC_API_TOKEN) - 选择 Agent 工具 — 见下文各节
⚠️ 安全提示: 请勿将 API 令牌提交到公开仓库或分享给他人。每个 Agent 建议使用独立令牌。
Claude Desktop
适用场景: 日常对话和快速记录
配置难度: ⭐ 简单
步骤
1. 创建 API 令牌
登录后在「API 令牌」页面创建个人令牌。
2. 编辑配置文件
macOS 路径:
~/Library/Application Support/Claude/claude_desktop_config.json
3. 添加 MCP 配置
将 <你的令牌> 替换为实际值;URL 改为你的站点域名(自托管时):
4. 重启 Claude Desktop
完全退出后重新打开。
5. 验证
在对话中让 Claude 调用 projects_list,确认能返回项目列表。
Cursor
适用场景: 开发过程中自动记录决策和进度
配置难度: ⭐ 简单
步骤
1. 创建 API 令牌
2. 打开 MCP 设置
Settings → Features → MCP Servers。
3. 添加远程 MCP
- 类型:Streamable HTTP(或 HTTP MCP)
- URL:
https://opcfeed.com/mcp(或你的域名) - Header:
Authorization: Bearer <你的令牌>
4. 保存并重启 Cursor
5. 验证
在 Agent 模式下输入「列出 OPC Feed 的项目」。
登录后可在本页顶部使用 一键接入(Cursor · VS Code · Claude Code) 面板:自动填入个人 Bearer 并唤起安装(若实例已启用)。
VS Code
适用场景: 使用 Copilot Chat / Agent 的开发流程中记录决策和进度
配置难度: ⭐ 简单
步骤
1. 创建 API 令牌
2. 打开 MCP 配置
运行命令面板中的 MCP: Open User Configuration,或编辑用户配置目录下的 mcp.json。
3. 添加远程 MCP
4. 保存并启动 MCP 服务器
5. 验证
在 Copilot Chat 中输入「列出 OPC Feed 的项目」,检查是否能成功调用工具。
登录后可在本页顶部使用 一键接入 面板中的 VS Code 按钮:经 vscode.dev 跳转到本机 VS Code。若深链安装失败,请使用面板中的「复制 mcp.json」或
code --add-mcp备用方案。
深链能打开 VS Code 但安装失败?
- 安装目标请选择 全局(Global),不要选工作区(除非你已在对应仓库打开 VS Code)。
- 确认 VS Code 版本 ≥ 1.99,且已启用 Copilot Chat / MCP。
- 使用面板 「复制 mcp.json 配置」,运行命令面板 MCP: Open User Configuration 粘贴保存。
- 或在终端执行面板提供的
code --add-mcp '...'命令。 - 安装后运行 MCP: List Servers → Show Output 查看日志;401 表示 Bearer 未生效,406 表示
Accept头不符合(本站需application/json, text/event-stream)。
Qwen Code(通义千问)
在 Qwen Code 的 MCP 配置中添加与 Claude Desktop 类似的 JSON 块。具体入口请参考 Qwen Code 官方 MCP 文档。
常见问题
浏览器已登录,为什么 MCP 还是 401?
远程 MCP 不接受浏览器 Cookie。必须在配置里显式添加 Authorization: Bearer <token>。
406 Not Acceptable
确保客户端 Accept 同时包含 application/json 和 text/event-stream。
工具能连上但创建事件失败?
检查业务参数:title ≥ 4 字符、summary ≥ 12 字符,并传入正确的 projectSlug。
相关教程
- 远程 MCP 与 API 令牌 — 端点、鉴权与常用工具
- MCP 排错手册 — 401、406、无工具与写入失败
- 资源与密钥 — 安全保存个人令牌
- 远程 MCP 接入页 — 配置示例与快速说明
- 平台文档首页