Agent Skills
› ArcReel/ArcReel
› setup-arcreel-skills
setup-arcreel-skills
GitHub指导用户配置Agent以连接ArcReel远程MCP服务,包括收集凭证、设置HTTP传输与鉴权、处理超时及重载配置,并调用list_projects验证连通性。
触发场景
需要接入ArcReel MCP服务
配置Agent远程工具访问
安装
npx skills add ArcReel/ArcReel --skill setup-arcreel-skills -g -y
SKILL.md
Frontmatter
{
"name": "setup-arcreel-skills",
"description": "将当前 Agent 宿主连接到 ArcReel 远程 MCP 服务并验证访问。"
}
接入 ArcReel
配置当前 Agent 宿主以使用 ArcReel 远程 MCP 服务。只修改宿主的 MCP 配置,不修改 ArcReel 项目。
收集凭证
向用户询问尚未提供的值:
- 以
/mcp结尾的 ArcReel MCP 端点 URL。 - 在 设置 → API Key 中创建的
arc-API Key。ArcReel 只在创建时完整显示一次新密钥。
用户可以把 API Key 提供给其明确选择且信任的当前 Agent。接收后只用于配置 ArcReel MCP:不在回复中复述,不写入 shell 历史、项目文件或提交的配置,并且仅发送给用户提供的 MCP 端点。
接线
- 确认端点使用
https、以/mcp结尾,且 API Key 以arc-开头。仅localhost、127.0.0.1或[::1]等回环端点可以使用http。 - 使用当前宿主原生的 MCP 配置方式,添加名为
arcreel的服务,传输方式为 streamable HTTP,鉴权方式为 Bearer。宿主支持环境变量或秘密引用时,用它保存 API Key;宿主只能保存明文请求头时,先说明密钥将写入的位置并取得确认。 - 使用 Codex 时,以
ARCREEL_API_KEY作为bearer_token_env_var,并把arcreel服务的tool_timeout_sec设为至少600;长时间生成任务可能超过 Codex 的默认超时。 - 宿主需要重载 MCP 配置时,完成重载。
验证
无参数调用一次 ArcReel MCP 工具 list_projects。调用成功并返回结构化 projects 列表即完成接入;空列表也是有效结果。
失败时报告出错边界,不得暴露 API Key:
- 鉴权失败:创建或复制有效的
arc-API Key,并更新 Bearer 秘密。 - 连接或宿主校验失败:检查公开的
/mcpURL 及服务端 MCP host/origin 白名单。 - 工具缺失:重载宿主 MCP 配置,并确认服务名为
arcreel。
版本历史
- 44d22bf 当前 2026-08-28 10:40


