企业官网建设流程全解析

如何把 Claude Code、Codex 或 Cursor 通过 Cap CLI、Skill 和本地 MCP 接入 Cap？

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap

如果你想在 Claude Code、Codex 或 Cursor 里直接完成 Cap 的录屏、上传、查转录、管理库等操作，而不依赖 Cap Dashboard 的页面自动化，就需要走 Cap 官方的 Agent 接入路径：安装 Cap CLI（自带 Skill 与本地 MCP 配置能力），以最简权限完成登录，然后为当前 Agent 安装 Cap Skill 和cap mcp serve本地 MCP 条目。安装完成后，Agent 会持久地优先通过 CLI 或 MCP 操作 Cap，而不是打开浏览器控制 Dashboard。

接入的组成

Cap 文档把 Agent 接入拆成三层，缺一不可：

• Cap CLI：通用通道。任何能执行终端命令的 Agent 都可以直接用它，每个命令都支持--json输出机器可读结果；record和export会流式输出 NDJSON 事件。
• Cap Skill：安装到 Agent 的全局 skill 目录，作用是让 Agent 在遇到 Cap 相关任务时优先走 CLI 或 MCP，而不是浏览器自动化；它把命令细节委托给cap guide --json，所以指令始终跟已安装版本对齐。
• 本地 MCP：cap mcp serve以本地 stdio 方式暴露结构化的 Cap 工具，适合库读取、安全写入和资源操作；密码、S3 凭证等敏感输入和本地文件操作刻意保留在 CLI 一侧。

第一步：安装 Cap CLI

CLI 与 Cap Desktop 打包在同一个二进制里，两者版本保持一致。三种安装方式任选其一：

• 已装 Cap Desktop：打开Settings → Command Line → Install CLI，把自带的cap二进制链接到 PATH。
• macOS 或 Linux 终端：

curl -fsSL https://cap.so/install-cli.sh | sh

• Windows PowerShell：

irm https://cap.so/install-cli.ps1 | iex

安装脚本会把cap加入 PATH，Cap Desktop 缺失时会先下载安装它。安装副作用：修改 PATH 相关 shell 配置、可能下载并安装 Cap Desktop。安装后需要打开一个新的终端再验证：

cap version --json cap guide --json

cap guide --json返回完整的能力契约（capability manifest），文档要求 Agent 从它和cap <command> --help发现当前命令的参数，而不是照抄旧命令列表。

第二步：以最小权限登录

先检查当前认证状态：

cap auth status --json

需要登录时在浏览器中完成授权：

cap auth login --json

登录默认使用creator配置档；只有任务确实需要时才请求更宽的档位：

cap auth login --profile admin --json cap auth login --profile full --json

CLI 凭证在系统支持时由操作系统保管，cap auth status不会打印密钥。无浏览器的 CI/容器环境改用 Dashboard 的 API key：在 Cap Dashboard 的 Settings → Account 页面找到Cap CLI access，Create API key 并选择配置档和过期时间，把 key 以CAP_API_KEY或CAP_AGENT_TOKEN环境变量注入（两者都会被识别）后用cap auth status --json验证。注意 Cap 只存 hash，key 显示一次后无法再次查看。

第三步：为指定 Agent 安装 Skill 与 MCP

针对 Codex、Claude Code、Cursor 各用一条--target命令，先 dry-run 预览将要修改的配置，确认无误后加--yes应用：

# Codex cap agents install --target codex --component all --dry-run --json cap agents install --target codex --component all --yes --json # Claude Code cap agents install --target claude --component all --dry-run --json cap agents install --target claude --component all --yes --json # Cursor cap agents install --target cursor --component all --dry-run --json cap agents install --target cursor --component all --yes --json

--component all会写入全局 Cap Skill，并向该 Agent 的配置合并一条本地cap mcp serve条目，不会覆盖其他无关配置。应用后重启对应 Agent，让新会话加载 Skill 和 MCP server；新装的 MCP server 可能需要重启当前进程才会出现。

--component也可以单独传skill或mcp。官方文档还描述了另一条更快的路径：在 Cap for Agents 页面复制 Agent Setup Prompt 粘贴给 Agent，该 prompt 本身即为一次性的本地安装授权（仅限当前 Agent），Agent 会自行完成 CLI 安装、Skill 与 MCP 配置，只在浏览器登录或安全终端交接时停下；这套设置授权不延伸到 Cap 账号数据或任何变更操作。

如果用的 MCP 客户端支持本地 stdio 但不被cap agents install覆盖，手动配置：

{ "command": "cap", "args": ["mcp", "serve"] }

cap mcp serve必须保持 stdio 独占 stdout，stdout 只承载 MCP 协议消息，不能被其他进程包装或记日志。

验证接入结果

让 Agent 跑一遍只读检查：

cap version --json cap guide --json cap auth status --json cap caps list --limit 1 --json

文档给出的正确结果判据：

• stdout 是合法 JSON；
• 账号相关操作前认证状态正常；
• 库检查返回一个 Cap 结果或空列表，而不是 Agent 猜出来的答案；
• cap auth status不打印任何密钥值；
• 验证过程没有做任何变更。

MCP 已安装时，再让 Agent 列出可用 Cap 工具：应能找到caps_list、caps_context等读取工具；密码和存储凭证不应出现在 MCP 输入里。

常见故障

• cap找不到：刷新 shell 环境后重跑cap version --json；在官方 setup 流程内 Agent 应自行选择平台安装脚本安装，而不是切换到浏览器自动化。
• 认证失败：跑cap auth status --json，必要时cap auth login --json完成浏览器授权；自托管 Cap 需先确认CAP_SERVER_URL指向目标服务器。
• Agent 猜参数或输出结构：停下来跑cap guide --json和cap <command> --help，已安装的二进制是唯一事实来源。
• MCP 不可用：确认客户端启动的是本地命令cap mcp serve、cap在该客户端的 PATH 上、stdout 未被包装；新装的 MCP 可能需要重启 Agent。回退方案是直接 CLI 命令，而不是浏览器自动化。
• 命令被拒（forbidden）：读返回的权限信息；只有任务确实需要且用户同意时才换更宽配置档重新登录，不能绕过服务端强制的拒绝。

退出码约定：1是运行时失败（查 JSONerror字段），2是命令用法错误（应查--help而不是重试猜参数）。

下一步

验证通过后，可以从 Agent Workflows 里选一个场景开始，例如让 Agent 总结某条 Cap、搜索库或录一段 bug 复现并上传。涉及管理员、账单、存储或破坏性操作前，建议先读 Safety & Troubleshooting：所有变更类操作必须先看提案再确认，--yes和 MCP 的confirmed=true只能在显式批准之后使用；持久化操作返回 operation ID 后要cap jobs wait到终态，"accepted" 不等于成功。

更多背景可查 Set Up Your Agent、Cap CLI README 和 Cap Skill 定义。

【免费下载链接】CapOpen source Loom alternative. Beautiful, shareable screen recordings.项目地址: https://gitcode.com/GitHub_Trending/cap1/Cap