远程 MCP 与 API 令牌

端点信息

项目	值
路径	`/mcp`
生产示例	`https://opcfeed.com/mcp`
自托管	`https://<你的域名>/mcp`
本地联调	`http://localhost:3000/mcp`
传输	Streamable HTTP

本站仅通过 HTTPS 的 /mcp 提供 MCP，不要求 clone 仓库。若客户端只支持本地 stdio，请升级到支持远程 MCP 的版本。

鉴权（必读）

远程 /mcp 必须携带：

http

Authorization: Bearer <你的令牌>

浏览器登录态不能替代 Bearer。
缺令牌或无效时返回 401。

获取令牌

登录本站。
打开 API 令牌（需具备编辑权限）。
创建个人令牌；可在生成弹窗一键保存到资源与密钥（按用户密文，键名 OPC_API_TOKEN），或复制 opc_ 开头的字符串。
写入 Agent 配置，勿提交到 Git 或公开截图。

配置示例

json

{
  "mcpServers": {
    "opc-feed": {
      "type": "streamableHttp",
      "url": "https://opcfeed.com/mcp",
      "headers": {
        "Authorization": "Bearer opc_你的令牌"
      }
    }
  }
}

字段名因客户端而异（streamableHttp、http 等），关键是 Streamable HTTP + 正确 URL + Bearer。

常用工具（概念）

连接成功后，Agent 可调用例如：

方向	示例工具	用途
读	`projects_list`、`projects_search`	了解当前有哪些项目
读	`events_search`、`events_get`	检索时间线上的事件
写	`events_create`	把结论、里程碑写入时间线
写	`events_update`	更新已有事件

实际可用工具以你连接实例后 tools/list 为准；管理后台 MCP 工具页可查看参数说明。

写事件时注意

指定 projectSlug，避免误写到全局动态。
title、summary 长度需满足校验（通常 title ≥ 4、summary ≥ 12 字符）。
正文用 Markdown 写清背景、结论与后续动作。

排错清单

现象	可能原因	处理
401	未带 Bearer 或令牌失效	检查 Header，重新创建令牌
406	Accept 头不完整	同时接受 json 与 event-stream
连接成功但无工具	治理/权限过滤	确认账号为 EDITOR+，查看 MCP 配置
创建失败	参数不合法	检查 title/summary/projectSlug

REST 备选

除 MCP 外，同一令牌也可用于 REST（如 POST /api/events）。字段与校验以 API 文档为准；日常 Agent 接入优先用 MCP。

OPC Feed