Mage

npx add-mcp 'https://mcp.mage.space/mcp'

Использование Mage из Claude, ChatGPT, Grok и Cursor

Подключите Claude, ChatGPT, Claude Code, Grok или Cursor к своей учётной записи Mage через сервер Mage MCP, а затем попросите помощника генерировать изображения, видео и аудио с оплатой в Gems.

Сервер Mage MCP подключает ИИ-помощников к вашей учётной записи Mage. После подключения вы можете попросить Claude, ChatGPT, Claude Code, Grok или Cursor выбрать модель, узнать цену, сгенерировать изображение, видео или аудиоклип и вернуть результат. Он также читает вашу историю генераций и сохранённые творения и использует ваших сохранённых персонажей и референсы.

https://mcp.mage.space/mcp

[!WARNING]

Каждая генерация, которую запускает ваш помощник, оплачивается в Gems с вашей учётной записи. Ваш помощник может сначала проверить цену, а вы можете отключить его в любой момент.

Подключение помощника

Claude

Работает в Claude в веб-версии, настольном приложении, мобильных приложениях и Cowork.

1. Откройте Connect Mage to Claude. Имя коннектора и URL уже заполнены. Выберите Add.
2. Выберите Connect. Откроется страница Mage, которая попросит вас войти, если вы ещё не вошли.
3. Убедитесь, что на странице указано приложение, которое вы подключаете, затем выберите Connect. Вы вернётесь в Claude.
4. В чате включите коннектор Mage из меню + в разделе Connectors и попросите то, что хотите создать.

В плане Team или Enterprise владелец сначала добавляет коннектор в разделе Organization settings → Connectors. План Free допускает один пользовательский коннектор.

ChatGPT

Добавьте Mage как личный плагин со страницы Plugins в ChatGPT.

1. Откройте ChatGPT Plugins.
2. Нажмите Add, затем выберите Create MCP App.
3. Введите Mage в поле Name, https://mcp.mage.space/mcp в поле Server URL и выберите OAuth для Authentication. Оставьте Advanced OAuth settings пустыми; client ID и client secret не нужны. Иконка и описание необязательны.
4. Ознакомьтесь с уведомлением, отметьте I understand and want to continue, затем нажмите Create.
5. Войдите в Mage на открывшейся странице, проверьте имя приложения и выберите Connect.
6. Установите Mage из своих плагинов Personal, начните чат Work и упомяните @Mage.

[!NOTE]

Если пункт Create MCP App отсутствует, включите Developer mode в ChatGPT в разделе Settings → Security and login, затем вернитесь в Plugins. Подробнее см. руководство по настройке ChatGPT.

Claude Code

Добавьте сервер, затем войдите из Claude Code:

claude mcp add --transport http mage https://mcp.mage.space/mcp

Выполните /mcp в Claude Code, выберите mage и пройдите аутентификацию. Откроется страница в браузере, где нужно войти в Mage и выбрать Connect.

Чтобы использовать API-ключ вместо входа:

claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Grok

Добавьте Mage как пользовательский коннектор MCP.

1. Откройте Grok connectors, выберите New Connector, затем выберите Custom.
2. Введите https://mcp.mage.space/mcp и пройдите запросы аутентификации, чтобы подключить свою учётную запись Mage.
3. Начните разговор и попросите Grok использовать Mage для создания изображения, видео или аудио.

В Grok Business или Enterprise администратор команды должен сначала подготовить коннектор в облачной консоли.

Cursor

Кнопка устанавливает Mage с его публичным OAuth client ID; войдите в Mage, когда появится запрос. Если Mage уже установлен, замените его существующую конфигурацию той, что из этой ссылки. Если кнопка ничего не делает, откройте вместо неё ссылку веб-установки: она открывает Cursor из браузера и показывает ту же конфигурацию для добавления вручную.

Для ручной настройки добавьте эту запись в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

Client ID является публичным и не требует client secret. Cursor использует статическую конфигурацию OAuth, чтобы открыть страницу согласия Mage.

Вы также можете подключиться с помощью API-ключа:

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

Когда приложение подключается через вход, Mage показывает, кто запрашивает доступ, прежде чем что-либо будет передано: имя приложения, сайт, с которого оно приходит, и куда вы вернётесь afterwards. Гостевая сессия не может подключить приложение; сначала войдите в свою учётную запись Mage.

Что умеет ваш помощник

Инструмент	Что он делает
list_models	Перечисляет рекомендуемые модели с их ценами, для чего каждая лучше всего подходит, и её компромиссы; остальные — по запросу.
get_model	Описывает одну модель: её поля, допустимые значения, значения по умолчанию, правила и цену.
estimate_cost	Рассчитывает цену генерации до её запуска. Ничего не списывается.
create_upload	Получает подписанную ссылку для загрузки файла с вашего компьютера — для помощников, которые могут выполнять команды.
generate	Запускает генерацию с оплатой в Gems.
get_request	Ожидает завершения генерации и возвращает ссылку на результат.
cancel_request	Останавливает выполняющуюся генерацию. Gems не возвращаются.
get_account	Показывает подключённую учётную запись и её баланс Gems.
list_characters	Перечисляет ваших персонажей и их @handle.
create_character	Сохраняет приватного персонажа по ссылке на изображение, при желании с аудиоклипом голоса.
delete_character	Удаляет одного из ваших персонажей.
list_references	Перечисляет ваши наряды, позы, локации, объекты и аудиоклипы голоса — все или один тип.
create_reference	Сохраняет приватный референс по ссылке на изображение или аудио.
delete_reference	Удаляет один из ваших референсов.
list_history	Перечисляет ваши генерации за последние 30 дней, включая те, что вы сделали в Mage сами.
search_creations	Ищет сохранённые вами творения по тому, что на них изображено, по коллекции или по дате.

Упоминайте сохранённого персонажа или референс в запросе по его хэндлу, например «Сделай портрет @ana в @red-coat», и ваш помощник передаст его модели.

Навыки

Навыки Mage обучают вашего помощника выполнять целые задачи поверх этих инструментов: продуктовые фотосессии, карточки товаров для маркетплейсов, варианты рекламы, UGC- и faceless-видео, миниатюры для YouTube и приложения Mage — от замены лиц и переосвещения до видеомонтажа и lip sync. Добавьте их с помощью npx skills add mage-space/skills или просмотрите их с примерами на mage.space/skills.

Какую модель использует ваш помощник

Если вы не назвали модель, ваш помощник создаёт изображения с помощью Mango 3, видео — с помощью Cherry 2 Pro, а аудио — с помощью Seed Audio. Он сообщает вам модель и цену до запуска, а после результата может предложить одну альтернативу, если её компромисс подходит для вашей задачи.

	Изображения	Видео
По умолчанию	Mango 3	Cherry 2 Pro
Та же линейка	Mango 3S (дешевле, до 3K), Mango 2 (до 4K), Mango	Cherry Pro (4K), Cherry, Cherry Mini (самый дешёвый Cherry)
Также рекомендуются	Guava 2 Pro и Guava 2 (фотореализм), GPT Image 2.5 Flare (текст и точные правки)	Lemon (первый и последний кадры, клипы до 30 секунд)

Все остальные модели запускаются только когда вы просите их по имени, например «сделай с Melon» или «используй Nano Banana 2». Ваш помощник может предложить одну из них, если она лучше подходит для запроса, например аниме-модель для аниме-клипа, и ждёт вашего ответа. Какую модель мне использовать? сравнивает их все.

Cherry 2 Pro — самая мощная и самая дорогая видеомодель Mage, и её цена резко растёт с разрешением и длительностью. Пока вы работаете над черновиком, просите Cherry Mini или Lemon.

Как работают генерации

1. Ваш помощник выбирает модель с помощью list_models, как описано выше, и читает её поля с помощью get_model.
2. Он проверяет цену с помощью estimate_cost, что также выявляет запрос, который модель отклонила бы. Цена видео зависит от его длительности: Mage измеряет видео, уже находящееся в Mage, например загруженный файл или более ранний результат, когда рассчитывает цену, а видео, связанное с другого сайта, — только когда генерация начинается.
3. Он запускает генерацию с помощью generate, что списывает ваши Gems. Каждая генерация несёт ключ, который придумывает ваш помощник, поэтому повторная попытка после обрыва соединения возвращает ту же генерацию вместо двойной оплаты.
4. Он ожидает с помощью get_request, пока результат не будет готов, и даёт вам ссылку.

Результаты доступны в течение 30 дней: скачайте то, что хотите сохранить, или сохраните это в Mage. Результат, помеченный модерацией как NSFW, отмечается соответствующим образом. См. Requests о состояниях, через которые проходит генерация, и Billing о том, как списываются Gems.

Изображения и файлы

Медиавходы, такие как первый кадр, референсное изображение или видео для редактирования, — это ссылки: публичная ссылка https на сам файл или data URL размером примерно до 3 МБ.

• Claude Code, Cursor и другие помощники, выполняющие команды, могут загрузить файл с вашего компьютера: они получают подписанную ссылку для загрузки с помощью create_upload, отправляют файл по ней и используют новую ссылку файла как любую другую. Файл может быть до 100 МБ и удаляется через 30 дней. Каждая загрузка содержит один файл: исправленный файл загружается как новая загрузка, поскольку старая ссылка может до 4 часов показывать первый файл.
• Чаты Claude, ChatGPT и Grok не могут передать файл, прикреплённый вами к чату, в Mage. Вместо этого поделитесь прямой ссылкой на файл или используйте творение, уже находящееся в Mage.
• Ссылка на веб-страницу, например на видео YouTube или TikTok, не является файлом и отклоняется.

Управление подключёнными приложениями

Каждое подключённое вами приложение перечислено в MCP → Connected apps вместе с датой подключения и датой последнего использования. Выберите Disconnect, чтобы немедленно остановить приложение; оно больше не сможет использовать вашу учётную запись или тратить ваши Gems, пока вы снова его не подключите. Откройте MCP в плавающей навигации, затем выберите Connected apps.

Ограничения

• Для вашей учётной записи одновременно может выполняться до 20 генераций, как и в API.
• Приложение может делать до 120 вызовов инструментов в минуту.
• get_request ожидает до 2 минут на вызов; для более длительных генераций ваш помощник вызывает его снова.

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

• Cursor сообщает «Incompatible auth server: does not support dynamic client registration»: обновите существующую запись Mage в ~/.cursor/mcp.json, добавив блок auth из настройки Cursor выше, затем подключитесь заново. Один только URL сервера не содержит предварительно зарегистрированный client ID Cursor для Mage.

• «Couldn't reach the MCP server»: проверьте, что URL в точности равен https://mcp.mage.space/mcp, затем удалите коннектор и добавьте его снова.

• Соединение просит вас войти снова: соединение действует до 180 дней, после чего приложение просит вас снова его одобрить. Отключение в Mage также завершает его.

• Генерация завершилась ошибкой insufficient_gems: добавьте Gems в API → Billing и повторите попытку.

Эта документация создана и размещена на Mintlify, платформе для документации разработчиков.