3行でいうと
- つなぎ方は大きく5つです。①MiniMax-MCP(Claude Desktop、Cursor、Cherry Studioなどに登録)、②mmx-cli(AIエージェントの技能として入れる、または設定ウィザードで各ツールに設定)、③M PlanをClaude CodeやCursorなどにつなぐ(主に文章のモデル向け)、④動画生成APIを自分のプログラムから呼ぶ、⑤公開された重みを自分の機械で動かす。
- MCPのREADMEの最新のリリース記載は2025年7月で、対応する動画モデルはMiniMax-Hailuo-02までです。H3の記載は、読んだ範囲のMCPのREADMEやガイドには出てきませんでした。
- MCPに書く設定には、APIキーが入ります。鍵と接続先(
api.minimax.ioかapi.minimaxi.com)は同じ地域のものにそろえる、と公式は書いています。 - 設定を外す手順(MCPの登録の削除、鍵の失効)は、読んだページには書かれていませんでした。mmxのセットアップウィザードは、書き換えるファイルを
.bakで控える、と書いています。 - 公式の資料には、「ほかの会社のAIアプリが、Hailuoのサイトにログインして使う」ための連携(OAuthの公開など)の記述は見つかりませんでした。
この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。設定例は「公式の例に合わせた骨組み」と「この記事で組んだ例(動作は確かめていません)」を区別します。公式ページは要約の形で取得したため、設定ファイルの中身は、記号や改行の細部が崩れていることがあります。ここに載せた設定の骨組みは、置き場所と項目の名前を示すためのもので、全文は必ず公式ページを見て写してください。鍵などの値はすべてプレースホルダです。画面の表記は変わるので、手元の画面と照らしてください。
先に結論
- まず、どの口を使うかを決める。 AIアプリ(チャットのアプリ)に、動画や画像の生成をツールとして持たせたいなら、①のMCPです。ターミナルのコマンドでも足りるなら、②のmmx-cliで、公式のMCPのREADMEは、新しいモデルや追加の機能を持つ公式のコマンドラインのツールとして、mmx-cliに触れています。
- 鍵の種類を先に確かめる。 従量課金の API Key と、M Planの Subscription Key は別で、取り換えられない、と公式は書いています(05)。
- MCPは日付を見る。 READMEの最新のリリース記載は2025年7月2日(Pythonの方)で、JavaScript版は2025年7月22日です。H3を呼べるのかは、公式の資料では確認できていません。
- 使うたびに費用がかかる。 MCPのREADMEは、使うと費用がかかることがある、と書いています。AIアプリに任せると、気づかないうちに生成が走ることがあります(この点は、この記事の見立てです)。
前提:用語をそろえる
- MCP(Model Context Protocol)。 AIアプリが外のツールを呼ぶための共通の約束です。公式のガイドは「アプリがLLMに文脈を与える方法を標準化する公開のプロトコル」という趣旨で説明しています。
- MCPサーバー。 ツールを提供する側のプログラムです。この記事では、MiniMaxが出しているPython版(
minimax-mcp)とJavaScript版(minimax-mcp-js)が出てきます。 - MCPクライアント。 ツールを呼ぶ側のアプリです。Claude Desktop、Cursor、Cherry Studioなどです。
- stdio、SSE、REST。 MCPサーバーとクライアントのつなぎ方です。公式のガイドは、stdioはローカルだけ、SSEとRESTはローカルでもクラウドでもよい、クラウドで動かすときはURL入力を使う、と書いています。Python版はstdioとSSE、JavaScript版はstdioとRESTとSSEです。
- uv / uvx。 Pythonのパッケージ管理のツールです。Python版のMCPを動かすのに使います。
- 設定ファイル。 クライアントがどのMCPサーバーを使うかを書いておくファイルです。Claude Desktopなら
claude_desktop_config.jsonです。 - 環境変数。 鍵などの値を、ファイルに直接書かず、OSに持たせておく方法です。
- スキル(skill)。 AIエージェントに、特定の使い方を教える部品です。mmx-cliのREADMEにある
npx skills addは、この導入です。
連携の地図
| 連携 | 何をつなぐか | 設定する場所 | 必要なもの | 公式の記載の厚さ |
|---|---|---|---|---|
| MiniMax-MCP(Python) | 音声、画像、動画の生成をAIアプリのツールに | クライアントの設定ファイル | APIキー、uv |
READMEとガイド |
| MiniMax-MCP-JS | 同上のJavaScript版 | 同上 | APIキー、Node.js | READMEとガイド |
| mmx-cli(技能として) | AIエージェントがコマンドを使えるようにする | npx skills add |
Node.js 18以上、鍵 | README |
| mmx agent setup | 各コーディング用のAIツールにMiniMaxを設定 | 各ツールの設定ファイル | 鍵 | セットアップウィザードのページ |
| M Plan × AIツール | 文章のモデルをClaude Codeなどから使う | 環境変数、設定ファイル | Subscription Key | 一部だけ読了 |
| 動画生成API | 自作のプログラムから直接 | プログラム | APIキー(従量課金) | API文書 |
| 公開された重み | 自分の機械で動かす | ComfyUIなど | GPU、ライセンス | deployページ |
連携1:MiniMax-MCP(Python版)をClaude Desktopに登録する
公式の記載: MiniMax-MCPのREADME(GitHub、MiniMax-AI)と、MiniMaxドキュメントの「Introduction to MCP」。
手順(公式の手順を順に並べたもの)
- APIキーを取る。 05の「鍵を作る:従量課金のとき」の手順です。READMEは、GlobalかMainlandか、地域を合わせて取る、と書いています。
uvを入れる。 READMEは、macOSとLinuxの導入の1行(curlで取った導入のスクリプトをshに渡す形)か、uvのリポジトリの方法を示します。ガイドは、Windows用に、PowerShellで導入のスクリプトを取って実行する形を別に示しています。どちらもインターネットから取ったスクリプトを実行する操作です。正確なコマンドは、公式のREADMEとガイドの原文を見て写してください。この記事では写しません。uvxの場所を確かめる。 macOSとLinuxはwhich uvx、Windowsは(Get-Command uvx).sourceです(ガイドの記載)。READMEは、spawn uvx ENOENTのエラーが出たら、uvxの絶対パスを設定のcommandに書く、と書いています。- Claude Desktopの設定ファイルを開く。 READMEは「Claude > Settings > Developer > Edit Config」と書き、
claude_desktop_config.jsonを編集する、としています。Windowsでは、Claude Desktopのハンバーガーメニューの「Help」から「Enable Developer Mode」を有効にする、と書かれています。 - 設定を書く。 MiniMaxドキュメントのガイド(Python版)の例に合わせて、この記事で組んだ骨組みは次のとおりです(動作は確かめていません)。鍵と場所はプレースホルダです。全文は公式のREADMEとガイドで確認してください。
json
{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": ["minimax-mcp"],
"env": {
"MINIMAX_API_KEY": "<あなたのAPIキー>",
"MINIMAX_MCP_BASE_PATH": "<出力を置くフォルダの絶対パス>",
"MINIMAX_API_HOST": "https://api.minimax.io",
"MINIMAX_API_RESOURCE_MODE": "url"
}
}
}
}
READMEの例は args を ["minimax-mcp", "-y"] と書き、MINIMAX_API_HOST は地域ごとの接続先を入れる形です。ガイドの例は -y が無く、接続先は https://api.minimax.io だけです。2つの公式ページで違うので、どちらにも決めつけません。中国本土の鍵なら、READMEは https://api.minimaxi.com と書いています(ガイドには記載がありません)。MINIMAX_API_RESOURCE_MODE は省略でき、省略時は url です。
6. Claude Desktopを再起動する。 ガイドは「then restart」の趣旨で書いています。
7. ツールが見えるか確かめる。 見える名前は後ろの表のとおりです。ツールの一覧を画面のどこで見るかは、公式の資料では確認できていません。
環境変数の意味
| 変数 | 意味(公式の記載) |
|---|---|
MINIMAX_API_KEY |
鍵 |
MINIMAX_API_HOST |
接続先。https://api.minimax.io(Global)か https://api.minimaxi.com(Mainland) |
MINIMAX_MCP_BASE_PATH |
生成物を置くローカルのフォルダ |
MINIMAX_API_RESOURCE_MODE |
url(初期値。URLで返す)か local(ローカルに保存する) |
ツール(公式の記載)
| ツール | 何をするか |
|---|---|
text_to_audio |
文章を声にする |
list_voices |
声の一覧 |
voice_clone |
音声ファイルから声を複製する |
voice_design |
文章の説明から声をつくる |
play_audio |
音声を再生する(ガイドの記載) |
text_to_image |
画像をつくる |
generate_video |
文章や最初のコマの画像から動画をつくる |
query_video_generation |
動画の課題の状態を見る |
- ガイドによると、
generate_videoはprompt、model(初期値はT2V-01)、first_frame_image、duration(6か10)、resolution、async_modeなどを持ちます。READMEは、2025年7月2日のリリースでMiniMax-Hailuo-02の動画に対応し、6秒か10秒、768Pか1080Pに対応と書いています。 - 非同期の
generate_videoを使うときの注意として、READMEは、完了の規則を先に決めておく、IDEの設定にその規則を書くこともできる、と書いています。
渡るデータと権限
- 鍵。 設定ファイルの
envに、平文で書かれます。ファイルを読める人やプログラムに見えます(これは設定の形から読める事実で、公式は鍵の保管について詳しく書いていません)。 - 入力。 AIアプリがツールを呼ぶと、文章や画像のURL、ファイルが、設定した接続先(
api.minimax.ioかapi.minimaxi.com)に送られます。どこに保存され何に使われるかは、API利用の契約(Paid Services Agreement)に書かれているはずですが、本文は読めていません。 - 出力。
urlなら、生成物の場所のURLがAIアプリに返ります。localなら、MINIMAX_MCP_BASE_PATHのフォルダに保存されます。 - ファイルの権限。 Python版の公式の資料に、読み書きできるフォルダを絞る仕組みの説明は、見つかりませんでした。
外し方
- 設定ファイルの登録の外し方、鍵の失効の手順は、読んだページには書かれていませんでした。
- この記事の案(公式の手順ではありません):クライアントの設定ファイルから、上の
MiniMaxのブロックを消して、クライアントを再起動します。そのうえで、鍵を使い回していないかを確かめ、API Platformの画面で鍵の扱いを確認します。鍵の削除の画面は、読んだ範囲では確認できていません。
うまくいかないときの確認点
| 症状 | 公式の記載 | 確認点 |
|---|---|---|
Invalid API key |
鍵と接続先の地域が違うと起きる | 鍵の発行元と MINIMAX_API_HOST |
spawn uvx ENOENT |
uvx の絶対パスを command に書く |
which uvx の結果 |
| ツールが出ない | 公式に説明は見つからず | 設定ファイルのJSONの形、再起動 |
| 動画の完了を待たない | 完了の規則を先に決める | IDEやプロンプトの設定 |
連携1の続き:CursorとCherry Studio
Cursor。 公式の2つのページで、画面の経路の書き方が違います。READMEは「Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server」と書き、同じ設定を入れる、としています。ガイドは「Customize > MCPs > New」で、mcp.json に追加する、と書いています。手元のCursorの画面と照らして、どちらかの経路を探してください。Python版は uvx minimax-mcp、JavaScript版は npx -y minimax-mcp-js です。
Cherry Studio。 ガイドは「Settings > MCP Settings > Add Server > Import from JSON」と書き、command、args、env の形は同じ、としています。
そのほか。 READMEは、Windsurf、OpenAI Agentsなどでも使える、と書きますが、個別の設定は示していません。
連携1の別版:MiniMax-MCP-JS(JavaScript版)
- 導入は、Claude Desktopの設定に
npx -y minimax-mcp-jsを書く形です。ほかに、pnpm add minimax-mcp-js、Smitheryを使う導入が書かれています。 - 環境変数は4つ。
MINIMAX_API_KEY(必須)、MINIMAX_API_HOST、MINIMAX_MCP_BASE_PATH、MINIMAX_RESOURCE_MODE(urlかlocal)。Python版はMINIMAX_API_RESOURCE_MODEで、名前が違います。 - Claude Desktopの設定の骨組みは、
mcpServersの下にminimax-mcp-jsという名前で、commandにnpx、argsに-yとminimax-mcp-js、envに上の変数、という形です。全文は公式のREADMEを見てください。 - 伝送の方法は、stdio(初期値)、REST、SSEです。
- ツールについて、READMEの一覧には
image_to_videoが無く、MCPのガイドはimage_to_videoをJavaScript版だけのツールとして挙げています。2つの公式ページで違うので、どちらにも決めつけません。動画のモデルは、MiniMax-Hailuo-02が初期値で、T2V-01、I2V-01、S2V-01などの旧モデルも挙がっています。H3の記載は、READMEに見つかりませんでした。最新のリリース記載は2025年7月22日です。 - 接続先として、READMEの中で表記がそろっていません。READMEの表は Global を
api.minimaxi.chat、Mainland をapi.minimax.chatと書き、別の注記は Mainland をapi.minimaxi.chatと書いています。Python版のREADMEやガイドのapi.minimax.io、api.minimaxi.comとも異なります。使う前に、READMEで確かめてください。
連携2:mmx-cliをAIエージェントにつなぐ
公式の記載: mmx-cliのREADME(GitHub、MiniMax-AI/cli)と、ドキュメントの「One-click setup wizard」。
2-A:技能(skill)として入れる
- Node.js 18以上を確かめます。
- READMEの導入の1行を実行します。READMEの記載は次の形です。
bash
npx skills add MiniMax-AI/cli -y -g
3. サインインは、人間がターミナルで mmx auth login を実行します。セットアップウィザードのページにある、AIエージェント向けの導入の文面は、エージェントにCLIを入れさせ、mmx --version で確かめさせ、サインインはユーザー自身のターミナルで行わせ、鍵はエージェントに求めさせたり表示させたり保存させたりしない、技能はサインインの確認のあとで入れる、使用量は mmx quota で見る、という趣旨を書いています。
4. 渡るデータ:エージェントが mmx コマンドを実行すると、文章や画像などが、設定の地域のMiniMaxのAPIに送られます。認証の情報は ~/.mmx/config.json にあります(READMEの記載。OAuthのトークンは自動で更新されます)。
2-B:セットアップウィザードで、各ツールにMiniMaxを設定する
mmx agent setup は、対応するAIコーディングツールの設定ファイルに、MiniMaxを書き込みます。公式のページの記載を並べます。
- Node.js 18以上で、次を実行します(対話型)。
bash
npx -y mmx-cli@latest agent setup
2. 対話で、ツールを選び、未導入のものは導入するかを選び、地域と鍵の種類(Subscription Keyか従量課金のAPI Key)を選んで、鍵を入れます。
3. 対応ツールは、公式のページの表記で、Claude Code、Codex CLI、OpenCode、Grok CLI、Hermes Agent、Piの6つです(mmx-cliのREADMEは、Codex、Grok Buildなどと少し違う表記で書いています)。このページのURLと題は「token-plan」ですが、本文は鍵の sk-cp- を「M Planで使うSubscription Key」と書いており、Token PlanとM Planの書き分けが公式ページ同士でそろっていません。
4. 対話しない形では、--agent <名前>(繰り返せる)、--all、--api-key <鍵>、--region cn|global、--model <モデル>、--dry-run(確認だけで書かない)、--output json が使えます。この形はツールを導入せず、設定の書き込みだけを行う、と書かれています。READMEのagent setupの記載とあわせて、「エージェントを起動することはしない」とも書かれています。
書き換えられるファイル(公式の記載)
| ツール | ファイル |
|---|---|
| Claude Code | ~/.claude/settings.json |
| Codex | ~/.codex/config.toml、~/.codex/mmx-model-catalog.json |
| Grok CLI | ~/.grok/config.toml |
| OpenCode | ~/.config/opencode/opencode.json または opencode.jsonc |
| Hermes Agent | ~/.hermes/config.yaml、~/.hermes/.env |
| Pi | ~/.pi/agent/models.json、~/.pi/agent/settings.json |
公式が書く設定書き換え時の動き、渡るデータ、外し方
- 変更の範囲。 選んだツールのMiniMaxの設定だけを変え、ほかの提供元の設定は残す、と書かれています。
- 控え。 既存のファイルを変える前に、日時つきの
.bakの控えを作る、と書かれています。 - ファイルの権限。 Windows以外では、現在のユーザーだけが触れる権限にする、と書かれています。
- 失敗時。 途中で失敗したら、変えたファイルを元に戻す、と書かれています。
- 外し方。 専用の取り消しのコマンドは、ページに書かれていません。完了したあとは、
.bakの控えから戻せる、と読めます(公式は「戻す手順」とは書いていません)。導入したツールを外せるかも、書かれていません。 - 渡るデータ。 設定したツールが、MiniMaxのAPIを呼ぶようになり、そのツールで書く内容や指示文が、設定した地域の接続先に送られます。これは、設定の趣旨から読める範囲です。公式のページが書いているのは、鍵の確認のためにネットワーク通信が行われること(
--dry-runでは行われない)、地域が鍵から判定されること、導入時に公式の導入コマンドが走ることまでで、ほかに何が送られるかの説明は見つかりませんでした。 - つまずき。
ANTHROPIC_BASE_URLやOPENAI_BASE_URLなどの環境変数が、設定ファイルより優先されることがある、と書かれています。Codexのmodel_catalog_jsonが別のファイルを指しているときは、ウィザードは何も変えずに止まる、と書かれています。ツールがPATHに見つからないとき、対話型では導入を提案する、とも書かれています。 - 前提のOSなど。 自動導入は、Pi以外ではarm64かx64のシステムが必要、と書かれ、Piは Node.js 22.19以降が必要、と書かれています(対応OSの一覧は、今回の再確認では確認できていません)。
連携3:M PlanをAIツールにつなぐ(主に文章のモデル向け)
公式の記載: M Planの紹介ページ、M Planのクイックスタート、ドキュメント索引。個別の「Claude Code」「Cursor」「Codex」などの連携ページは、索引で題名を確認しただけで、中身は読めていません。
- ドキュメントの索引には、M Plan向けに、MiniMax Code、Claude Code、Codex、Cursor、OpenCode、Pi、Hermes Agent、OpenClaw、Other Toolsのページが並んでいます。Token Plan向けにも、TRAEを含む別の一覧があります。
- M Planの紹介ページは、MiniMax Codeというアプリで使うなら別の鍵は要らず、Claude Code、Codex、Cursor、OpenCodeなどには、M Planの鍵を使う、と書いています。
- M Planのクイックスタートが示す、動作確認の環境変数は次の形です。
bash
export ANTHROPIC_BASE_URL=https://api.minimax.io/anthropic
export ANTHROPIC_API_KEY=<M PlanのSubscription Key>
これは、Anthropic SDKからMiniMaxの文章のモデルを呼ぶ例です。動画生成の連携ではありません。M Planの紹介ページは、動画のモデル(H3)はExploreとBuildに含まれ、動画の生成は文章よりずっと多く使う、と書いています。
- 動画生成を、これらのツール経由で呼ぶ手順は、読んだ範囲には書かれていませんでした。
- M Planの紹介ページは、M Planの鍵を「API Key」と書き、クイックスタートは「Subscription Key」と書いています。呼び名が公式ページ同士でそろっていないので、どちらにも決めつけません。
連携4:動画生成APIを自分のプログラムから呼ぶ
手順の本体は06の場面6〜7です。ここでは「つなぐ」側の要点だけ書きます。
- 認証。
Authorization: Bearer <API Key>。接続先はhttps://api.minimax.io。 - 完了の通知。 公式のAPI文書(作成のページ)は
callback_urlを書いています。設定すると、まず確認の依頼が来て、本文のchallengeの値を3秒以内にそのまま返す必要があります。確認後は、状態が変わるたびに、課題の問い合わせと同じ形の本文が、そのURLにPOSTされます。状態はqueued、running、succeeded、failed、cancelledです。一方、動画生成のガイドのページは、コールバックの記述はなく、公式に書かれた確認の方法は問い合わせ(ポーリング)だけ、という書き方でした。2つのページで説明が違うので、作成のAPIのページを原文で確認してください。 - 渡るデータ。 文章、画像、動画、音声。公開のURL、
mm_file://{file_id}、Base64のどれかで渡します。callback_urlを指定すると、課題の結果の情報が、そのURLの持ち主に送られます。 - 強化した指示文。 別の課題(
task_type=h3_context_ir、作成は/v2/h3_context_ir)で、動画をつくらずに、改善された指示文を返してもらう口があります。結果は問い合わせの返事のcontent.promptに入ります。 - 再生成。 768Pで作ったH3の動画を2Kにする口(作成は
/v2/video_regeneration)があり、元のcontentをすべて繰り返し、role=base_videoの動画を1つ足す、と書かれています。 - 取り消しと削除。 06のとおり、
queuedなら取り消し(料金なし)、succeededかfailedなら記録の削除です。 - 制限。 公式のレート制限の表(確認日 2026-10-25)は、Hailuo系が毎分20回、H3のV2が毎分300回で同時に走る課題が30まで、と書いています。上げたいときの窓口は、ページに api@minimax.io と書かれています。
連携5:公開された重みを自分の機械で動かす(ComfyUIなど)
公式の記載: ドキュメントの「Run and self-host MiniMax H3」。03の内容に、導入の順序を足します。
ComfyUIの手順(公式の記載を順に並べたもの)
- ComfyUIを 0.30.0 以降に更新して起動します。
- 「Template Library > Video」から、H3のT2V、I2V、R2Vのどれかを選びます。
- モデルを探す画面(pop-up)の案内に従い、ファイルを取得します。一覧が更新されなければ、ComfyUIを再起動します。
- 文章と、あれば画像、動画、音声の参照を入れます。
- 解像度の選択で、0.98メガピクセルで32の倍数にするか、1344×768を直接指定します。1.0メガピクセルの段は1376×768になり、上限を超える、と書かれています。
- 実行します。出力は、24FPSのMP4でステレオ音声つき、と書かれています。
手動で入れるときの置き場所は、T2V/I2Vの本体とR2Vの本体が models/diffusion_models/(互換ではない)、文章のエンコーダが models/text_encoders/、映像と音声のVAEが models/vae/、任意のTurbo LoRAが models/loras/、と書かれています。
守る条件と、渡るデータ
- 重みの出どころ。 公式の重みはHugging Faceの
MiniMaxAI/MiniMax-H3(改訂42ed227に固定)。ModelScopeの鏡もあります。ComfyUI向けは、Comfy-Orgの別のリポジトリにあり、枝刈りと量子化をした変換で、公式の元の重みとは別のもの、と書かれています。 - ライセンス。 MiniMax H3 Community License。米国、EU、英国、韓国は、別の許諾が必要な地域(Excluded Territories)です。取得、展開、公開の前に、最新の原文を確かめる、と書かれています。公開版には、H3-Context-IRとH3-Regenerate-2Kは含まれません。
- データ。 どちらの経路も、自分の機械かサーバーで動き、重みと生成物(MP4)は手元に保存される、と書かれています。ComfyUIの動作に必要な最低のGPUメモリは、書かれていません。
- SGLangの経路。 プレビューの扱いで、参照の構成は8枚のNVIDIA B200を積んだ1台、重みは約108GB、と書かれています。サービスは初期状態で 127.0.0.1 に結ばれ、外に公開しない。公開するなら、認証、TLS、アクセス制御が必要、と書かれています。ネットから切り離した機械には、モデルのフォルダを持ち込み、
HF_HUB_OFFLINE=1で動かせる、とも書かれています。
連携6:第三者のもの(この記事では読んでいない)
03で、第三者のMCPの名前(検索結果の題名と説明だけを根拠にしたもの)を挙げました。中身は読んでおらず、この記事では手順を書きません。第三者のものは、入力がその運営に渡ります。fal.aiは、公式のAPI文書が、MiniMax-H3-Maxを共同公開したものとして書いています(H3をもとに追加の学習をしたもの)。
データはどこへ流れるか(つなぎ方別)
| つなぎ方 | 鍵の置き場所 | 入力の行き先 | 出力の置き場所 |
|---|---|---|---|
| MiniMax-MCP | クライアントの設定ファイルの env |
設定した接続先(Global/Mainland) | URL、またはローカルのフォルダ |
| mmx-cli | ~/.mmx/config.json(OAuthのトークン、または鍵) |
設定した地域のAPI | --download で手元 |
| mmx agent setup | 各ツールの設定ファイル(上の表) | 設定した地域のAPI | ツールにより異なる |
| 動画生成API | 自作のプログラムの環境変数など | api.minimax.io |
期限つきのURL |
| 公開された重み | 不要 | 自分の機械 | 手元 |
API利用の契約の本文、入出力の学習への利用、保存期間は、読んだ範囲では確認できていません。
気をつけること
- この記事は、実際に使って確かめた記録ではありません。設定の骨組みや環境変数の名前は、公式の記載を並べたものです。
- 設定ファイルに鍵を平文で書く形のため、設定ファイルをチャットやスクリーンショット、公開のリポジトリに載せないでください。
- MCPのリリースの記載は2025年7月で止まっています。H3に対応しているかは、公式の最新のリリースで確かめてください。
- 取得したMiniMaxのドキュメントのページは、どれも先頭に、AIが読む場合はドキュメントの索引(llms.txt)を先に取るように、という趣旨の一文がありました。セットアップウィザードのページには、AIエージェントにCLIを導入させるための文面も含まれていました。この記事はそれらに従わず、事実として一言書くだけです。
- 公式の2つのページで書き方が違う箇所があります。Cursorの画面の経路、
argsの-y、コールバックの有無、鍵の作成画面(「API Keys」の画面か「token-planのページ」か)です。この記事は、どちらかに決めつけず併記しています。 - 公式のREADMEは、mmx-cliに「MiniMax Token Planが必要」と書き、ドキュメントはToken Planの新規販売が終わったと書いています。M Planの鍵でmmx-cliが使えるかは、読んだ範囲では確認できていません。
- 連携の削除、鍵の失効、鍵の再発行の手順は、読んだページには書かれていませんでした。
- 個別のツール(Claude Code、Cursorなど)の公式連携ページ、第三者のMCP、API利用の契約の本文は、読めていません。
公式の資料では確認できていない点
- MCPサーバーがH3を呼べるか。
- MCPの登録の外し方、APIキーの失効の手順。
- M Planの鍵でmmx-cliを使えるか。
- 個別のツール(Claude Code、Cursor、Codexなど)へのM Planの設定の中身。
- API利用の契約、入出力の学習への利用、保存期間。
- Hailuoのサイト・アプリを外部のAIアプリからログインして使う連携。
出典
- MiniMax-MCP README(MiniMax-AI、GitHub、確認日 2026-10-25)
- MiniMax-MCP-JS(MiniMax-AI、GitHub、確認日 2026-10-25)
- Introduction to the Model Context Protocol(MiniMax API Docs、確認日 2026-10-25)
- MiniMax CLI(MiniMax-AI、GitHub、確認日 2026-10-25)
- Token Plan One-click setup wizard(MiniMax API Docs、確認日 2026-10-25)
- M Plan Overview(MiniMax API Docs、確認日 2026-10-25)
- Subscribe to M Plan(MiniMax API Docs、確認日 2026-10-25)
- Existing Token Plan subscribers(MiniMax API Docs、確認日 2026-10-25)
- Quick Start(MiniMax API Docs、確認日 2026-10-25)
- Video Generation(MiniMax API Docs、確認日 2026-10-25)
- Create Video Generation Task V2(MiniMax API Docs、確認日 2026-10-25)
- Cancel or Delete Task V2(MiniMax API Docs、確認日 2026-10-25)
- Rate Limits(MiniMax API Docs、確認日 2026-10-25)
- Run and self-host MiniMax H3(MiniMax API Docs、確認日 2026-10-25)
- MiniMax API Docs 索引 llms.txt(MiniMax API Docs、確認日 2026-10-25)