MCP：連接 AI 助手
透過 MCP，讓 AI 助手使用 Fox Store 已設定的連線，查詢應用程式、維護商店內容，以及執行已實作的上傳與發布操作。MCP 呼叫 Engine 業務能力；CLI 則用於 CI/CD 發布自動化，兩者共用核心，但工具範圍不同。
啟用與準備
- 安裝最新版 Fox Store，完成授權啟用並新增 Provider 連線。
- 開啟「設定 → MCP」，啟用 MCP。總開關立即儲存，重新啟動後保留；權限和逾時設定修改後需按「儲存」。
- 在「權限管理」確認連線範圍、執行權限與可用工具。
- 在「連線方式」複製對應用戶端設定，加入 AI 用戶端後重新連接 MCP。
安裝套件包含原生 MCP 程式，無須另裝 Node.js 或 MCP 外掛。用戶端透過本機 stdio 啟動獨立程序；完成初始化後無須一直開啟 Fox Store 桌面。授權租約到期時，需要回到桌面更新授權。
設定 AI 用戶端
Codex 使用設定頁產生的 TOML；Claude Code 等本機用戶端可參考產生的 JSON，並依其設定格式加入。以設定頁顯示的程式絕對路徑、啟動參數和資料目錄為準，不要照抄他人的電腦路徑。
表單式設定中，啟動命令單獨填寫，--data-dir 與後面的目錄路徑分別新增為兩個參數，不要把引號、逗號或整個陣列塞進一個參數。Linux AppImage 設定還可能帶有 --mcp，請完整保留產生的設定。無須在用戶端設定中填寫 Provider 金鑰。
相容性取決於用戶端是否支援本機 stdio MCP。GLM、DeepSeek、Gemini 等模型需透過相容用戶端使用；僅接受遠端 URL 的網頁或雲端產品無法直接執行本機程式。目前不提供 HTTP 服務位址。
權限與工具範圍
| 權限 | 允許的操作 |
|---|---|
| 唯讀（預設） | 查詢連線、應用程式、版本和狀態等，不修改平台資料。 |
| 內容維護 | 包含唯讀；允許更新文案、素材等內容，不包含送審、發布、刪除或帳號權限變更。 |
| 發布管理 | 包含內容維護；允許對應工具的送審、發布、刪除、價格、散布和帳號權限等高風險變更。 |
預設允許所有連線（含以後新增的連線）；可改為指定連線，並為連線覆寫預設權限。工具預設勾選，手動取消的選擇會保留。分組數量表示「已啟用 / 工具總數」，不是平台選單數量；展開分組可查看各項工具及所需權限。
連線範圍、工具開關、執行權限與平台帳號權限共同生效。選取工具不等於取得寫入權限。提高權限也不會增加平台或 Engine 尚未實作的能力。目前不提供逐次桌面審批；AI 用戶端可能另行要求確認。呼叫結果可能傳給該用戶端使用的模型服務。
可以怎樣提問
- 「列出這個 App Store 連線下的應用程式、最新版本及中文簡介；缺少的內容請明確標示。」
- 「查詢 Google Play 指定應用程式的測試 Track 與發布狀態。」
- 「把指定應用程式的中文商店簡介更新為這段文案。」
- 「預檢這個本機安裝套件，再上傳到指定連線的測試管道。」
請明確指定連線、應用程式、語言和目標管道。查詢只會傳回帳號可見的資料；未實作的能力或不足的權限會報錯。上傳成功不等於審核通過或已經上線。CLI 流水線用法見 CLI / API 參考。
圖片與本機檔案
AI 產生圖片後，先儲存到執行 MCP 的電腦，再提供檔案絕對路徑和目標應用程式。雲端聊天中的圖片或沙箱路徑不一定能從本機讀取；檔案不存在、無法讀取或格式不符時，應依錯誤提示修正。
可用操作取決於平台和工具：例如商店圖片更新與安裝套件內圖示修改不是同一件事。Apple 主應用程式圖示需要隨新建置上傳，不能把一張圖片直接當作已發布應用程式的圖示替換。
排查連線與呼叫失敗
- 沒有工具或只有舊工具：檢查總開關、工具選擇及儲存狀態，重新連接用戶端；程式升級後結束舊 MCP 程序並重連。
- 無法啟動：核對程式是否存在、參數是否分開、路徑是否仍指向舊安裝位置；從設定頁重新複製設定。「程式已就緒」只表示程式存在，不代表用戶端已經連接。
- MCP_POLICY_INVALID：更新 Fox Store，在設定中重新載入並儲存策略，再重連用戶端；仍失敗時保留錯誤資訊供排查，不要刪除憑證資料庫。
- 連線或憑證無法使用：核對資料目錄和所選連線，在桌面檢查連線及系統憑證庫是否可存取。不同作業系統使用者無法直接共用憑證。
- 授權、權限或逾時錯誤：更新授權，檢查所需權限和平台帳號授權；長時間任務還需調整用戶端逾時。寫入結果未知時，先查平台狀態，避免重複提交。
「最近呼叫」提供工具、結果和耗時摘要。更多說明見 Provider 連線 與 疑難排解。