公開 API

連接 AI 助理（MCP）

建立一把只帶助理所需權限範圍的 API 金鑰，然後把位址 https://api.mosaqo.app/v1/mcp 連同該金鑰（作為 bearer 權杖）交給用戶端。助理能做的正好是金鑰允許的，不多不少；你隨時可以在 Bulk & API 中斷開它。

最後校訂 2026年8月20日

步驟

1. 開啟 Bulk & API → API keys 並建立金鑰。先只給唯讀權限；等你看清助理做什麼之後，再簽發第二把帶寫入權限的金鑰。
2. 在同一畫面的 AI assistants (MCP) 面板中複製端點位址。
3. 在助理裡新增一個使用該位址的伺服器，並把金鑰放在 Authorization: Bearer 標頭中。多數用戶端接受含 url 與 headers 的 JSON 設定區塊。
4. 有些連接器會請你登入 Mosaqo 而不是貼上金鑰。那條路徑會在授予任何權限之前，先告訴你是誰在請求、會涉及哪個工作區、它能做什麼——而且只有擁有者或管理員才能核准。
5. 問問助理它能做什麼。它會列出你的金鑰允許的工具，這是確認連線範圍符合預期的最快方式。

如何驗證結果

問一個只有這個工作區才知道的問題：你有多少個碼，或某份問卷進展如何。回答中出現你真實的名稱與數字，表示連線可用；若被拒絕並點名某個權限範圍，表示金鑰比問題更窄。

常見的出錯之處

• 第一把金鑰就給寫入權限。先唯讀，等清楚它拿來做什麼再放寬。
• 指望它讀到人們在問卷裡寫下的內容。那些回答不會交給金鑰，也不會交給助理——分數與數量可以，句子留在收件匣裡。
• 指望它刪除 QR Code。它不能：銷毀印刷碼背後的轉址無法復原，所以提供的是封存，封存可以復原。
• 忘掉某個連線。透過登入接上的助理會一直保有存取權，直到在 Bulk & API 中斷開——就像金鑰在撤銷前一直有效。