憑證、核准與交付狀態
以限定權限的憑證控管存取
核准確切的發布操作
查看交付狀態
透過 MCP 讀取已連結的社群帳號
這段 Node.js 範例會連線至 Influence,列出工作區中的社群帳號。它只會讀取社群帳號資料,不會建立草稿或發布貼文。
1. 建立具讀取權限的金鑰
在「設定」中開啟 應用程式與自動化 → 開發工具。選取 讀取已連結的社群帳號(integrations:read),取消其他所有權限,再建立 API 金鑰。以 INFLUENCE_API_TOKEN 的名稱存入本機機密儲存區或環境變數。金鑰只會顯示 1 次,不要放入原始碼檔案或聊天內容。
開啟 API 金鑰設定2. 執行範例
安裝 Node.js 與 npm 後,在專案中安裝 MCP SDK。將下方程式碼儲存為 accounts.mjs,接著在已設定 INFLUENCE_API_TOKEN 的環境中執行 node accounts.mjs。SDK 會處理 MCP 連線與初始化。
npm install @modelcontextprotocol/client@2.3.1accounts.mjs
import { Client, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
const token = process.env.INFLUENCE_API_TOKEN;
if (!token) throw new Error("Set INFLUENCE_API_TOKEN first.");
const client = new Client({ name: "influence-quickstart", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(
new URL("https://influence.so/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${token}` } } }
);
try {
await client.connect(transport);
const result = await client.callTool({
name: "accountList",
arguments: { limit: 20 }
});
console.log(JSON.stringify(result.structuredContent, null, 2));
if (result.isError) process.exitCode = 1;
} finally {
await client.close();
}3. 讀取回應
這是使用虛構社群帳號名稱與 ID 的回應範例。實際回應會識別您的工作區及其已連結的社群帳號。
{
"ok": true,
"output": {
"cursor": null,
"done": true,
"items": [
{
"connectionId": "account_example_01",
"eligible": true,
"name": "Example studio",
"platform": "bluesky",
"supportsImage": true,
"supportsText": true,
"supportsVideo": true
}
],
"workspaceId": "workspace_example_01",
"workspaceName": "Example workspace"
},
"toolName": "accountList"
}結果代表什麼
已傳回社群帳號
使用 connectionId 識別各社群帳號。eligible、supportsText、supportsImage 與 supportsVideo 說明目前的貼文發布能力;準備貼文前,請重新檢查這些值。
未傳回任何社群帳號
ok: true、items: [] 與 done: true 代表讀取成功。請在 workspaceName 顯示的工作區中連結社群帳號,再重新執行範例。
結果分成多頁
done 為 false 時,請用傳回的 cursor,搭配相同的 limit,再次呼叫 accountList。持續讀取,直到 done 為 true;第 1 頁可能不到 20 個社群帳號。
存取遭拒
若收到 401 回應,請檢查金鑰是否仍有效,且具備 integrations:read 權限。API 金鑰缺少權限範圍時,也可能傳回 401。OAuth 連線則可能傳回 403 insufficient_scope;請重新連線並核准讀取社群帳號的權限。
ChatGPT 與 Claude 可透過瀏覽器授權連線,不必使用金鑰。依照助理的設定指南完成設定後,再請它列出已連結的社群帳號。上方範例使用完整 MCP 端點 https://influence.so/api/mcp;Claude 核心連接器則有自己的設定方式。
查看工具及其必要權限
GET /api/v1/tools 會列出此金鑰可用的工具。這項請求會擷取 accountList 的權限與確認要求。建立草稿則需要額外的寫入權限。
HTTP API
GET /api/v1/tools您的應用程式會讀取工具目錄,並呼叫可用的工具。
MCP
tools/list支援的助理可探索工具,並遵循相同的審核流程。
1. 準備草稿
使用工作區中的社群帳號與媒體呼叫 campaignDraftSave。保留版本與請求識別資訊,以便在回應中斷時復原。草稿寫入需要伺服器確認。
2. 準備審核內容
針對已儲存的版本與動作呼叫 campaignReview。要求核准前,先顯示社群帳號、內容、媒體、設定、時間與到期時間。
3. 執行已核准的動作
必須先核准該份審核內容,才能呼叫 campaignReviewExecute。純文字貼文需要針對完整審核內容給予新的回覆;含媒體的貼文則須在看過媒體後核准。伺服器會把動作交給持久化排程器,而非直接呼叫服務供應商。
4. 重試前先讀取結果
讀取各社群帳號的狀態,並在有發布連結時查看連結。結果未明的傳送會維持「待檢視」,直到結果釐清。建立另一則貼文前,先復原原有請求,否則可能重複傳送。
為工具選擇連線方式
| 連線方式 | 適用情境 | 存取方式 |
|---|---|---|
| HTTP API | 您的應用程式會讀取工具目錄,並呼叫可用的工具。 | 使用存於環境變數且已限定權限範圍的 Bearer 憑證。 |
| MCP | 支援的助理可探索工具,並遵循相同的審核流程。 | 依照 Influence「設定」中對應助理的步驟完成設定。能否使用取決於執行平台與已授予的權限。 |
工具目錄查詢
curl --fail-with-body 'https://influence.so/api/v1/tools' \
--header "Authorization: Bearer $INFLUENCE_API_TOKEN" \
| jq '{tools: [.tools[] | select(.name == "accountList") | {name, scopes, confirmation, mutability}]}'工具目錄欄位範例
{
"tools": [
{
"confirmation": "none",
"mutability": "read",
"name": "accountList",
"scopes": [
"integrations:read"
]
}
]
}這些範例欄位來自工具定義。實際可用的操作取決於目前的工具目錄、憑證權限範圍和已連結的社群帳號。

可以建立的發布工作流程
從自有內容流程產生貼文
在自有工具中,依文章、更新紀錄或社群公告準備草稿。先呈現確切的社群帳號、內容與時間供檢視,再請 Influence 排程發布。
找回未收到回應的請求結果
保留原始請求與冪等鍵,再查詢結果。傳送結果不確定時,狀態會維持「待檢視」,直到能確認發生了什麼事。另建替代請求可能讓同一貼文發布 2 次。
用 Influence IQ 擬出初稿
提供文章、專案筆記或社群近況,以及已儲存的品牌指南,讓 Influence IQ 擬出可編輯的草稿。可用且已獲授權的 AI 工具會使用 IQ 點數,原有的確認要求仍然適用。
提供筆記與已儲存的品牌指南,讓 Influence IQ 擬出可編輯的貼文並建議日期。擬稿與圖片生成都會使用 IQ 點數。開始生成圖片前,先確認點數報價;發布前,再檢查完成的內容。
瞭解 Influence IQ從 AI 助理開始
透過支援的 Influence 連線,您可以在 ChatGPT 或 Claude 中規劃行銷活動並修改草稿。請助理上傳它能存取的圖片與影片,或重用 Influence 中已就緒的媒體。若助理無法存取檔案,請先在 Influence 上傳。檢視確切的社群帳號、文字、媒體、設定與時間。看過完整審核內容後,再透過支援的對話內卡片核准,或以新訊息回覆「核准」。使用 TikTok Direct 時,先在對話中告知發布選擇並表示同意,再核准更新後的審核內容。審核卡片並非必要。前往「設定」查看設定方式與連線狀態。
發布至已連結的社群帳號
選擇工作區可用的社群帳號,為每個發布目的地編輯文字與支援的媒體,並在發布前檢查貼文。
常見問題
- API 與 MCP 工作流程能做什麼?
- 依已啟用的工具與您的權限,API 或 MCP 用戶端可處理已連結社群帳號、已儲存草稿、支援的媒體、貼文審核、排程與交付狀態。
- API 或 MCP 呼叫會略過核准嗎?
- 不會。伺服器會強制執行各工具的確認要求。發布必須取得目前審核內容的核准;安排交付前,執行流程會檢查工作區、權限、社群帳號與內容。
- 助理工作流程接受哪些媒體?
- 請助理上傳它能存取的圖片與影片,或重用 Influence 中已就緒的媒體。若助理無法存取檔案,請先在 Influence 上傳。檢視確切的社群帳號、文字、媒體、設定與時間。看過完整審核內容後,再透過支援的對話內卡片核准,或以新訊息回覆「核准」。使用 TikTok Direct 時,先在對話中告知發布選擇並表示同意,再核准更新後的審核內容。審核卡片並非必要。
- 未收到回應或傳送結果不確定時,該怎麼處理?
- 找回原始請求的結果,並查看已記錄的狀態。不要重送結果不明的作業。在核對並證實結果之前,「待檢視」狀態都仍未解決。
- 支援 MCP 就代表每個助理平台都能使用嗎?
- 不代表。登入後,前往「設定」→「應用程式與自動化」→「連結助理」,查看設定說明與目前的連線狀態。
- 整合工具可以編輯已排程或已發布的貼文嗎?
- 若尚未開始交付,且沒有結果未釐清的傳送作業,已排程貼文可退回草稿,供編輯並重新審核。助理無法編輯或刪除已在社群平台發布的內容。