Mercator setup 技能用于在代理客户端中安装、连接或排查 Mercator，覆盖插件设置、OAuth 授权、工具缺失修复、连接诊断和钱包相关配置。它提供免费检查来验证就绪状态，连接与设置本身不需要付费任务或本地支付钱包。
用途：帮助用户将 Mercator 接入所选客户端并确认可用性，包括安装、修复连接、诊断工具缺失和排查 OAuth 问题；也关注钱包访问与付款政策配置，但明确区分连接就绪与自动付款就绪。
主要能力与流程：
- 先识别用户的应用与模式，不明确时询问；不从代理在沙箱中运行命令的能力推断本地终端访问。
- 针对不同客户端提供连接方式：
- Claude Desktop 聊天或 claude.ai：引导至 Customize → Connectors → Add custom connector，命名为 Mercator，填入 https://mercator.sh/mcp/auth，由用户完成连接与授权；不在聊天沙箱运行安装器；--client claude 表示 Claude Code，而非 Desktop 聊天。
- 已安装插件：检查原生 MCP 状态并完成客户端 Authorize 操作；若工具缺失按激活步骤处理，避免重复安装。
- 本地客户端：运行 mercator status，再运行 mercator setup 安装或修复；参考 mercator setup --help 并尊重用户 --client 选择。
- 缺少 CLI：使用规范命令安装并启动设置；若用户选择客户端，追加 sh -s -- --client <client>。
- 托管或云主机：使用原生插件与 OAuth 控制；代理容器内的 CLI 不配置用户桌面。
- 其他 MCP 客户端：运行 mercator setup --manual 获取当前连接说明。
- 安装命令：curl -fsSL https://mercator.sh/install.sh | sh
- 安装后激活：按客户端/变更给出下一步（如 Claude Code 终端插件运行 /reload-plugins，必要时 --force；Codex 检查插件/MCP 状态后重启或恢复会话；Grok 按提示重启；独立 MCP 注册后重启客户端并完成 OAuth；mercator refresh 更新文件但不重启客户端）。
- 验证与恢复：对 Link 付款连接分别检查认证、余额可用性与支出权限；使用官方 Link CLI 设置/付款技能时检查命令模式并复用已有授权；将支付凭据保留在主机内；引导用户查看正确的应用官方 Link 政策页面；复用已验证政策，不因登录成功就假设存在政策；403 不具结论性；不虚构公钥/客户端对，不替用户启用权限，不在请求余额时回退到卡支付。
- 付款：Link 每应用一个审批政策，不同客户端的政策不通用；余额优先于卡（Link CLI 用 --payment-method-id 指定 BALANCE 方法 ID）；Link 可能拒绝低于 0.50 美元的卡支持 SPT；Mercator 管理的 Link 付款自动选择余额；用户批准后，在政策与任务预算内使用基于政策的付款选项（如 --use-approval-policy）；设置本身不授权付费验收测试；取消会停止且不购买、不重复登录。
- 嵌入浏览器无法使用通行密钥时，用另一浏览器继续；localhost 回调不可达时，将批准后的一次性完成链接返回同一客户端；无法接受完整链接时使用代码输入或端口转发；链接不进入共享诊断。
- 运行 mercator doctor 并遵循诊断；持续失败时用 mercator setup --client <client> --verbose。
- 在已连接服务器上检查实时工具描述，调用 search_services 和 get_connection_status 进行免费发现与付款就绪检查，遵循返回的下一步；OAuth 挑战本身不证明授权或付费就绪。
- 报告已验证的就绪状态和剩余用户操作；绝不以创建付费任务作为连接测试。
- 钱包访问限制、到期与资金由用户选择；绝不请求私钥、将令牌复制到聊天，或为修复托管 OAuth 而安装本地支付钱包。
- 共享诊断中排除凭据、OAuth 代码、支付材料和原始提供商数据。
反馈：一次安全恢复尝试后仍出现意外失败时，主动起草 send_product_feedback 报告，包含工具或命令、安全错误代码、复现步骤、期望与实际行为，遵循实时工具模式；排除秘密、凭据、支付材料、个人数据和原始输入输出；仅在授权时包含已知任务 ID（分享即让维护者访问任务结果）；发送前展示草稿并询问，除非用户已授权；拒绝后停止；每个问题最多发送一次；不重试不确定的投递；不为报告问题创建付费任务；工具仍不可用时展示脱敏报告并保持未发送。
适用场景：在代理客户端中首次安装 Mercator、修复连接或工具缺失、配置 OAuth 与钱包/付款政策、进行连接诊断与就绪检查。
限制与注意事项：设置不要求付费任务或本地钱包，但自动付款就绪需完成 Balance 政策步骤；连接就绪不等于付款就绪；不同客户端政策不互通；不创建付费任务作为测试；不请求私钥或聊天内令牌；共享诊断需脱敏；具体价格、收费与平台清单资料未提供。