MCP

讓 AI 用戶端連接 Influence 社群帳號、媒體、審核、排程及可用的成效分析。

依工作選擇端點。產品工具需要已獲授權的 Influence 工作區；文件伺服器只讀取公開指南。

端點	用途
`https://influence.so/api/mcp`	一般產品連線，包含已啟用的規劃、圖片及研究工具。
`https://influence.so/api/mcp/claude`	Claude 連線，包含媒體上傳、草稿、審核、排程、規劃與成效分析；不含圖片生成工具及 `search`／`fetch`。
`https://docs.influence.so/mcp`	搜尋與閱讀公開文件。不需產品帳戶，也無法存取工作區資料或發布。

連線與探索工具

使用用戶端的 Influence OAuth 流程；若用戶端支援 Bearer 驗證，也可使用限定權限的 API 金鑰。應用程式與自動化提供各用戶端的設定方式。將 API 金鑰存放於用戶端存放機密值的環境中。

讀取 profileGet，確認 Influence 電子郵件與工作區（nickname），再讀取 connectionStatusGet 查看權限範圍及 AI 排程額度。AI 用戶端登入時可使用不同的電子郵件。授權時，請選擇預期的 Influence 身分。

OAuth 續期需要明確同意 offline_access。若建立新的 ChatGPT 自訂連線，設定說明也會要求這項 Base 權限範圍。重新整理工具不會增加權限，也不會升級舊連線的 Base 權限範圍。

使用 tools/list 與 MCP 工具參考文件。探索結果可能列出尚未授予權限範圍的工具；每次呼叫仍會檢查權限。是否可用也取決於已啟用功能及用戶端支援。一般端點與 Claude 端點不同；下載技能或外掛，不代表已安裝的用戶端已載入其工具。

準備已完成的內容

讀取 accountList，再為每個選定的社群帳號讀取 integrationSchema，確認必要設定與媒體限制。看板、頻道等發布目的地，請使用對應供應商的具名查詢工具。
以 mediaImport 匯入可存取的 HTTPS 檔案，提供 url 及可選的 name。真正的主機檔案使用獨立的 file 物件；不得虛構檔案 ID。本機檔案請使用分段上傳工具或現有 SDK／CLI 輔助工具，並遵守媒體限制與就緒要求。
若有 1–10 則已完成且要排程的貼文，使用 campaignScheduleBatchReview，為每個項目提供穩定的 itemKey、draft 與 scheduledFor。它會一併儲存草稿及待審核內容，保留各目的地的文字與媒體，最多包含 50 次傳送。若只處理草稿或編輯，使用 campaignDraftSave；campaignReview 則為已儲存的行銷活動準備預定操作。
呈現完整的已儲存審核內容。已顯示並載入完成的卡片可用來呈現；沒有卡片時，須顯示確切的社群帳號、文字、媒體預覽或連結、設定、排定時間及時區。審核內容缺漏、已不符現況或結果不明確時，讀取 campaignReviewGet。
執行前，取得使用者當次明確核准。受支援的卡片設有自己的核准按鈕。符合條件的社群貼文，可透過 campaignReviewExecute 或 campaignScheduleBatchExecute 提交聊天中的核准。模型不得呼叫私有的 campaignReviewApprove UI 操作。

TikTok Direct 支援純聊天流程。先讀取 tiktokCreatorInfoGet，再以 1 個整合問題詢問尚未確定的可見範圍、互動選項、推廣資訊及適用的 AI／音樂選項。顯示適用的同意條款與連結，不得推定已同意或啟用受限互動。以 campaignReview 儲存使用者完整選項，提供 reviewId，以及含有 connectionId、settings 的 tiktokSettings 項目。這會傳回新的待審核內容，不代表核准。呈現該份確切內容，等到使用者當次明確核准後再執行。受支援的審核卡片仍非必要。TikTok 收件匣發布須在 TikTok 中完成。

TikTok 同意適用於該份確切的審核內容；草稿中儲存的同意，不能完成此步驟。儲存審核選項會建立新的草稿版本，讓先前審核內容失效，即使設定沒有變更也一樣。

確認與復原

標示需要確認的工具，初次準備時不帶 _confirmationCapability 或 _idempotencyKey。確認時使用完全相同的業務輸入，並帶入傳回的確認憑證與由呼叫端產生的穩定等冪金鑰。這段交換會儲存或執行該工具所述的操作，與人工發布核准分開。請遵守主機的權限提示。

mediaUploadPart、mediaUploadComplete 與 mediaUploadAbort 會直接接續已授權的上傳。將檔案位元組傳至傳回的儲存空間網址，不要放入工具 JSON。中斷後，讀取上傳狀態，再以相同檔案與 clientKey 接續。

上傳的 expiresAt 是目前傳輸或處理階段的期限：起初為 24 小時，完成傳輸並開始處理後改為 15 分鐘。已就緒的媒體不會隨此期限失效；可重用媒體庫中的 assetId。

結果不明確時，保留確認與重試值。重試發布操作前，先讀取已儲存的審核內容或行銷活動，不要假設逾時代表未發生任何事。審核已變更或到期時，需要重新審核並核准。

AI 排程限制由各 MCP 用戶端與 Influence IQ 共用。一般 HTTP／CLI 自動化及手動網頁排程不計入。成效分析的涵蓋範圍與重新整理方式，請見成效分析。選用的事件訂閱另需已啟用此功能的主機支援，並不保證每個用戶端都會收到背景通知。