KreaをほかのAIとつなぐ手順（その1）：Claude Code・Codex・Cursor（MCP）、ChatGPT、プラグインを、公式の記述の範囲で

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。公式ページは要約の形で取得したため、設定ファイルの全文や、ページ内のFAQの答えの本文は、読めていない所があります。そういう所は「公式の資料では確認できていない」と書き、全文は公式ページで原文を見て確かめるよう書きます。画面の表記は変わるので、手元の画面と照らして読んでください。

先に結論

• 別のAIからKreaを使うなら、まずMCPです。 公式は、Krea側でMCPサーバーを運営し、MCP対応のAIやコード用アシスタントが、モデルの一覧を調べ、入力の形を調べ、画像・動画を作れる、と書いています。
• 「どの認証にするか」で、請求先が変わります。 OAuthなら、同意の画面で選んだワークスペースのコンピュートユニット。APIトークンなら、別のAPI残高。Agent系の道具は、トークンでもコンピュートユニットです。
• 生成の前に、費用の見積もりだけを返させる機能があります。 道具のgenerateとexecute_node_appにpreflightを付けると、ジョブを作らずに、費用と残高が返ります。
• ChatGPT向けは、MCPの上に作られたアプリです。 入れ方は短く、データの扱いは、読んだページに書かれていません。
• この記事の続き（08）： Krea Agentと外部アプリ（Slackなど）、API・Webhook、Agent API、CLI。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIアシスタントが外部の道具を呼び出すための共通の約束です。
• MCPサーバー：道具を提供する側です。Kreaが運営している https://api.krea.ai/mcp が、これです。
• MCPクライアント：道具を呼ぶ側のAIです。Claude Code、Codex、Cursorなどです。
• Streamable HTTP：MCPの通信の方式の1つです。公式は、Kreaのサーバーの方式として、これを挙げています。
• OAuth：パスワードを渡さず、ブラウザでサインインして許可を出す仕組みです。
• Bearerトークン：Authorization: Bearer ... というヘッダで送る合言葉です。
• ワークスペース：Kreaの利用単位です。残高や、アップロードした素材の置き場所が、ここで決まります。
• コンピュートユニット / API残高：前者はWebアプリとOAuthのMCP、後者はAPIトークンで使う、別々の残高です（05参照）。
• Webhook：生成が終わったときに、Kreaから自分のサーバーへ知らせを送る仕組みです。
• この記事での表記：トークンの値は、必ず YOUR_API_TOKEN や KREA_API_KEY のような仮の文字にしてあります。実際の値を、この記事や設定ファイルの共有、画面共有に出さないでください。

連携の地図

1. MCPサーバーの基本（共通の話）

サーバーの情報（公式のMCPページ）

OAuthでつなぐときに起きること

1. クライアントが、OAuthを自動で始めることが多い。
2. ブラウザが開き、Kreaにサインインして、許可の画面に進む。
3. 許可の画面に「Workspace picker」がある。 自分が入っているワークスペースが一覧で出て、既定のワークスペースが、あらかじめ選ばれています。
4. 選んだワークスペースが決めるもの（公式の記述）：
5. 課金：コンピュートユニットが、そのワークスペースから引かれる。
6. 素材の置き場所：upload_assetなどの道具で上げたファイルが、そこに保存される。get_upload_urlは、ワークスペースが結びついてから使える。
7. ワークスペースを変えるには、クライアントでKreaを切り離し（disconnect）、つなぎ直す。Workspace pickerができる前（2026年7月1日の更新履歴）に作られたセッションは、つなぎ直すまで、既定のワークスペースが使われる、と書かれています。

APIトークンでつなぐとき

• 送るヘッダ：Authorization に Bearer KREA_API_KEY（公式のMCPページの書き方。KREA_API_KEYの所に、自分のトークンを入れる、という意味の仮の文字）。
• トークンは、krea.ai/app/api/tokens で作る、と書かれています（作る場所の書き方がページごとに違う件は05を参照）。ownerとadminだけが作れます。
• 課金は、そのワークスペースのAPI残高です。
• 公式は、トークンを含む設定ファイルを、バージョン管理に入れないよう注意しています。

使える道具（tool）

Agent系の道具（send_agent_message、get_agent_session、wait_for_agent_session）は、MCPのページの認証の項で触れられていますが、道具の表には載っていません。APIトークンでつないでも、コンピュートユニットを使う、と書かれています。各道具の引数の全部は、そのページには書かれていません。

モデルのID（公式の例）は、APIのパスと同じ形です：image/krea/krea-3、image/krea/krea-2/medium、video/google/veo-3.1。古くなったモデルは、一覧を調べたときに、廃止の情報が返る、と書かれています。

費用の見積もりだけを返す（preflight）

generateとexecute_node_appには、preflight（真偽値。既定はfalse）があります。trueにすると、ジョブを作らずに、見積もりが返ります。返る項目は、mode、compute_units、is_estimated、available_compute_units、affordableです。公式の例の形は次のとおりです（値は公式の例）。

{
  "mode": "preflight",
  "compute_units": 12,
  "is_estimated": false,
  "available_compute_units": 400,
  "affordable": true
}

更新履歴は、2026年10月19日に「Set preflight to true on a generation tool to get a cost quote and your balance without submitting a job」、10月16日に「Ask your agent how many compute units you have left」と書いています。

取り消し

cancel_jobは、DELETE /jobs/{id}を呼び、成功すると { "job_id": "...", "deleted": true } が返ります。ジョブがまだ終わっていない間だけ使えます。取り消したジョブは、課金されません。

素材の渡し方

• start_image、reference_imagesなど、メディアを受ける項目は、https://のURL、base64のデータURI、またはアップロード済みの素材のURLを受けます。カンマ区切りの列は使えず、1つずつ渡します。
• ローカルのファイルは、次の順です。
• エージェントに、get_upload_urlを呼ばせる。3時間有効な署名つきURLが返る。

• ファイルをmultipart/form-dataのfileという項目1つで、POSTする（公式の例）：

  bash curl -X POST "$UPLOAD_URL" -F "file=@/path/to/image.png"

• 返事の本文にある素材のURLを、後のgenerateで使う。

• アップロードがネットワークの制限で失敗するときは、api.krea.aiを許可する、と書かれています。

結果のウィジェット

MCP Appsに対応したクライアントでは、結果の枠（ui://krea-public-api/job-result-frame）が出て、読み込み中のタイル、get_jobの自動の確認、再試行と取り消しのボタン、拡大結果の前後のスライダーが使える、と書かれています。非同期の生成（既定）が向く、とあります。

2. Claude Code × Krea

手順（公式のMCPページ）

1. ターミナルで、次のコマンドを実行する（公式の写し）。

bash claude mcp add --transport http krea-ai https://api.krea.ai/mcp

1. 促されたら、サインインする（OAuth）。
2. Claude Codeを再起動するか、MCPサーバーを再読み込みする。

もう1つの書き方（MCPの紹介ページ）

公式の紹介ページ（krea.ai/mcp）には、Claude Code用として、同じコマンドに、--header "Authorization: Bearer KREA_API_TOKEN"を足す形が載っています。ここでは、APIトークンを渡す形です。KREA_API_TOKENは、トークンを入れる場所の仮の文字です。コマンドの全文は、公式のページで原文を見て写してください（この記事は、要約から組み直した形を「公式の写し」とは書きません）。

2つのページで書き方が違うので、この記事は、どちらかに決めつけません。つなぐときは、請求先（コンピュートユニットかAPI残高か）が変わる点を意識して、選んでください。

渡るデータ（公式に書かれている範囲）

• Claude Codeがgenerateなどを呼ぶと、プロンプトや、渡した参照画像（URL、base64、アップロードしたファイル）が、Kreaのサーバーに送られます（呼ぶという動作の性質から、そう読めます。公式が「何を保存するか」を、MCPのページに書いているわけではありません）。
• アップロードしたファイルは、OAuthで選んだワークスペースに保存される、と書かれています。
• 出力のURLがいつまで有効か、結果がいつまで残るかは、読んだMCPのページに書かれていません。

権限と外し方

• Kreaの側のページは、「どの道具を許可するか」を、Claude Code側でどう決めるかを書いていません。クライアント側の画面で確かめてください。
• 外し方（公式のMCPページ）は、「クライアントでKreaを切り離し、必要ならつなぎ直す」だけです。Claude Codeでの削除コマンドは、Kreaのページには書かれていません。
• 更新履歴の2026年10月20日に「You can now disconnect OAuth apps, such as the Krea CLI and MCP clients」とあります。どの画面かは、読んだ範囲では書かれていません。

うまくいかないときの確認点（公式のMCPページ）

この記事の案：Claude Codeに、見積もりを先に出させる流れ

次は、公式の道具の説明に合わせて、この記事で組んだ使い方の案です。動作は確かめていません。依頼文はこの記事の例です。

Krea MCPの list_models で、画像のモデルを一覧にしてください。
次に、image/krea/krea-3 の get_model_schema を調べ、
「朝の台所に置かれた白いマグカップ」の画像を作る generate を、
preflight を true にして実行し、費用と残高だけ教えてください。
私が「実行して」と言うまで、本番の生成はしないでください。

公式の道具（list_models、get_model_schema、generateのpreflight）だけで組んだ流れです。AI側が、実際にこの順で動くかは、確かめていません。

3. Codex × Krea

手順（公式のMCPページ）

1. 「Settings」→「MCP servers」を開く。
2. 新しいサーバーを足す。
3. 通信方式に「Streamable HTTP」を選ぶ。
4. https://api.krea.ai/mcpを貼る。
5. 保存し、Codexがサインインを求めたら、サインインする。

渡るデータ、権限、外し方は、前の節（Claude Code）と同じ書き方に留まります。Codex側の画面の細かい表記は、公式のKreaのページには書かれていません。

4. Cursor × Krea

手順（公式のMCPページ）

1. コマンドパレットを開き、「Open MCP settings」を探す。
2. mcp.jsonに、次を足す（公式の写し）。

json { "mcpServers": { "krea-ai": { "url": "https://api.krea.ai/mcp" } } }

1. 保存してから、Cursorを再起動する。
2. 促されたら、サインインする。

トークンを入れる設定は、このページには書かれていません。設定ファイルにトークンの値を書く場合は、公式の注意（バージョン管理に入れない）に従ってください。

5. Claude（デスクトップ・Web）、そのほかのクライアント

• Claude（デスクトップ・Web）：読んだMCPページと紹介ページに、設定の手順は書かれていません。紹介ページの見出しは「Turn your Claude into a creative」ですが、手順はClaude Codeだけでした。KreaのChatGPT向けページには、「Claude、Cursorなどは、Krea MCPのページを見る」という趣旨の記述があり、Krea Agentのページには、Krea MCPがClaude、Codex、Cursorなどにつなぐものだという記述があります。
• そのほかのクライアント：公式のMCPページは、手順を書いていません。Streamable HTTPとOAuthに対応するクライアント、またはベアラーのヘッダを渡せるクライアントなら使えるか、という点も、公式のページには明記がありません。この記事は、「使える」とは書きません。

6. ChatGPT × Krea（Krea for ChatGPT）

手順（公式のChatGPT向けページ）

1. ChatGPTで、メニューから「Settings」を開く。
2. 「Plugins」タブを選ぶ。
3. 検索欄に「Krea」と入れ、Kreaを選び、ChatGPTが求めたら、Kreaのアカウントでサインインする。
4. （別の入り方）ページの「Add to ChatGPT」ボタンも、公式が案内しています。

条件と、できること

• 必要なもの：公式は「ChatGPTのPluginsディレクトリでKreaを見つけ、Kreaのアカウントでサインインする」という趣旨で書いています。ChatGPTのプランや提供地域の条件は、書かれていません。
• 公式のページは、「a ChatGPT app built on Krea's MCP server」（KreaのMCPサーバーの上に作ったChatGPTのアプリ）と説明しています。
• できること：画像の生成と編集（モデルを名前で指定するか、近いものをアプリに選ばせる）、動画の生成、Kreaのコンテキストライブラリにフォルダを作ること、会話の中のファイルをそこへ写すこと。
• モデル：ページが個別に名前を挙げているのは「Krea 3」だけです。更新履歴には、2026年10月20日に「Pick Krea 3 from the model selector in Krea for ChatGPT」、2026年9月1日に「The Krea plugin is now live in ChatGPT」の項目があります。

渡るデータ、外し方

• このアプリに特有のデータの扱い（何が送られ、どこに残るか）は、ページに書かれていません。ページの下部に、Privacy Policy、Terms of Service、Security、Subprocessorsへのリンクがあります。
• 外し方は、読んだページに書かれていません。更新履歴に、「Reconnecting ChatGPT no longer shows 0 credits」（2026年10月20日）という不具合修正の項目があり、つなぎ直す操作はある、と読めます。
• ページのFAQ（MCPと同じ接続か、など）は、質問の見出しだけが読め、答えは読めていません。

7. デスクトップのソフト（プラグイン）と、Agent

プラグイン（Photoshop、After Effects、Blenderなど）の入れ方は、05の「プラグインを入れる」に書きました。ここでは、AIとの組み合わせに関わる記述だけを書きます。

• Agentがデスクトップのソフトを動かす：更新履歴の2026年10月20日に「Krea Agent can now drive connected desktop apps like Blender, not just Photoshop.」（Krea Agentが、つないだデスクトップのソフトを動かせるようになった。Photoshopだけでなく、Blenderなども）とあります。Agent APIには、desktopAppId（つないだデスクトップのアプリのUUID）という項目があります。
• どう「つなぐ」か：どの画面で、どの操作で、デスクトップのソフトをAgentにつなぐのかは、読んだページには書かれていません。Blenderの公式ページには、Agentがソフトを動かす記述はありません。公式の資料では確認できていません。
• ほかの記述：更新履歴の2026年10月16日に「Fixed issues in the Agent panel for After Effects」（After EffectsのAgentパネルの修正）の項目があります。

外し方のまとめ（公式に書かれた範囲、この記事の範囲）

渡るデータのまとめ（公式に書かれた範囲、この記事の範囲）

Agent API、API、Zero Data Retentionなどのまとめは、08にあります。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。手順は、公式の手順を順に並べたものです。「この記事の案」「この記事の例」と書いた依頼文は、この記事で組んだもので、動作は確かめていません。
• 公式のMCPページ（OAuthが既定）とMCPの紹介ページ（トークンをヘッダで渡す形）で、Claude Codeの書き方が違います。どちらかに決めつけていません。請求先が変わります。
• ChatGPT向けやプラグインのFAQは、質問の見出しだけが読め、答えは読めていません。
• トークンの値は、設定ファイル、画面共有、チャットに貼らないでください。公式の注意も、環境変数に入れ、バージョン管理に入れない、です。
• 規約や料金は変わります。使う前に、公式で最新を読んでください。

出典

• Krea Model Context Protocol (MCP) server（Krea、確認日 2026-10-25）
• Krea MCP（紹介ページ、Krea、確認日 2026-10-25）
• Krea for ChatGPT（Krea、確認日 2026-10-25）
• Krea plugins（Krea、確認日 2026-10-25）
• Krea Agent（Krea、確認日 2026-10-25）
• API keys and billing（Krea、確認日 2026-10-25）
• Krea changelog（Krea、確認日 2026-10-25）
• Krea for Blender（Krea、確認日 2026-10-25）
• Krea docs（目次 llms.txt、Krea、確認日 2026-10-25）