MCP で接続する

Aether はリモートの Model Context Protocol(MCP)サーバーを提供しています。Claude、Claude Code、Cursor、Antigravity、Codex、ChatGPT など MCP に対応した AI アシスタントから、Aether アカウントで画像・エフェクト・スプライトの生成と画像の調整を利用できます。

サーバー URL

https://api.aetherforgeai.com/mcp

Streamable HTTP トランスポートを使用します。

Aether アカウントで接続する(推奨)

クライアントにサーバー URL を追加します。初回接続時に、ブラウザで Aether の接続ページが開きます。

1. ログインしていない場合は Aether にログインします。ログイン後、接続ページに自動で戻ります。
2. クライアント名と戻り先のアドレスを確認します。
3. 接続 を選択します。

その後、クライアントは専用のアクセストークンを受け取ります。アクセストークンは 1 時間で期限切れになり、クライアントが自動で更新します。

使用するクライアントを選んでください。

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp

次に Claude Code で /mcp を実行し、aether を選ぶとログインが始まります。

Claude

Claude(Web・デスクトップ)で 設定 → コネクタ → カスタムコネクタを追加 を開き、サーバー URL を入力して 追加 を選択します。続けて 接続 を選ぶとログインが始まります。Claude はチャットからファイルをアップロードできないため、画像入力には以前の結果の job_id を渡します。

Cursor

mcp.json(設定 → MCP)にサーバーを追加します。サーバーが Needs login と表示されたら選択してブラウザでログインします。

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp"
    }
  }
}

Antigravity

Antigravity CLI にサーバーを登録してセッションを開始します。サーバーを初めて使うときにブラウザでログインが開きます。ブラウザが CLI に戻れない場合は、CLI の求めに応じてアドレスバーの最終 URL を貼り付けます。

agy mcp add aether https://api.aetherforgeai.com/mcp
agy

Codex

サーバーを登録してログインします。ログインはブラウザで開きます。

codex mcp add aether --url https://api.aetherforgeai.com/mcp
codex mcp login aether

ChatGPT

ChatGPT で 設定 → コネクタ → 詳細 → 開発者モード を開き、作成 を選択します。名前とサーバー URL を入力し、認証に OAuth を選んでから 作成、接続 の順に選ぶとログインが始まります。ChatGPT はチャットからファイルをアップロードできないため、画像入力には以前の結果の job_id を渡します。

API キーで接続する

カスタムヘッダーを送信できるクライアントは、ログインの代わりに API キー を使用できます。Claude と ChatGPT のコネクタはアカウントログインのみ対応です。

Authorization: Bearer <api_key>

Claude Code

claude mcp add --transport http aether https://api.aetherforgeai.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

mcp.json のサーバー項目に headers を追加します。

{
  "mcpServers": {
    "aether": {
      "url": "https://api.aetherforgeai.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Antigravity

agy mcp add --header "Authorization: Bearer YOUR_API_KEY" aether https://api.aetherforgeai.com/mcp

Codex

Codex は環境変数からキーを読み取ります。

export AETHER_API_KEY=YOUR_API_KEY
codex mcp add aether --url https://api.aetherforgeai.com/mcp --bearer-token-env-var AETHER_API_KEY

ツール

すべてのツールは、Web アプリの対応ページと同じオプションとクレジット消費を使います。

ツール	Web の機能	クレジット消費
create_image_upload	他のツールで使う画像のアップロード	無料
get_job_status	ジョブの状態と結果 URL	無料
get_credit	クレジット残高	無料
list_my_ai_models	Aether 生成で使えるモデル	無料
list_my_results	履歴(tool、sprite、aether)	無料
generate_image	画像生成	1 (GPT Image 2)、2 (GPT Image 2.5 High、Nano Banana Pro)、3 (GPT Image 2.5 XHigh)
generate_effect_v1	エフェクト生成 V1 タブ	5 (1K)、7 (2K)、10 (4K)
generate_effect_v2	エフェクト生成 V2 タブ	3
upscale	アップスケール	5 (1K)、7 (2K)、10 (4K)
inpaint_v1	インペイント V1 タブ	5
inpaint_v2	インペイント V2 タブ	3
remove_background	背景除去	1
equip_variation	装備バリエーション	5
sprite_lite	Sprite Lite	フレーム数により 5〜13
sprite_plus	Sprite Plus	9(49 フレーム)、13(81 フレーム)
sprite_zenith	Sprite Zenith	9(36 フレーム)、25(100 フレーム)
sprite_pulsar	Sprite Pulsar	3、Sprite To Sprite は 4
aether_generate	Aether	含まれるモデルは無料、それ以外は 2。モデルごとの費用は list_my_ai_models の credit_cost

フィールド名と許容値は、対応する エンドポイント のページと同じです。

結果の受け取り

生成ツールは非同期ジョブを開始し、すぐに job_id を返します。その job_id で get_job_status を呼び出して結果を受け取ります。wait_seconds(最大 60)を指定すると、ツールが返る前にジョブの完了を待ちます。status が Succeed になると、image_urls に結果画像が入り、スプライトの場合は GIF も入ります。状態の値は 非同期ジョブのライフサイクル を参照してください。

generate_image はウェブの履歴ページにチャットルームも作成し、API/MCP タブに表示されます。結果の chat_room_id がそのルームで、ウェブでそのルームを開いて続けて生成できます。

画像の入力

画像フィールドには次のいずれかを指定します。

• create_image_upload で受け取った upload_id。画像の Content-Type を指定してツールを呼び出し、返された upload_url に 5 分以内に HTTP PUT でファイルをアップロードしてから upload_id を渡します。
• 完了した自分のジョブの job_id。その結果画像をそのまま使います。たとえば upscale の後に remove_background のようにツールをつなげられます。

curl -X PUT -H "Content-Type: image/png" --data-binary @character.png "<upload_url>"

アップロードには、Claude Code、Cursor、Antigravity、Codex のようにコマンドを実行したり HTTP リクエストを送れるクライアントが必要です。ファイルをアップロードできないチャットアプリでは、完了済みの job_id を代わりに使います。

エラー

ツール呼び出しが失敗すると、結果の代わりにエラーメッセージを返します。クレジットが不足している場合、メッセージに料金ページへのリンクが含まれます。