Scope

io.github.LAHutchins91v1.0.1更新於 Oct 5, 2026

Approved freelance scope, rates, deadlines, and change orders, shared with AI assistants over MCP.

已驗證Streamable HTTP可網頁執行Business & CommerceProductivity & Workflow

概覽

AI 產生的概覽

讓助理在回答前讀取自由工作者的已核准工作範圍、費率、截止期限與變更單，且只有在明確核准後才提交變更。

功能
Scope 保存自由工作者的已核准委託紀錄，並提供工具來列出與建立委託、讀取已核准紀錄、儲存工作範圍項目、費率與截止期限、核准範圍，以及提交或核准變更單。建議的讀取方式是助理回答前呼叫 get_approved_record，因此它無法捏造折扣或承諾未經核准的工作。範圍核准後，儲存較低費率或新增工作會被拒絕，必須透過變更單並經使用者明確核准。
適用情境
適合希望 AI 助理依據已核准的合約紀錄回答客戶問題、而不是憑空猜測的自由工作者與小型工作室。當助理草擬提案、報價或客戶回覆，且必須遵守已約定的範圍、費率與截止期限時值得加入。
執行需求
可使用提供方的遠端端點，或以 npm 自行執行伺服器（安裝、建置、啟動），它在 3000 埠提供 Streamable HTTP，或透過 stdio 使用 MCP。需要以 OAuth 使用 Scope 帳號登入；工具呼叫需要 Pro 訂閱或有效試用。自架需要伺服器端變數，包括 APP_BASE_URL、SUPABASE_URL、SUPABASE_ANON_KEY、STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 與 Stripe 價格 ID，以及用 SCOPE_DATA_PATH 搬移 JSON 紀錄檔。
安裝前請注意
工具呼叫要求帳號訂閱狀態為 active 或 trialing，新訂閱包含 14 天試用，計費條款在結帳時顯示。自架需要 SUPABASE_ANON_KEY、STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET 等密鑰，這些應放在伺服器處理程序中，而不是 MCP 標頭裡。工具會寫入紀錄：委託、範圍項目、費率、截止期限與變更單，核准動作會改變已承諾的紀錄。紀錄保存在由單一伺服器處理程序占用的 JSON 檔案中。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Scope，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "scope": {
      "type": "http",
      "url": "https://scope-continuity2.vercel.app/mcp"
    }
  }
}

README

Scope

Scope keeps a freelancer's approved scope, rates, deadlines, and change orders, then lets an assistant read that record before it answers. An assistant cannot invent a discount or promise work that was not approved.

It works with ChatGPT, Claude, Gemini, Grok, and Cursor, plus any other MCP client that can do Streamable HTTP and OAuth. It is not a ChatGPT-only plugin.

Sign in with your Scope account when the assistant opens OAuth. Do not paste an API key or password into a header. Scope supports dynamic client registration: leave the client id and secret empty. The protected-resource metadata at /.well-known/oauth-protected-resource/mcp points clients at the OAuth issuer, which registers them.

Scope tools need Pro or an active trial. A new subscription includes a 14-day trial. This page does not list an amount. Checkout shows the billing interval and payment terms.

Run the server yourself and use the base URL you configure. The default local MCP address is http://127.0.0.1:3000/mcp.

What the assistant can do

After you approve the connection, the server exposes these tools:

  • 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 is the read the assistant should do before it answers. Draft terms are not an approved commitment. A proposed change order does not change the record. After the scope is approved, save_rate refuses a lower rate, and save_scope_item refuses new work. Those changes go through file_change_order and then approve_change_order, and only when you explicitly approve that order.

The assistant only calls these tools when you and the host allow it.

Connect

Cursor, in ~/.cursor/mcp.json or a project .cursor/mcp.json:

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

Do not add a headers block. Cursor registers a client and opens sign-in.

Claude Code:

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

Do not pass an Authorization header. Other clients use the same address, choose OAuth, and leave client id and secret empty. Steps for ChatGPT, Claude, Gemini, Grok, and Cursor are on the connect page at /connect.

Registry metadata for this server is in server.json (io.github.LAHutchins91/scope). The public remote URL there is https://scope-continuity2.vercel.app/mcp.

Run

bash
npm installnpm testnpm run typechecknpm run buildnpm start

When stdin is a terminal, Scope serves Streamable HTTP on port 3000. When stdin is not a terminal, it speaks MCP over stdio and still opens the HTTP port. Logs during stdio mode go to stderr so they do not mix with the protocol.

Records are stored durably in a JSON file. The default path is ~/.scope/scope.json. Set SCOPE_DATA_PATH to move it. One server process owns that file.

OAuth uses the same idea as a Supabase authorization server with dynamic client registration. Set these on the server process, not in an MCP header:

  • APP_BASE_URL (default http://localhost:3000)
  • SUPABASE_URL
  • SUPABASE_ANON_KEY
  • STRIPE_SECRET_KEY
  • STRIPE_WEBHOOK_SECRET
  • STRIPE_PRICE_MONTHLY and STRIPE_PRICE_YEARLY (Stripe catalog ids, not amounts)

Tool calls other than discovery require a signed-in account whose subscription status is active or trialing.

來源：README.md，提交 676c681

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.1最新Oct 5, 2026