本文へ移動
CMO AI Pro
ログイン

CMO AI Pro Developers

クイックスタート

APIキーの発行から最初のツール実行までの手順を説明します。

最終更新日：2026年10月26日

ログインして接続を許可し、エージェントから最初のツールを実行するまでの手順です。所要時間は数分程度です。 かんたん接続（ログインだけ）なら、APIキーの発行や環境変数の操作は必要ありません。

1. 接続先を貼ってログインし、許可する

  1. CMO AI Proへログインします
  2. 利用するクライアントでカスタムコネクタまたはMCPサーバーの追加を開きます
  3. 接続先 https://www.cmo-ai.pro/api/mcp を入力します
  4. 接続を開始し、CMO AI ProへメールまたはGoogleでログインします
  5. 接続する組織を選び、「許可する」を押します
  6. list_projects の実行を依頼して接続を確認します

接続先は末尾に / を付けず、https://www.cmo-ai.pro/api/mcp をそのまま入力してください。

クライアントごとの操作名はクライアント別接続の手順に従います。

APIキーを使う場合（自動実行・CI）

APIキーを発行し、自動実行やCIから接続する場合は次の手順を使います。

  1. 画面左下の「設定」を開きます
  2. 「APIキー管理」（/settings/api-keys）を選びます
  3. 用途がわかるキー名と有効期限（30日・90日・365日・無期限）を指定して「発行する」を押します
  4. 表示されたキーをパスワード管理ツールへ保存します

キーの平文は発行直後に一度だけ表示されます。閉じたあとは再表示できません。 詳しくはAPIキーを参照してください。

2. 接続先を確認する

接続先（MCPサーバーのURL）は次のとおりです。すべての利用者で共通です。

text
https://www.cmo-ai.pro/api/mcp

www を省いた https://cmo-ai.pro/api/mcp は転送（リダイレクト）になり、転送をたどらないクライアントでは 接続できません。必ず www つきのURLを使ってください。 再接続すると設定画面に接続行が増えるため、不要になった行は「失効」してください。

3. エージェントへ登録する

利用するクライアント（Claude Code・Codexなど）とOS・シェルに合った クライアント別接続の手順を使います。 設定には環境変数の名前を記載し、キーは非表示の入力待ちで渡してください。 キーの実値をコマンド・設定ファイル・チャットへ貼り付けないでください。

4. 接続を確認する

エージェントに list_projects の実行を依頼します。ツール実行の承認を求められたら、ツール名を確認して 許可してください。

成功すると次の形のJSONが返ります。

json
{
  "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"
      }
    ]
  }
}

projects が空の配列の場合、キーを発行した組織に有効な案件がありません。CMO AI Proの画面で案件を 作成してから再実行してください。

案件作成は画面かMCPの create_project のどちらか一方で行います。 すでに作成した案件をもう一方の方法で重複作成せず、list_projects でその案件を取得してください。

5. 案件の状況を見る

list_projects で得た id を使い、get_project を実行します。参考資料・リサーチ本文・戦略仮説・ バナーの件数概要が返ります。エージェントに「この案件の状況を教えて」と依頼すれば、必要なツールを 選んで実行します。

つまずいたときは

症状確認すること
HTTP 401 が返るキーの綴り、Bearer の後の半角スペース、キーの有効期限と失効状態
access_denied が返る同意画面で接続を拒否していないか。接続をやり直し、組織を選んで「許可する」を押す
invalid_grant が返る認可コード・更新用トークンの期限切れまたは再利用。クライアントで接続を解除して再接続する
HTTP 403 が返る契約状態（無料トライアル未付与・契約終了後・完全停止）、接続元。組織管理者へ確認してください
HTTP 503 が返るMCP連携が一時停止中の可能性があります。時間をおいて再試行してください
ツールが呼ばれないエージェント側でMCPサーバーが Connected になっているか

エラーの詳しい読み方はエラーを参照してください。

次に読むページ