通過 MCP 將 AnimGen 接入 Perplexity

開放條件

Perplexity 當前把自定義遠端聯結器放在 Enterprise 功能中。組織成員只有在管理員開啟自定義聯結器後才能新增；只有管理員可以把聯結器共享給整個組織。如果帳戶中沒有 + Custom connector，AnimGen 無法替使用者開啟這項 Perplexity 功能。

連線還需要已驗證的 AnimGen 帳戶。OAuth 連線本身不會消費點數；之後真正生成時，仍須明確批准報價或單次點數上限。

連線配置

請原樣使用 MCP Server URL。不要追加 /sse，不要把工具清單當成伺服器地址，也不要用 API Key 替代 OAuth。

AnimGen 已公開 OAuth 授權伺服器與受保護資源後設資料，支援 PKCE，並提供動態客戶端註冊端點。因此 Perplexity 可以自動發現 OAuth 端點並註冊回撥，不需要手工複製 Client ID 或 Client Secret。Perplexity 公佈的標準回撥地址是 https://www.perplexity.ai/rest/connections/oauth_callback；Enterprise 子域使用 https://enterprise.perplexity.ai/rest/connections/oauth_callback。

新增聯結器

1. 在 Perplexity 開啟 Account settings → Connectors。組織管理員也可以進入 Enterprise settings → Permissions → Connectors permissions。
2. 點選 + Custom connector，選擇 Remote。
3. 填寫上表設定。可選描述可以寫：透過已授權的 AnimGen 帳戶產生動畫預覽與遊戲素材。
4. 勾選 Perplexity 的自定義聯結器風險確認，然後點選 Add。
5. 開啟新增的 AnimGen 聯結器卡片，開始認證；登入 AnimGen，檢查申請的 Scope，僅批准確實需要的權限。
6. 在要求 Perplexity 呼叫工具前，先在當前對話中啟用 AnimGen。

以上介面步驟和帳戶限制依據 Perplexity 當前遠端聯結器指南。功能是否開放、文字和入口位置由 Perplexity 控制，後續可能變化。

不花點數驗證連線

先發送：

呼叫 AnimGen 的 list_models，不傳參數。
整理目前可用的輸入模式和參數。
不要上傳檔案、查詢報價、開始生成、取消任務或消耗點數。

能返回結構化模型列表，說明服務發現、OAuth 和只讀工具呼叫已打通；這不等於 Perplexity 已經能傳輸本地圖片位元組或儲存下載資產。

第一次生成之前

先確認當前 Perplexity 客戶端能傳送真實圖片位元組，或者使用合規的公開 HTTPS 圖片。對話裡出現的本地路徑不是上傳。MCP 標準工作流說明上傳完成、最新報價、明確批准、有限輪詢與下載。

在 Perplexity 展示準確請求和點數金額前，不要批准 generate_animation。優先使用短期 quote_id；否則為這一次操作設定經過檢查的 max_credits。OAuth 授權不等於消費批准。

排障與移除

• 沒有 Custom connector 入口： 請 Perplexity 組織管理員開放成員自定義聯結器，或改用具備該功能的帳戶。
• 聯結器驗證返回 403： 檢查 Cloudflare 或其他 WAF 是否對 https://api.animgen.com/mcp 或 OAuth 發現端點發起了挑戰。不要用關閉 OAuth 或暴露匿名端點來繞過。
• OAuth 沒有啟動： 保持 Authentication 為 OAuth，確認 URL 沒有多餘路徑，再按 API 與 MCP 排障檢查。
• 能列出模型但不能使用本地圖片： 這是客戶端檔案傳輸能力限制，不能據此認為遠端 MCP 可以讀取路徑。應使用受支援的位元組傳輸能力或合規公開 HTTPS 輸入。

從 Perplexity 刪除聯結器和撤銷 AnimGen 授權是兩件事。先在 Perplexity 移除聯結器，再到帳戶 → 開發者撤銷對應應用。

Perplexity 搜尋可見性是另一條路徑

安裝聯結器不會讓 AnimGen 頁面自動進入 Perplexity 搜尋答案或提高排序。搜尋發現由 PerplexityBot、Perplexity-User 等獨立 Agent 完成。AnimGen 在 robots 層允許公開抓取，但仍需持續檢查 WAF 和真實響應碼。詳見 Perplexity 爬蟲文件。