先匹配需求，再获取证据

连接条件

MCP 地址为 https://scopeai.cc/mcp，传输为 Streamable HTTP。首版提供 JSON 响应，不提供独立 SSE 流、OAuth 或自动采样。GET/DELETE 返回 405 属于不提供独立流和会话的正常响应。

客户端须支持远程 HTTP 地址。账户工具还需支持 Authorization: Bearer 请求头；把密钥保存在客户端的秘密配置中，不放入工具参数或公开 JSON。匿名调用可使用免费描述、匹配与优化准备。

客户说开始优化时

先调用 geo_prepare_optimization。品牌或官网缺失时，只补问缺少的信息；资料齐全后返回访问检查、品牌事实、内容修改、发布读回和复测任务。

不使用 MCP 时可向 /agents/prepare POST 同样输入。任务包由客户已有的 Codex 或 CMS 维护方执行；ScopeAI 没有获取客户的网站密码或自动发布权限。

{
  "brand": "示例品牌",
  "website": "https://example.com",
  "goal": "改善品牌在 AI 搜索中的信息准确性",
  "execution_access": "repository"
}

使用初始化式客户端

兼容 2025-11-25、2025-06-18、2025-03-26。先发送 initialize，再发送 notifications/initialized；后续请求携带协商的 MCP-Protocol-Version。每个 POST 的 Accept 包含 application/json 与 text/event-stream。以下初始化不会调用模型或扣观察费用。

curl https://scopeai.cc/mcp --request POST \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"scopeai-example","version":"0.1.0"}}}'

使用无状态客户端

2026-07-28 使用 server/discover，无需 initialize。每次请求的 params._meta 包含 io.modelcontextprotocol/protocolVersion 与 io.modelcontextprotocol/clientCapabilities；HTTP 同时提供 MCP-Protocol-Version、Mcp-Method。tools/call 还需 Mcp-Name，且头部必须与正文一致。

调用 tools/list 读取准确输入格式，然后使用 geo_describe_service 和 geo_match_request。发现能力不代表宿主自动安装了 ScopeAI；具体宿主支持情况需要真实连接验收。

最小免费匹配输入

以下只确认豆包模型 API 观察的范围，不访问客户资料、不创建任务。如果目标未开放、语言不支持或你要求消费端观察，会明确返回缺口。

{
  "request_ref": "match-example-001",
  "intent": "brand_visibility.observe",
  "desired_surface": "model_api",
  "target_id": "doubao-web-search-api",
  "language": "zh-CN",
  "market": "CN",
  "desired_deliverables": [
    "raw_answers",
    "citations"
  ]
}

直接通过 HTTP 匹配

不使用 MCP 时，将上述 JSON 作为 POST 正文发送到 /agents/match。这个入口不接受浏览器 GET；匹配成功也不会自动创建观察任务。

curl https://scopeai.cc/agents/match --request POST \
  --header "Content-Type: application/json" \
  --data '{"request_ref":"match-example-001","intent":"brand_visibility.observe","desired_surface":"model_api","target_id":"doubao-web-search-api","language":"zh-CN","market":"CN","desired_deliverables":["raw_answers","citations"]}'

需要真实观察时

geo_list_targets 查看账户可用目标；geo_create_project 建立获授权品牌项目；geo_quote_observation 按项目版本、目标、题目和重复次数报价。报价本身不启动采样或扣款。

客户批准后才调用 geo_accept_observation，传 quote_id、max_charge_cents、approved=true 和稳定 idempotency_key。geo_get_observation、geo_get_answers、geo_get_sources 读取任务与证据；取消调用 geo_cancel_observation。密钥的实际 grant、余额和所有权仍由服务端检查。

amount/cents 等原生接口金额以接口规范为准。不要将费用上限视为一定消耗金额，不要在超时后换幂等键重复创建付费任务。

联系管理员付费后继续

当前没有在线支付渠道。客户登录余额与充值页面联系管理员，核对账户与金额；管理员确认实际收款并入账后，才增加可用余额。免费任务准备不需要充值，AI 不能自行提交付款或声称已入账。

接受观察时余额不足，MCP 保留原有 402 与 insufficient_balance，并附 payment_handoff：联系管理员的页面、余额读取地址及恢复步骤。AI 应暂停当前付费动作，把入口交给客户，不自动重试或提高预算。

入账后，执行方使用已有账户密钥读取 GET /api/v1/geo/balance，刷新原范围报价并核对已批准预算；报价变化或超出范围时重新核对授权。已经提交而结果不确定的请求，先查询原任务；重试同一接受请求沿用原幂等键。密钥只在客户端秘密配置中，不能发送给管理员或写进付款链接。