MCP-сервер

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт, разработанный Anthropic, который позволяет ИИ-ассистентам взаимодействовать с внешними инструментами и источниками данных стандартизированным способом. MCP можно представить как универсальный адаптер — он позволяет IDE с поддержкой ИИ, таким как Cursor, Claude Desktop и Claude Code, легко подключаться к сторонним сервисам, API и данным.

Используя MCP, разработчики могут расширить возможности своего ИИ-ассистента далеко за пределы простого автодополнения кода: они могут искать документацию, генерировать изображения, видео, аудио и 3D-модели, взаимодействовать с большими языковыми моделями и многое другое — всё с помощью команд на естественном языке прямо в среде разработки.

MCP-сервер Atlas Cloud

Atlas Cloud предоставляет официальный MCP-сервер (atlascloud-mcp на npm), который открывает полный доступ к платформе ИИ API Atlas Cloud прямо в вашей IDE. Имея более 400 доступных моделей ИИ — охватывающих изображения, видео, 3D, аудио (TTS) и большие языковые модели — вы можете использовать всё это без переключения между вкладками браузера и без ручного написания 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

Полный каталог смотрите на нашей странице Models.

Основные возможности

• Поиск по документации — Ищите по документации, моделям и справочникам API Atlas Cloud прямо из вашей IDE
• Обзор моделей — Просматривайте и исследуйте более 400 доступных моделей ИИ с ценами и характеристиками, с фильтрацией по типу (Text/Image/Video/Audio)
• Генерация изображений — Генерируйте изображения с помощью таких моделей, как Nano Banana, GPT Image 2, Flux 2, Seedream и др.
• Генерация видео — Создавайте видео с помощью таких моделей, как Seedance, Kling, Sora, Veo, Wan и др.
• Генерация 3D — Превращайте текст или фотографии в 3D-модели (GLB/OBJ/USDZ) с помощью Hunyuan 3D
• Генерация аудио (TTS) — Синтезируйте речь с помощью Seed Audio, xAI/Grok TTS, ElevenLabs и др.
• Быстрая генерация — Одношаговая генерация изображений/видео/аудио: автоматический подбор подходящей модели по ключевым словам и построение параметров
• Загрузка медиафайлов — Загружайте локальные файлы и получайте URL для сценариев редактирования изображений или генерации видео из изображений
• Чат с LLM — Общайтесь с LLM-моделями (формат, совместимый с OpenAI), включая Claude, GPT, DeepSeek, Qwen, Kimi, GLM и др.
• Баланс и использование — Проверяйте баланс аккаунта, ежедневное использование и детализацию затрат через Atlas Cloud Public API
• Динамическая схема — Автоматическое получение схемы параметров каждой модели и валидация параметров до отправки запроса: некорректные запросы сразу отклоняются без расходования кредитов

Предварительные требования

Перед настройкой MCP-сервера Atlas Cloud убедитесь, что у вас есть:

• Node.js 18 или выше — Скачать Node.js
• API-ключ Atlas Cloud — Зарегистрируйтесь и получите ключ на atlascloud.ai

Настройка

CLI-агенты (установка одной командой)

Самый быстрый способ — эти ИИ-агенты для программирования добавляют сервер одной командой:

# 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-ключ между сеансами терминала, добавьте команду export в профиль вашей оболочки (~/.bashrc, ~/.zshrc и т.д.).

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

Добавьте следующее в конфигурацию MCP вашего Windsurf:

{
  "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-совместимым клиентом:

Доступные инструменты

MCP-сервер Atlas Cloud предоставляет 13 инструментов, которые может использовать ваш ИИ-ассистент:

Примечание: Инструменты для баланса, использования и затрат работают через Public API Atlas Cloud (https://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. Использует atlas_generate_image с URL загруженного файла

Примечание: Загруженные файлы предназначены только для временного использования в задачах генерации Atlas Cloud. Файлы могут периодически удаляться. Не используйте эту возможность как постоянный файловый хостинг — злоупотребление может привести к блокировке API-ключа.

Генерация речи (TTS)

«Прочитай вслух это предложение с помощью Seed Audio: Welcome to Atlas Cloud»

Ассистент выполнит следующие шаги:

1. Использует atlas_list_models с type="Audio" для поиска TTS-модели
2. Использует atlas_generate_audio с текстом для синтеза
3. Использует atlas_get_prediction для получения URL сгенерированного аудио

Генерация 3D-модели

«Преврати эту фотографию товара в 3D-модель с помощью Hunyuan 3D»

3D-модели относятся к типу Image, поэтому ассистент использует atlas_generate_image с параметром image и получает файл GLB/OBJ/USDZ через atlas_get_prediction.

Чат с LLM

«Попроси DeepSeek V3 объяснить квантовые вычисления»

Ассистент использует atlas_chat с моделью DeepSeek.

Проверка баланса и использования

«Сколько кредитов Atlas Cloud у меня осталось и сколько я потратил в этом месяце?»

Ассистент использует atlas_get_balance для получения текущего баланса и atlas_get_model_costs для детализации расходов.

Устранение неполадок

Частые проблемы

Ошибка «Command not found» при запуске npx

Убедитесь, что 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

Если пусто, установите его снова и убедитесь, что нет лишних пробелов или кавычек.

MCP-сервер не отображается в IDE

• Убедитесь, что вы перезапустили IDE после добавления конфигурации
• Перепроверьте синтаксис JSON в файле конфигурации
• Убедитесь, что файл конфигурации находится в правильном расположении для вашей IDE

Получение помощи

• GitHub Issues: AtlasCloudAI/mcp-server/issues
• Поддержка Atlas Cloud: Свяжитесь с нами

Другие инструменты Atlas Cloud

Предпочитаете другой способ интеграции? Atlas Cloud также предлагает:

• CLI — используйте Atlas Cloud из терминала: atlascloud-cli
• Skills — пакет Skills для Claude Code и других агентов с поддержкой skills: atlas-cloud-skills
• Ноды ComfyUI — atlascloud_comfyui
• Ноды n8n — n8n-nodes-atlascloud

Часто задаваемые вопросы

MCP-сервер бесплатный?

Сам MCP-сервер бесплатный и с открытым исходным кодом (лицензия MIT). Вы оплачиваете только использование API Atlas Cloud в зависимости от используемых моделей. Подробности о ценах смотрите на странице моделей.

К каким моделям ИИ я могу получить доступ?

Вы можете использовать все 400+ моделей, доступных на Atlas Cloud, включая видеомодели (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-сервер работает с любой IDE или приложением, поддерживающим Model Context Protocol, включая 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 и отправляется только на API-эндпоинты Atlas Cloud. MCP-сервер не собирает, не логирует и не передаёт ваш API-ключ каким-либо сторонним сервисам.