One Person Company · Event feed

OPC Feed

Agent · 接入指南

将 OPC Feed 接入你的 AI Agent

一站式配置指南,支持 Claude Desktop、Cursor、Qwen Code 等主流 AI Agent。选择你的工具,按照步骤完成配置,让 Agent 帮你自动记录项目决策和进度。

快速开始

在开始配置之前,请确保你已完成以下准备工作:

  1. 拥有一个 OPC Feed 账号(登录
  2. 获取 API 令牌(管理后台 → API 令牌
  3. 选择你想使用的 AI Agent 工具

安全提示:请勿将 API 令牌提交到公开仓库或分享给他人的。每个 Agent 建议使用独立的令牌。

推荐

推荐使用的 Agent

以下工具经过验证,与 OPC Feed 集成良好,适合大多数场景

🤖

Claude Desktop

Anthropic 官方桌面应用,适合日常对话和快速记录

推荐
对话应用简单远程 MCP

配置文件位置

~/Library/Application Support/Claude/claude_desktop_config.json

配置步骤

  1. 1

    获取 API 令牌

    登录管理后台,在"API 令牌"页面创建个人令牌

    推荐创建一个专用令牌,方便后续管理
  2. 2

    找到配置文件

    打开终端,创建或编辑 Claude Desktop 配置文件

    bash
    mkdir -p ~/Library/Application\ Support/Claude && touch ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. 3

    添加配置

    在配置文件中添加以下 JSON,替换 <你的令牌> 为实际值

    json
    {
      "mcpServers": {
        "opc-feed": {
          "url": "https://opcfeed.com/mcp",
          "headers": {
            "Authorization": "Bearer <你的令牌>"
          }
        }
      }
    }
    确保 JSON 格式正确,无语法错误
  4. 4

    重启 Claude Desktop

    完全退出并重新打开 Claude Desktop 应用

  5. 5

    验证连接

    在对话中让 Claude 调用 projects_list 工具,确认能获取到项目列表

验证连接

在 Claude 对话框中输入"列出所有项目",如果 Claude 能成功调用 projects_list 并返回项目列表,说明配置成功

注意事项

  • 配置文件必须是有效的 JSON,注意引号和逗号
  • 令牌不要包含换行符或额外空格
  • 可以配置多个 MCP Server,每个用不同的名称
  • 如果看不到工具列表,检查配置文件路径是否正确(macOS vs Windows)
查看详细文档

Claude Code

Anthropic 官方 CLI 工具,适合命令行重度用户和自动化工作流

推荐
IDE / 编辑器简单远程 MCP

配置文件位置

~/.claude/settings.json

配置步骤

  1. 1

    获取 API 令牌

    登录管理后台,创建个人 API 令牌

    或使用入门页的一键配置功能自动生成配置
  2. 2

    打开配置文件

    在终端中打开 Claude Code 配置文件

    bash
    # Windows
    notepad %USERPROFILE%\.claude\settings.json
    # macOS/Linux
    nano ~/.claude/settings.json
  3. 3

    添加 MCP 配置

    在配置文件的 mcpServers 部分添加以下配置

    json
    {
      "mcpServers": {
        "opc-feed": {
          "transport": "http",
          "url": "https://opcfeed.com/mcp",
          "headers": {
            "Authorization": "Bearer <你的令牌>"
          }
        }
      }
    }
    如果 mcpServers 部分已存在,只需添加 opc-feed 配置项
  4. 4

    保存并重启

    保存配置文件后,重启 Claude Code 或重新加载终端

  5. 5

    验证连接

    在 Claude Code 对话中,让它调用 projects_list 工具

验证连接

在 Claude Code 中输入"列出所有项目",检查是否能成功调用工具并返回结果

注意事项

  • Claude Code 支持三种 MCP 传输协议:HTTP、SSE、stdio
  • HTTP 协议是最稳定的选择,推荐使用
  • 配置文件必须是有效的 JSON,注意引号和逗号
  • 可以在项目、用户、本地三个范围配置 MCP
💻

Cursor

AI 代码编辑器,适合开发过程中自动记录决策和进度

推荐
IDE / 编辑器简单远程 MCP

配置步骤

  1. 1

    获取 API 令牌

    登录管理后台,创建个人 API 令牌

  2. 2

    打开 Cursor MCP 设置

    在 Cursor 中,打开 Settings > Features > MCP Servers

  3. 3

    添加远程 MCP Server

    点击"Add Server",选择"Streamable HTTP"类型,填入以下信息:

    text
    名称: opc-feed
    类型: Streamable HTTP (或 HTTP MCP)
    URL: https://opcfeed.com/mcp
    Headers: Authorization: Bearer <你的令牌>
    字段名称可能因 Cursor 版本略有不同
  4. 4

    保存并重启

    保存配置后,重启 Cursor 或重新加载窗口

  5. 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 协议

推荐
IDE / 编辑器简单远程 MCP

配置步骤

  1. 1

    获取 API 令牌

    登录管理后台,创建个人 API 令牌

  2. 2

    配置 MCP 连接

    在 Qwen Code 的设置或配置文件中添加远程 MCP Server

    json
    {
      "mcpServers": {
        "opc-feed": {
          "url": "https://opcfeed.com/mcp",
          "headers": {
            "Authorization": "Bearer <你的令牌>"
          }
        }
      }
    }
    具体配置方式请参考 Qwen Code 官方文档中的 MCP 配置说明
  3. 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

大多数客户端会自动处理,如果遇到此问题,检查客户端文档确认配置方式。