基盤ツール

案件の作成・把握、商品マスタ保存、AI処理の追跡、クレジット残高とプラン・トライアルの状況の確認、制作手順書の取得に使う11のツールです。 クレジットは消費しません。変更系ツールには idempotency_key が必要です。

対象は、APIキーに固定された組織のデータだけです。組織外のIDを指定した場合は not_found が 返ります。同じ組織の案件は作成者に関係なく共有され、他のメンバーが作成した案件も取得できます。

通常の案件が持つ状態は active（有効）と archived（アーカイブ）の2つです。案件自体に draft（下書き）はなく、新規作成するとPro UIと同じくすぐ active になります。

list_projects

利用可能な案件を、更新日時の新しい順で取得します。返るのは有効な案件（status: "active"）だけです。

パラメータ

パラメータはありません。

応答

例

{
  "ok": true,
  "data": {
    "projects": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "案件名",
        "status": "active",
        "created_at": "2026-08-01T00:00:00.000Z",
        "updated_at": "2026-08-20T00:00:00.000Z"
      }
    ]
  }
}

create_project

APIキーに固定された組織へ、有効な案件（status: "active"）を作成します。作成後は同じ組織の メンバーにもPro UIとMCPから見えます。同じ idempotency_key で再試行しても案件は重複しません。

パラメータ

応答

例

{
  "name": "新商品A",
  "idempotency_key": "project-new-product-a-20260907"
}

get_project

案件の詳細と、参考資料・リサーチ本文・戦略仮説・バナーの件数概要を取得します。 本文は含みません。作業を始める前の状況把握に使います。

パラメータ

応答

参考資料の件数には、手動追加分とリサーチ収集分の両方が含まれます。

エラー

upsert_product_master

案件に商品マスタを保存します。案件ごとに1件で、すでに存在する場合は入力内容で上書きします。

パラメータ

応答

エラー

get_job_status

AI処理の状態・進捗・経過時間を取得します。生成開始系ツールが返した jobId を指定します。

パラメータ

応答

displayStatus が stale の場合、処理が中断した可能性があります。結果を確認したうえで、 必要であれば新しい idempotency_key で開始しなおしてください。

エラー

ポーリングの目安

生成処理は数十秒から数分かかります。1分あたりの呼び出し上限に収まるよう、間隔を空けて確認して ください。詳しくは利用上限を参照してください。

get_credit_balance

クレジットの課金状態と利用可能な残高を取得します。生成を始める前の確認に使います。

パラメータ

パラメータはありません。

応答

生成時はトライアルの残り、月次付与分、購入分の順に消費されます。

get_plan_status

プラン・料金・無料トライアルの期限・契約の方法・残りクレジットを取得します。無料トライアル中の組織と、 トライアルが終了した組織だけに表示されます（有料プランの組織には表示されません）。クレジットは消費しません。 トライアルが終了した組織では、このツールだけが実行できます。契約や支払いはMCPからはできず、組織の管理者が CMO AI Pro の画面で行います。

パラメータ

パラメータはありません。

応答

get_workflow_guide

CMO AI Pro で制作を進める手順書（Markdown）を返します。漫画制作は topic manga（目次）と 工程別 topic、ショート動画は manga-short-video で本文を取得できます。initialize の instructions は短い案内のみで、本文はこのツール・プロンプト manga / manga_short_video・ 資料 cmo-ai-pro://guides/<topic> で同じ内容を返します。

パラメータ

応答

topic を省略した場合は version と guides（topic・title・description の配列）が返ります。 topic を指定した場合は version・topic・title・markdown（本文）が返ります。

list_reference_images

案件の「前提情報」に登録された参考画像を取得します。組織の参考バナー・参考記事素材（記事画像素材）のテンプレートとは別です。

パラメータ

応答

referenceImages に id、fileName、usageRole、createdAt、imageUrl が返ります。 作成日時とIDの降順で、続きがある場合は nextOffset を次の offset に指定します。 画像URLは10分有効です。期限切れ時は再取得してください。URLを要求しない場合は imageUrl がnullです。

prepare_reference_image_upload

案件専用の署名付きアップロードURLを発行します。クレジットは消費しません。

パラメータ

応答

uploadUrl、storagePath、requiredHeaders、declarations が返ります。 requiredHeaders を付けて uploadUrl に画像のバイナリをPUTし、次の登録ツールを呼びます。 アップロード先URLは2時間有効です。URL発行・アップロードだけでは案件に登録されません。

register_reference_image

アップロードした画像の実体・形式・バイト数・SHA256を検証して案件へ登録します。

パラメータ

応答

referenceImageId、fileName、usageRole、reused が返ります。同じアップロードを再登録しても1件だけ保存され、最初の名前・役割を維持します。 別案件のパスは not_found、画像と申告値の不一致は validation_error です。 返された画像IDは、漫画修正の reference_image_ids やバナー生成の selected_reference_image_ids に使えます。

#### 文章制作の手順（Team以上）

Team・Agency・Enterpriseでサービス利用資格と分析の公開条件を満たすと、次の5手順も取得できます。Soloの一般MCPでは表示・取得できません。文章を書くのは外部AIエージェントで、CMO AI Proは参考の型と原稿点検を返します。新しい記事・動画の分析は、開始前に利用者の確認を取ってから分析MCPで開始できます。

prompts/getのwriting、resources/readのcmo-ai-pro://guides/writingからも同じ手順を読めます。参考検索・型取得・原稿点検は0クレジット。詳しい準備と9ツールは分析・参考ツールを参照してください。

#### 記事LPの組み立て手順（Team以上）

記事LPエディタが使える組織（Team・Agency・Enterpriseの契約中の組織）で、MCPから記事LPを組み立てるときは topic article-editor を読みます。下書きの作成、素材の入れ方（素材ライブラリ・完成した記事LP動画・アップロード）、装飾・ボタン・追従ボタンの入れ方、人の確認の取り方をまとめています。仕上がりの確認とZIPでの書き出しは利用者が画面で行い、MCPから公開・削除はしません。ツールの詳細は記事LPエディタツールを参照してください。