Scope by Ouroboros Apps

范围管理

Scope 会保存自由职业者已批准的工作范围、费率、截止日期和变更单，然后让助手在回答前读取这些记录。助手无法擅自编造折扣，也不能承诺未获批准的工作。

它支持 ChatGPT、Claude、Gemini、Grok 和 Cursor，以及其他支持 Streamable HTTP 和 OAuth 的 MCP 客户端。它并非仅适用于 ChatGPT 的插件。

助手打开 OAuth 时，请使用你的 Scope 账户登录。不要将 API 密钥或密码粘贴到标头中。Scope 支持动态客户端注册：将客户端 ID 和密钥留空。/.well-known/oauth-protected-resource/mcp 处的受保护资源元数据会引导客户端前往 OAuth 颁发方进行注册。

Scope 工具需要 Pro 订阅或有效试用期。新订阅包含 14 天试用期。本页面不会列出具体金额。结账时会显示计费周期和付款条款。

你可以自行运行服务，并使用配置的基础 URL。默认的本地 MCP 地址是 http://127.0.0.1:3000/mcp。

托管服务

• MCP 服务 URL：https://scope-continuity2.vercel.app/mcp（Streamable HTTP，OAuth 登录）
• 文档：https://ouroborosapps.com/docs/scope
• 状态：早期访问。将该 URL 粘贴到 Claude、Cursor、Grok 或 ChatGPT 开发者模式中。
• 注册表名称：io.github.LAHutchins91/scope

助手可以做什么

批准连接后，服务会提供以下工具：

• list_engagements
• create_engagement
• get_approved_record
• save_scope_item
• save_rate
• save_deadline
• approve_scope
• file_change_order
• approve_change_order

助手应在回答前读取 get_approved_record。草拟条款并不代表已批准的承诺。拟议的变更单不会更改记录。范围获批后，save_rate 会拒绝降低费率，save_scope_item 会拒绝新增工作。这些变更须通过 file_change_order，然后调用 approve_change_order，且只有在你明确批准该变更单后才会生效。

只有在你和宿主都允许的情况下，助手才会调用这些工具。

连接

Cursor，配置文件位于 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "scope": {
      "url": "http://127.0.0.1:3000/mcp"
    }
  }
}

不要添加 headers 区块。Cursor 会注册客户端并打开登录页面。

Claude Code：

claude mcp add --transport http scope http://127.0.0.1:3000/mcp

不要传递 Authorization 标头。其他客户端使用相同地址，选择 OAuth，并将客户端 ID 和密钥留空。ChatGPT、Claude、Gemini、Grok 和 Cursor 的连接步骤见 /connect 页面。

此服务的注册表元数据位于 server.json（io.github.LAHutchins91/scope）。其中的公开远程 URL 为 https://scope-continuity2.vercel.app/mcp。

运行

npm install
npm test
npm run typecheck
npm run build
npm start

当标准输入为终端时，Scope 会在端口 3000 上提供 Streamable HTTP 服务。当标准输入不是终端时，它会通过 stdio 使用 MCP，同时仍会打开 HTTP 端口。stdio 模式下的日志会写入 stderr，以免与协议内容混在一起。

记录会持久保存在 JSON 文件中。默认路径为 ~/.scope/scope.json。设置 SCOPE_DATA_PATH 可更改其位置。该文件由一个服务进程独占。

OAuth 使用的机制与支持动态客户端注册的 Supabase 授权服务器相同。请在服务进程中设置以下变量，而不是将它们放在 MCP 标头中：

• APP_BASE_URL（默认值 http://localhost:3000）
• SUPABASE_URL
• SUPABASE_ANON_KEY
• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• STRIPE_PRICE_MONTHLY 和 STRIPE_PRICE_YEARLY（Stripe 目录 ID，而非金额）
• OPENAI_APPS_CHALLENGE（可选）。设置后，GET /.well-known/openai-apps-challenge 会以纯文本形式返回该令牌，用于 OpenAI 域名验证。未设置时，该路由会返回 404，文本为 Verification is not configured.

除发现操作外，工具调用都要求账户已登录，且订阅状态为 active 或 trialing。

---

更多来自 Ouroboros 的内容：https://ouroborosapps.com