Как подключить генератор спрайтов к Claude Code и Cursor через MCP

Автор: Егор.

Как сделать так, чтобы ИИ-помощник в редакторе сам рисовал спрайты для вашей игры: ключ, подключение, пример разговора и меры предосторожности.

Что такое MCP простыми словами

MCP это протокол, по которому ИИ-помощник в редакторе получает от внешнего сервиса набор инструментов. Claude Code и Cursor умеют им пользоваться. Вы подключаете сервис один раз, а дальше помощник сам вызывает его инструменты, когда они нужны для задачи.

Для игры это означает такой сценарий. Вы пишете в чат: «нужен враг, скелет-воин, с ходьбой в четыре стороны». Помощник создаёт персонажа, заказывает анимацию, скачивает файлы и кладёт их в проект. Вам не нужно открывать сайт, ждать и перетаскивать файлы вручную.

Анимация ходьбы Эльфа-лучника вправо, результат запроса через MCP
Такая анимация получается у помощника после запроса про ходьбу в четыре стороны.

Шаг 1. Создайте ключ

  1. Войдите или зарегистрируйтесь.
  2. Откройте «Кабинет» и найдите блок «Ключи API».
  3. Впишите название, например «Claude Code», и нажмите «Создать ключ».
  4. Скопируйте ключ. Он начинается с pk_ и показывается один раз. Если потеряли, отзовите его и создайте новый.

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

Храните ключ как пароль и не кладите его в репозиторий. Если он попал не туда, отзовите его в кабинете, и он перестанет работать сразу.

Шаг 2. Подключите Claude Code

Одна команда в терминале. Замените ВАШ_КЛЮЧ на свой ключ.

claude mcp add --transport http pikselnya https://pikselnya.ru/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ"

Проверить, что сервер добавился, можно командой claude mcp list. Адрес https://pikselnya.ru/mcp работает по Streamable HTTP, ключ уходит заголовком Authorization.

Шаг 3. Или подключите Cursor

Добавьте сервер в файл ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json в папке проекта.

{
  "mcpServers": {
    "pikselnya": {
      "url": "https://pikselnya.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_КЛЮЧ"
      }
    }
  }
}

Подойдёт и любой другой клиент MCP, который умеет Streamable HTTP и свои заголовки. Сервер ничего не помнит между запросами, сессии не нужны.

Какие инструменты получит помощник

Задания асинхронные. Инструмент создания сразу возвращает номер задания, а помощник опрашивает status_zadaniya, пока там не появится готовность. Обычно это от 30 секунд до трёх минут.

Пример разговора

В Claude Code после подключения можно написать: «Нарисуй эльфийку-лучницу и сделай ей ходьбу в четыре стороны. Сначала скажи, сколько кристаллов спишется». Дальше помощник сам пройдёт цепочку:

  1. вызовет sozdat_personazha с описанием и размером 64 и получит номер задания;
  2. опросит status_zadaniya, пока лист не будет готов;
  3. вызовет animirovat для этого персонажа с действием «ходьба» и четырьмя сторонами;
  4. снова дождётся готовности и вызовет skachat, чтобы получить ссылки на файлы;
  5. скачает файлы по ссылкам и положит их в проект.

Лист стоит 9 кристаллов, анимация на четыре стороны 15, итого 24. Подробнее о том, как подключить результат к Godot, в статье про анимацию ходьбы.

Лист ходьбы Эльфа-лучника: четыре направления по четыре кадра
Лист кадров, который помощник получает в конце цепочки: четыре направления по четыре кадра.

Что просить кроме персонажей

Помощник умеет заказывать и остальное. Например: «сделай набор из восьми зелий для инвентаря, размер 32». Он вызовет nabor_predmetov и получит каждый предмет отдельным файлом. Для карты можно написать: «нужна трава с переходом в песок, плитки 32». Тогда сработает инструмент plitki с двумя поверхностями. Это удобно, когда вы пишете код уровня: помощник сразу подставляет в него пути к готовым файлам. Набор предметов и обычные плитки стоят по 9 кристаллов, плитки с переходом 17.

Без MCP: обычный REST

Те же возможности есть у обычного API. Ключ передаётся заголовком Authorization, поля отправляются как форма.

curl https://pikselnya.ru/api/zadaniya \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -F "opisanie=эльфийка-лучница в зелёном плаще" \
  -F "razmer=64"

В ответ придёт номер задания. Готовность проверяется запросом GET /api/zadaniya/НОМЕР раз в 5 или 10 секунд, пока в поле status не появится gotovo или oshibka. Примеры для анимации, картинок, наборов предметов и плиток собраны на странице «API и MCP».

О безопасности и расходах

Сравнение с другими генераторами, у которых тоже есть MCP, смотрите в статье про PixelLab.

Попробовать

Ключ для MCP создаётся в кабинете после входа. Сначала можно посмотреть, что получается, в обычной мастерской.

Открыть мастерскую

Читайте дальше