← MCP & Skills

连接你的 Agent

MCP 提供报告工具，Skill 规定数据分析、大纲和查询流程。完成配置、浏览器授权和工具发现后，再开始创建报告。

文档与官方资料核对日期: · 不等于全部客户端实测日期

开始前准备

准备官网账号、可用工作区和支持远程 Streamable HTTP 与 OAuth 的客户端。授权由用户完成，客户端管理回调与 Token，不要把密钥或 Token 发到对话里。以下配置需合并到已有配置，避免覆盖其他服务。

https://www.algforce.com/mcp

WorkBuddy

已完成测试环境连接与报告生成验证

验证依据为已有用户测试记录，未记录准确客户端版本；不代表所有版本均已验证。

  1. 在 MCP 服务管理中添加服务，选择 Streamable HTTP，并填写下方地址；也可合并 JSON 到现有配置，保留其他服务。
  2. 点击认证，在浏览器登录、选择工作区并同意授权。回调由 WorkBuddy 管理，无需填写固定回调地址或密钥。
  3. 从 SkillHub 安装报告 Skill；若使用连接器包，请确认已包含并加载配套 Skill。尚未公布官网一键安装连接器入口。
  4. 在客户端确认发现 create_report 和 get_report。内置预览需要实际可用的浏览器工具；否则展示可点击链接。
{
  "mcpServers": {
    "algforce-reports": {
      "type": "streamableHttp",
      "url": "https://www.algforce.com/mcp",
      "timeout": 30000
    }
  }
}

WorkBuddy Connector ↗

Codex

依据官方文档；尚未完成本服务联调

以下为 CLI 方式；IDE 扩展也可在 MCP 设置中添加 URL，并使用 Authenticate。

  1. 确认当前安装提供 codex mcp 命令。已有同名服务时先检查配置，避免覆盖。
  2. 在终端添加服务并启动登录，完成浏览器授权和工作区选择。
  3. 按下方通用方法加载 Skill。必要时重新加载客户端；在当前会话的 /mcp 中确认两个工具可用，仅出现在配置列表中不等于连接成功。
codex mcp add algforce-reports --url https://www.algforce.com/mcp
codex mcp login algforce-reports
codex mcp list

Codex MCP ↗

Claude Code

依据官方文档；尚未完成本服务联调

示例使用用户级配置，跨项目可用。不要把 WorkBuddy 的 type 字段原样复制到 Claude Code。

  1. 在终端添加 HTTP 服务。启动 Claude Code 后输入 /mcp，选择此服务进行认证。
  2. 完成浏览器授权和工作区选择，再按下方通用方法加载报告 Skill。
  3. 在当前会话确认两个工具可用；如尚未加载，按客户端提示重新连接或启动新会话。
claude mcp add --transport http --scope user algforce-reports https://www.algforce.com/mcp
claude mcp list

Claude Code MCP ↗

Hermes Agent

依据官方文档；尚未完成本服务联调

合并到 ~/.hermes/config.yaml 的 mcp_servers，保留已有条目。远程或 SSH 部署须按官方指南处理回调，不能直接假设本机浏览器可连到远程回调端口。

  1. 添加下方 OAuth 配置，随后在新终端运行 hermes mcp login algforce-reports。
  2. 完成浏览器授权，按下方方法加载 Skill，再重新启动或重新加载实际执行任务的会话。
  3. 在该会话中确认两个工具已注册。不要使用设备码登录方案，本服务没有声明设备授权端点。
mcp_servers:
  algforce-reports:
    url: "https://www.algforce.com/mcp"
    auth: oauth

Hermes MCP ↗

OpenClaw

依据官方文档；尚未完成本服务联调

仅针对支持 OAuth 的 Gateway/嵌入运行方式；node-hosted v1 路径不支持 OAuth。下方示例适用于单一使用者，多用户部署需按官方文档配置 per-requester 身份及 gateway.publicOrigin。

  1. 确认当前版本及运行方式支持 mcp.servers 的远程 OAuth 配置，并合并下方内容到现有 openclaw.json。
  2. 运行 openclaw mcp login algforce-reports，完成浏览器授权。按客户端要求重新加载 Gateway。
  3. 按下方方法加载 Skill。确认实际执行任务的 Agent 能调用两个工具，保存配置或完成登录不代表每一种运行方式都已加载工具。
{
  "mcp": {
    "servers": {
      "algforce-reports": {
        "url": "https://www.algforce.com/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

OpenClaw MCP configuration ↗OpenClaw node-hosted limitations ↗

加载 Skill 并验证连接

各客户端的技能目录和重新加载方式不同。复制以下英文安装指令，让 Agent 按当前客户端确定目录并保留 references。无法持久安装时，读取完整 /mcp.md，在当前会话遵循指南。安装 Skill 不会自动配置 MCP 或完成授权。

SkillHub · @org-9c0xwtir/algforce-report-v1 · v1.0.0
Follow https://skillhub.cn/install/skillhub.md to install @org-9c0xwtir/algforce-report-v1 from SkillHub (https://skillhub.cn/skills/org-9c0xwtir/algforce-report-v1) in this client's supported skills directory, preserving references/. Determine the correct directory for this Agent. Follow the client's permission requirements and explain unsupported steps. Restart or reload the client if needed. If persistent installation is unsupported, explain that limitation and use the complete instructions from the MCP introduction page for the current conversation instead; do not claim the Skill is installed. Installing the Skill does not configure MCP or complete OAuth.

只验证连接，不生成报告

Read https://www.algforce.com/mcp.md and the complete Skill and outline reference. Verify that this session has an authorized MCP connection exposing create_report and get_report. Report any missing setup, Skill loading, or authorization step. Do not create a report, invent a job_id, or claim successful connection from a saved configuration alone.

验收标准是当前会话实际发现 create_report 和 get_report。发现工具不会创建报告。创建报告须明确请求，并受工作区额度限制。

连接遇到问题？

  • 收到 HTML 或 405：确认添加的是 /mcp 服务地址，并选择 Streamable HTTP，而不是 SSE；普通浏览器打开 /mcp 显示介绍页是正常的。
  • 401 或需要认证：使用客户端登录入口完成 OAuth；403：重新检查授权范围和工作区权限。不要通过对话粘贴 Token 解决。
  • 工具未出现：检查服务是否启用、实际 Agent 的工具权限和配置是否重新加载。记录客户端版本及错误日志，再判断兼容性。
工具参数与错误说明三页演示案例