MCP サーバー

Atlas Cloud の公式 MCP サーバーを使用して、IDE から直接 AI モデルを利用できます。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 アシスタントの機能を単純なコード補完をはるかに超えて拡張できます。ドキュメントの検索、画像の生成、動画の作成、LLM とのやり取りなど、すべてコーディング環境内の自然言語コマンドで実行できます。

Atlas Cloud MCP サーバー

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

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

主な機能

  • ドキュメント検索 — IDE から直接 Atlas Cloud のドキュメント、モデル、API リファレンスを検索
  • モデル発見 — 300 以上の AI モデルを価格と機能情報付きで一覧表示・探索
  • 画像生成 — Seedream、Qwen-Image、FLUX などのモデルで画像を生成
  • 動画生成 — Kling、Vidu、Seedance、Wan などのモデルで動画を生成
  • LLM チャット — GPT、DeepSeek、Qwen、GLM などの LLM と対話(OpenAI 互換)
  • 動的スキーマ — 各モデルのパラメータスキーマを自動取得し、正確な API 呼び出しを実現

前提条件

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

設定

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 を再起動して変更を適用します。

Claude Code

以下のコマンドを実行して Atlas Cloud MCP サーバーを追加します:

claude mcp add atlascloud -- npx -y atlascloud-mcp

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

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

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

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"
      }
    }
  }
}

利用可能なツール

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

ツール説明
atlas_search_docsキーワードで Atlas Cloud のドキュメントとモデルを検索
atlas_list_modelsすべての利用可能なモデルを一覧表示(タイプ別フィルター:Text/Image/Video)
atlas_get_model_infoAPI スキーマ、パラメータ、使用例を含むモデル詳細を取得
atlas_generate_image任意の対応画像モデルで画像を生成
atlas_generate_video任意の対応動画モデルで動画を生成
atlas_chatLLM モデルとチャット(OpenAI 互換形式)
atlas_get_prediction画像/動画生成タスクのステータスと結果を確認

使用例

設定が完了したら、自然言語で 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 で適切なパラメータを使用して動画を生成

LLM チャット

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

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

トラブルシューティング

よくある問題

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 の正しい場所にあることを確認してください

サポート

よくある質問

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

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

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

Atlas Cloud で利用可能な 300 以上のすべてのモデルにアクセスできます。OpenAI、Anthropic、DeepSeek、Google、Meta、Mistral、ByteDance(Seedream、Kling)、Alibaba(Qwen)などのモデルが含まれます。完全なリストはモデルページをご覧ください。

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

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

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

MCP サーバーは Model Context Protocol をサポートする任意の IDE やアプリケーションで動作します。現在サポートされている IDE:Cursor、Claude Desktop、Claude Code、Windsurf、Codex、Gemini CLI、Kilo Code、OpenCode。

API キーは安全ですか?

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