连接 Agent
连接 Claude、Codex、Cursor 或 Pi，用现有订阅积分修图，结果回到 ClearCrowds 编辑器。
让常用的 Agent 帮你修照片，使用现有 ClearCrowds 订阅和个人积分。
打开编辑器，连接 Agent →连接并安装
- 登录 ClearCrowds，在编辑器左侧点击「连接 Agent」，选择你的助手。
- Codex 可直接打开并预填连接提示词；其他本地客户端复制提示词后发送。提示词同时包含 MCP 配置和个人修图 Skill 安装。Cursor 的原生安装链接只添加 MCP，仍需发送完整提示词安装 Skill。
- 在浏览器核对账号并点击「允许连接」，然后回到客户端完成登录。
- Agent 检查账号和可用功能。连接检查与 Skill 安装不会生成图片或消耗积分。
「我的连接」显示实际已验证的连接。点击铅笔可填写设备名称，例如「George MacBook Pro · Codex」；已有连接可点「复制安装指令」补装 Skill。MCP 已连接不代表本地 Skill 已安装，需由客户端检查文件并刷新发现。
调用 ClearCrowds
| 客户端 | 主动调用 | Skill 保存位置 |
|---|---|---|
| Codex | $clearcrowds | ~/.agents/skills/clearcrowds/SKILL.md |
| Claude Code | /clearcrowds | ~/.claude/skills/clearcrowds/SKILL.md |
| Cursor | /clearcrowds | ~/.cursor/skills/clearcrowds/SKILL.md |
| Pi | /skill:clearcrowds | ~/.pi/agent/skills/clearcrowds/SKILL.md |
也可以直接说「用 ClearCrowds 修这张照片」，让支持自动选择 Skill 的客户端调用。新安装的 Skill 未出现在列表时，按客户端要求刷新或新开会话；Pi 可用 /reload。
浏览器版 Claude、Grok 使用远程 MCP 和自然语言调用，不会自动安装电脑上的 Skill。Other 会根据当前客户端能力选择配置方式。Pi 需要已安装且支持远程 MCP 的适配器，不能把并不存在的通用命令当成安装方法。各客户端没有统一的 @clearcrowds 命令。
试着修改一张照片
- 在编辑器的「我的连接」中选择助手，点击「交给 Agent 一张照片」，明确分享要修改的图片。
- 选择「换城市背景」「修改图片文字」或「移除背景路人」，填好要求，将提示词发送给助手。提示词绑定你选中的照片，不会改到另一张。
- 收到明确要求后，助手直接使用现有积分修图，不再要求确认积分。完成后返回预览和编辑器链接，结果保存在同一照片的编辑历史中。
例如：
请用 ClearCrowds 将我分享的这张照片背景换成城市夜景，保留人物外貌和姿势，让光线自然融合。也可交给 Agent 一个明确选择的本地文件。客户端先上传文件，再调用修图；远程 MCP 本身不能读取你电脑上的路径或聊天附件。是否能读取附件取决于客户端实际提供的文件访问能力。
手动配置 MCP
远程地址：https://app.clearcrowds.com/api/agent/mcp。传输方式为 Streamable HTTP，使用浏览器 OAuth 登录，不需要把密码或令牌粘贴到聊天中。
以下是正式服务的命令；本地测试时使用编辑器生成的实际地址。
Codex
codex mcp add clearcrowds --url https://app.clearcrowds.com/api/agent/mcp
codex mcp login clearcrowdsClaude Code
claude mcp add --transport http --scope user clearcrowds https://app.clearcrowds.com/api/agent/mcp
claude mcp login clearcrowds也可在 Claude Code 中用 /mcp 完成登录。Cursor、Claude 和其他支持远程 MCP 的客户端添加上面的地址并完成浏览器授权；具体入口以客户端当前版本为准。
下载个人图像 Skill（SKILL.md），保存到上表中对应的目录。它包含 MCP 地址、明确选图、本地上传、直接生图与修图、任务查询与返回编辑器的操作说明。
积分、权限与常见问题
- 用哪种积分？ 使用与编辑器相同的订阅及个人余额；不需要开发者项目、API Key 或单独充值 API Credits。余额不足时提示管理积分，不会自动购买。
- 为什么找不到照片？ 必须把照片明确分享给这条连接；重新选择并分享，再发送新提示词。
- 登录成功却不能调用？ 让客户端刷新 MCP 工具，调用
account、capabilities检查；仅弹出授权页面不代表已完成实际换码和连接验证。 - 为什么系统要求访问凭据？ OAuth 凭据由客户端自行保存；系统凭据提示属于客户端的存储机制。ClearCrowds 不读取钥匙串，也不要求在聊天里提供凭据。
- 如何断开？ 在「我的连接」里断开，访问权限立即撤销。助手只能访问明确分享的图片、经该连接上传的图片及该连接生成的结果，不能浏览整个图库。
开发者项目集成使用独立的 API Credits 和 CLI，与上述个人订阅流程分开。
从文字直接生成图片
连接后直接告诉 Agent 想要什么，例如：“生成一张日出时湖边小木屋的横向图片。”不需要先上传或分享原图。
Agent 调用 quote_generation，传入 prompt 和可选的 aspect_ratio（1:1、3:2、2:3、16:9、9:16），随后直接用原报价调用 generate_image。明确的生成要求即授权使用已有个人订阅额度，无需再确认积分；用户明确指定的预算仍须遵守。提交时预留额度，结果持久化交付后计费，失败释放预留。
网络重试复用原报价，通过 get_job 查询同一任务，返回预览与 editor_url。结果保存在 ClearCrowds 图片历史，也可以继续通过当前连接修图。仅检查连接或安装 Skill 不生成图片、不消耗积分。