你需要準備什麼
讓助理登入有兩種方式。請選擇你的用戶端支援的那一種。
以瀏覽器授權連線
事先不需要在 Alforse 中設定任何東西。你在助理中加入伺服器 URL，Alforse 會請你核准這個連線。連線能做什麼
- 它以你的身分，在你所選的公司中運作，使用的正是你目前的權限。如果你的權限改變，助理的權限也會隨之改變。
- 一旦你不再是該公司的啟用中成員，它就會停止運作。
- 公司與使用者永遠來自連線本身。助理無法透過傳入不同的引數來切換公司或冒充他人。
登入在幕後如何運作
用戶端會自動處理這些；以下細節是為自行開發用戶端的開發人員而寫。- 授權類型（grant types）：
authorization_code與refresh_token。回應類型：code。 - 使用
S256的 PKCE。公開用戶端（權杖端點驗證方式為none）必須送出 code challenge。 - 權杖端點的用戶端驗證：
client_secret_post或none。 - 範圍：
mcp:tools。 - 授權碼有效 10 分鐘，且只能使用一次。存取權杖有效一小時（
expires_in: 3600）；用戶端以其更新權杖（refresh token）續期。
以 API 金鑰連線
對於無法開啟瀏覽器登入的用戶端，以及指令碼，請使用金鑰。管理員在設定 → API 金鑰下建立；金鑰本身帶有自己的權限範圍，並屬於單一公司。建立金鑰與設定範圍的方式，請參閱 API 金鑰。 把金鑰放在Authorization 標頭中傳送：
alforse-key: alf_your_key_here 標頭也同樣被接受。
用戶端設定
.cursor/mcp.json，或合併到你現有的 mcpServers）
.vscode/mcp.json；VS Code 會詢問金鑰，因此不會存進檔案）
https://app.alforse.com/api/mcp 與 Authorization: Bearer … 標頭。各用戶端的 URL 欄位名稱不同（例如 url 或 serverUrl）；請查閱你的用戶端文件。
助理看得到的工具
伺服器不是為每項操作提供一個工具，而是提供三個能觸及所有操作的工具：
這些操作來自以下範圍：帳號、會計、文件、庫存、開立發票、品項、人員、生產、採購、品質、資源、銷售、設定、共用與使用者。只有 Alforse 明確公開的操作可用；有些操作是刻意不放在伺服器上的。
- 每次呼叫都會經過與應用程式相同的權限檢查，寫入也由同一個服務層驗證。
- 每項操作都帶有風險等級，因此你的助理可以在執行
WRITE或DESTRUCTIVE操作之前先詢問你。 - 清單讀取預設回傳 25 列。助理使用
limit（1–100）與offset分頁。 - 助理會被告知你公司時區的今天日期，因此像「上週」這樣的相對日期能正確解析。
限制
達到限制時，伺服器會回應
429，並附上 Retry-After 以及 X-RateLimit-Limit、X-RateLimit-Remaining 與 X-RateLimit-Reset 標頭。請等待 Retry-After 所示的秒數後再重試。