MCP サーバー

Atlas Cloud の公式 MCP サーバーを使用して、IDE から直接 AI モデルを利用できます。画像・動画・音声(TTS)・3D モデルの生成、LLM とのチャット、残高と使用量の確認が可能です。Cursor、Claude Desktop、Claude Code、Codex、Gemini CLI などに対応しています。

MCP とは?

Model Context Protocol (MCP) は、Anthropic が開発したオープンスタンダードで、AI アシスタントが外部ツールやデータソースと標準化された方法でやり取りできるようにするものです。MCP はユニバーサルアダプターのようなもので、Cursor、Claude Desktop、Claude Code などの AI 搭載 IDE がサードパーティのサービス、API、データにシームレスに接続できるようにします。

MCP を使用することで、開発者は AI アシスタントの機能を単純なコード補完をはるかに超えて拡張できます。ドキュメントの検索、画像・動画・音声・3D モデルの生成、LLM とのやり取りなど、すべてコーディング環境内の自然言語コマンドで実行できます。

Atlas Cloud MCP サーバー

Atlas Cloud は公式 MCP サーバーnpm の atlascloud-mcp)を提供しており、Atlas Cloud の AI API プラットフォームのすべての機能を IDE に直接統合します。画像、動画、3D、音声(TTS)、大規模言語モデルにわたる 400 以上の AI モデルが利用可能で、ブラウザタブを切り替えたり、手動で API コールを書いたりすることなくすべてにアクセスできます。

GitHub リポジトリ: AtlasCloudAI/mcp-server

対応モデル

  • 🎬 動画 — Seedance 2.0 · Kling 3 · Sora 2 · Veo 3.1 · HappyHorse 1 · Grok Imagine 1.5 · Wan 2.7
  • 🎨 画像 — Nano Banana 2/Pro · GPT Image 2 · Flux 2 · Seedream 5
  • 🧊 3D — Hunyuan 3D の image-to-3D / text-to-3D
  • 💬 LLM — Claude · GPT · DeepSeek · MiniMax · Kimi · GLM · Qwen
  • 🔊 音声(TTS) — Seed Audio · xAI/Grok TTS · ElevenLabs

完全なカタログはモデルページでご覧いただけます。

主な機能

  • ドキュメント検索 — IDE から直接 Atlas Cloud のドキュメント、モデル、API リファレンスを検索
  • モデル発見 — 400 以上の AI モデルを価格と機能情報付きで一覧表示・探索(タイプ別フィルター:Text/Image/Video/Audio)
  • 画像生成 — Nano Banana、GPT Image 2、Flux 2、Seedream などのモデルで画像を生成
  • 動画生成 — Seedance、Kling、Sora、Veo、Wan などのモデルで動画を生成
  • 3D 生成 — Hunyuan 3D でテキストや写真を 3D モデル(GLB/OBJ/USDZ)に変換
  • 音声生成(TTS) — Seed Audio、xAI/Grok TTS、ElevenLabs などで音声を合成
  • クイック生成 — キーワードから適切なモデルを自動検索し、パラメータを構築して画像/動画/音声をワンステップで生成
  • メディアアップロード — ローカルファイルをアップロードして URL を取得し、画像編集や image-to-video ワークフローで使用
  • LLM チャット — Claude、GPT、DeepSeek、Qwen、Kimi、GLM などの LLM と対話(OpenAI 互換)
  • 残高・使用量確認 — Atlas Cloud Public API 経由でアカウント残高、日次使用量、コスト内訳を確認
  • 動的スキーマ — 各モデルのパラメータスキーマを自動取得し、送信にパラメータを検証するため、無効なリクエストはクレジットを消費することなく即座に失敗します

前提条件

Atlas Cloud MCP サーバーをセットアップする前に、以下を準備してください:

設定

CLI エージェント(ワンラインインストール)

最速の方法です。以下の AI コーディングエージェントでは、コマンド 1 つでサーバーを追加できます:

# Claude Code
claude mcp add atlascloud -- npx -y atlascloud-mcp

# OpenAI Codex CLI
codex mcp add atlascloud -- npx -y atlascloud-mcp

# Gemini CLI
gemini mcp add atlascloud -- npx -y atlascloud-mcp

# Goose CLI
goose mcp add atlascloud -- npx -y atlascloud-mcp

次に、API キーを環境変数として設定します:

export ATLASCLOUD_API_KEY="your-api-key-here"

ターミナルセッション間で API キーを永続化するには、シェルプロファイル(~/.bashrc~/.zshrc など)に export コマンドを追加してください。

Cursor

設定ファイル ~/.cursor/mcp.json を開くか作成し、以下を追加します:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor を再起動して変更を適用します。

Claude Desktop

設定ファイルを開きます:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

MCP サーバーの設定を追加します:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop を再起動して変更を適用します。

Windsurf

Windsurf の MCP 設定に以下を追加します:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Codex

上記のワンラインインストールを推奨します。または、Codex の設定ファイル ~/.codex/config.toml を開くか作成し、以下を追加します:

[mcp_servers.atlascloud]
command = "npx"
args = ["-y", "atlascloud-mcp"]

[mcp_servers.atlascloud.env]
ATLASCLOUD_API_KEY = "your-api-key-here"

Gemini CLI

上記のワンラインインストールを推奨します。または、Gemini の設定ファイル ~/.gemini/settings.json を開くか作成し、以下を追加します:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

Kilo Code

プロジェクトレベルの設定ファイル .kilocode/mcp.json を開くか作成し、以下を追加します:

{
  "mcpServers": {
    "atlascloud": {
      "command": "npx",
      "args": ["-y", "atlascloud-mcp"],
      "env": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenCode

OpenCode の設定ファイル opencode.json を開くか作成し、以下を追加します:

{
  "mcp": {
    "atlascloud": {
      "type": "local",
      "command": ["npx", "-y", "atlascloud-mcp"],
      "enabled": true,
      "environment": {
        "ATLASCLOUD_API_KEY": "your-api-key-here"
      }
    }
  }
}

その他の MCP クライアント

同じ JSON 設定は、MCP 互換のすべてのクライアントで動作します:

クライアント追加場所
ClineMCP Marketplace → Add Server
Continueconfig.yaml → MCP
VS Code (Copilot).vscode/mcp.json または Settings → MCP
TraeSettings → MCP → Add Server
JetBrains IDEsSettings → Tools → AI Assistant → MCP
ChatGPT DesktopSettings → MCP
Amazon Q DeveloperMCP Configuration
Roo CodeSettings → MCP → Add Server

利用可能なツール

Atlas Cloud MCP サーバーは、AI アシスタントが使用できる 13 のツールを提供します:

ツール説明
atlas_search_docsキーワードで Atlas Cloud のドキュメントとモデルを検索
atlas_list_modelsすべての利用可能なモデルを一覧表示(タイプ別フィルター:Text/Image/Video/Audio)
atlas_get_model_infoAPI スキーマ、パラメータ、使用例を含むモデル詳細を取得
atlas_generate_image任意の対応 Image モデルで画像および 3D モデル(image-to-3D / text-to-3D)を生成
atlas_generate_video任意の対応動画モデルで動画を生成
atlas_generate_audio任意の対応音声モデルで音声/スピーチ(TTS)を生成
atlas_quick_generate画像/動画/音声をワンステップで生成 — キーワードからモデルを自動検索し、パラメータを構築して送信
atlas_upload_mediaローカルファイルをアップロードして URL を取得し、画像編集 / image-to-video モデルで使用
atlas_chatLLM モデルとチャット(OpenAI 互換形式)
atlas_get_prediction画像/動画/音声/3D 生成タスクのステータスと結果を確認
atlas_get_balanceAPI キーのアカウント残高とクレジットサマリーを取得
atlas_get_model_usage指定期間の日次モデル使用量(リクエスト数、トークン数、画像/動画数)を取得
atlas_get_model_costs指定期間の日次モデルコスト(支出)を取得

: 残高、使用量、コストの各ツールは Atlas Cloud Public APIhttps://api.atlascloud.ai/public/v1)を利用しているため、IDE を離れることなく支出とクォータを確認できます。

使用例

設定が完了したら、自然言語で Atlas Cloud とやり取りできます:

モデルの検索

  • "Atlas Cloud でビデオ生成モデルを検索して"
  • "すべての画像生成モデルと料金を表示して"
  • "DeepSeek V3 モデルの詳細を教えて"

画像の生成

"Seedream で宇宙の猫の画像を生成して"

アシスタントは:

  1. atlas_list_models で Seedream の画像モデルを検索
  2. atlas_get_model_info でモデルのパラメータを取得
  3. atlas_generate_image で正しいパラメータを使用して画像を生成

動画の生成

"Kling v3 でロケット発射の動画を作成して"

アシスタントは:

  1. Kling の動画モデルを検索
  2. スキーマを取得して必要なパラメータを把握
  3. atlas_generate_video で適切なパラメータを使用して動画を生成

画像編集や動画生成のためのローカル画像のアップロード

"この画像 /Users/me/photos/cat.jpg に帽子を追加して"

アシスタントは:

  1. atlas_upload_media でローカルファイルをアップロードして URL を取得
  2. 画像編集モデルを検索
  3. アップロードした URL を使用して atlas_generate_image を実行

: アップロードされたファイルは、Atlas Cloud の生成タスクでの一時的な使用のみを目的としています。ファイルは定期的に削除される場合があります。恒久的なファイルホスティングとして使用しないでください。不正利用があった場合、API キーが停止されることがあります。

音声合成(TTS)

"Seed Audio でこの文章を読み上げて:Welcome to Atlas Cloud"

アシスタントは:

  1. atlas_list_modelstype="Audio" で使用して TTS モデルを検索
  2. atlas_generate_audio で合成するテキストを送信
  3. atlas_get_prediction で生成された音声の URL を取得

3D モデルの生成

"Hunyuan 3D でこの商品写真を 3D モデルに変換して"

3D モデルは Image タイプのモデルであるため、アシスタントは image パラメータを指定して atlas_generate_image を使用し、atlas_get_prediction で GLB/OBJ/USDZ ファイルを取得します。

LLM チャット

"DeepSeek V3 に量子コンピューティングを説明してもらって"

アシスタントは atlas_chat で DeepSeek モデルを使用します。

残高と使用量の確認

"Atlas Cloud のクレジット残高はあとどれくらい?今月はいくら使った?"

アシスタントは atlas_get_balance で現在の残高を取得し、atlas_get_model_costs で支出の内訳を取得します。

トラブルシューティング

よくある問題

npx 実行時の「Command not found」エラー

Node.js 18 以上がインストールされ、npx が PATH で利用可能であることを確認してください:

node --version  # Should be 18.x or higher
npx --version   # Should output a version number

「Invalid API Key」エラー

API キーが正しく設定されていることを確認してください:

echo $ATLASCLOUD_API_KEY  # Should output your key

空の場合は、再度設定し、余分なスペースや引用符がないことを確認してください。

IDE に MCP サーバーが表示されない

  • 設定を追加した後に IDE を再起動したことを確認してください
  • 設定ファイルの JSON 構文を再確認してください
  • 設定ファイルが IDE の正しい場所にあることを確認してください

サポート

その他の Atlas Cloud ツール

別の統合方法をお探しですか?Atlas Cloud は以下も提供しています:

よくある質問

MCP サーバーは無料で使えますか?

MCP サーバー自体は無料でオープンソース(MIT ライセンス)です。使用するモデルに基づいた Atlas Cloud API の使用料のみがかかります。詳細はモデル料金をご確認ください。

どの AI モデルにアクセスできますか?

Atlas Cloud で利用可能な 400 以上のすべてのモデルにアクセスできます。動画モデル(Seedance、Kling、Sora、Veo、Wan)、画像モデル(Nano Banana、GPT Image、FLUX、Seedream)、3D モデル(Hunyuan 3D)、TTS モデル(Seed Audio、xAI/Grok TTS、ElevenLabs)、LLM(Claude、GPT、DeepSeek、Qwen、Kimi、GLM、MiniMax)が含まれます。完全なリストはモデルページをご覧ください。

Node.js 以外にインストールが必要なものはありますか?

いいえ。MCP サーバーは npm 経由で配布され、npx を使用して実行されます。パッケージは自動的にダウンロードされ実行されます。グローバルインストールは不要です。

MCP サーバーは他の IDE でも使えますか?

MCP サーバーは Model Context Protocol をサポートする任意の IDE やアプリケーションで動作します。Cursor、Claude Desktop、Claude Code、Codex、Gemini CLI、Goose、Windsurf、Kilo Code、OpenCode、Cline、Continue、VS Code(Copilot)、Trae、JetBrains IDEs、ChatGPT Desktop、Amazon Q Developer、Roo Code などが含まれます。

API キーは安全ですか?

API キーは IDE の設定ファイルにローカルに保存され、Atlas Cloud の API エンドポイントにのみ送信されます。MCP サーバーは API キーを収集、記録、またはサードパーティサービスに送信することはありません。