ツールからInfluenceで公開する

API・MCPで下書きを保存し、アカウントを選び、投稿内容を確認してから公開を予約できます。投稿先ごとの結果も取得できます。

APIの権限、投稿の承認、送信結果

認証情報でアクセスを制限

クライアントに必要な権限を選びます。Influenceはすべての操作でワークスペースの所有権とアクセスを検証します。確認が必要かどうかはツールごとに定められ、サーバーがその要件を適用します。

公開する操作そのものを承認

実行前にアカウント、内容、メディア、日時を確認します。重要な変更には新しいレビューと承認が必要です。承認済みの操作はInfluenceのスケジューラーに入ります。

配信状況を取得

返されたIDで投稿の状態を確認できます。「予約済み」は配信待ち、「公開済み」は公開を確認できた状態です。「要確認」は送信結果が不明なため、再送する前に元の結果を調べる必要があります。

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.1

accounts.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

対応アシスタントがツールを見つけ、同じ確認手順に従います。

Influence
  1. 1. 下書きを作成する

    ワークスペースのアカウントとメディアを指定してcampaignDraftSaveを呼び出します。応答が途切れた場合に復旧できるよう、バージョンとリクエスト識別子を保持します。下書きの保存には、サーバーでの確認が必要です。

  2. 2. 確認内容を準備する

    保存したバージョンと操作を指定してcampaignReviewを呼び出します。承認を求める前に、アカウント、内容、メディア、設定、時刻、有効期限を表示します。

  3. 3. 承認された操作を実行する

    campaignReviewExecuteには、提示した確認内容への承認が必要です。テキスト投稿では全内容を提示した後の新しい返信、メディアでは画像や動画を実際に見たうえでの承認が必要です。サーバーは操作を永続的なスケジューラーに渡し、プロバイダーを直接呼び出しません。

  4. 4. 再試行前に結果を読む

    投稿先ごとのステータスと、取得できた公開済み投稿のリンクを確認します。送信結果が不明な場合は、結果が確定するまで「要確認」のままです。応答が途切れても新しい投稿を作らず、元のリクエストの結果を取得してください。

ツールに合う接続方法を選ぶ

Influence: ツールに合う接続方法を選ぶ
接続方法用途アクセス
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上で公開済みの投稿を編集・削除することはできません。