---
sidebar:
  order: 4
title: MCP
description: 讓 AI 用戶端連接 Influence 社群帳號、媒體、審核、排程及可用的成效分析。
---

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

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

## 連線與探索工具 [#connect-and-discover]

使用用戶端的 Influence OAuth 流程；若用戶端支援 Bearer 驗證，也可使用限定權限的 API 金鑰。[應用程式與自動化](https://influence.so/sign-in?next=%2Fapp%2Fsettings%2Faccount%23settings-developer)提供各用戶端的設定方式。將 API 金鑰存放於用戶端存放機密值的環境中。

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

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

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

## 準備已完成的內容 [#prepare-finished-content]

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

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

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

## 確認與復原 [#confirmation-and-recovery]

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

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

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

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

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