APIの権限、投稿の承認、送信結果
認証情報でアクセスを制限
公開する操作そのものを承認
配信状況を取得
MCPで連携アカウントを取得する
このNode.jsのサンプルはInfluenceに接続し、ワークスペース内のSNSアカウントを一覧表示します。アカウント情報の読み取りのみを行い、下書きの作成や投稿は行いません。
1. 読み取り権限のあるキーを作成
設定で「アプリと自動化」→「開発者向けツール」を開きます。「接続済みチャンネルを読み取る」(integrations:read)だけにチェックを入れ、ほかの権限のチェックをすべて外してからAPIキーを作成してください。キーはローカルのシークレット管理ツール、または環境変数INFLUENCE_API_TOKENに保存してください。表示は一度きりです。ソースコードやチャットには貼り付けないでください。
APIキーの設定を開く2. サンプルを実行
Node.jsとnpmを用意し、プロジェクトにMCP SDKをインストールします。以下のコードをaccounts.mjsとして保存し、INFLUENCE_API_TOKENを設定した環境でnode accounts.mjsを実行してください。MCPの接続と初期化はSDKが処理します。
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は架空のものです。実際のレスポンスには、自分のワークスペースと連携済みSNSアカウントが表示されます。
{
"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は各アカウントを識別するIDです。eligibleとsupportsText、supportsImage、supportsVideoは、その時点での投稿可否や対応形式を示します。投稿を準備する前に、これらの値を再確認してください。
アカウントが返されない場合
ok: true、items: []、done: trueなら、読み取りは成功しています。workspaceNameに表示されたワークスペースにSNSアカウントを連携し、再実行してください。
次のページがある場合
doneがfalseなら、返されたcursorと同じlimitを指定してaccountListを再度呼び出します。doneがtrueになるまで続けてください。最初のページに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に公開予約を依頼します。
応答が途切れたら元のリクエストを確認
元のリクエストと冪等性キーを保持し、記録された結果を確認します。送信結果が不明な投稿は、照合が終わるまで「要確認」のままです。重複を避けるため、新しい公開リクエストで置き換えないでください。
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対応ならすべてのアシスタントで動きますか?
- いいえ。ログイン後、設定 → アプリと自動化 → アシスタントを接続を開き、設定手順と現在の連携状態を確認してください。
- 連携から予約済み・公開済みの投稿を編集できますか?
- 配信が始まっておらず、未確認の送信がなければ、予約投稿を下書きに戻せます。編集後は新たに内容を確認し、承認します。アシスタントから、SNS上で公開済みの投稿を編集・削除することはできません。