ASO AI Companion (MCP): подключение и настройка AI для ASO.dev

В разработке  Будет доступно скоро

AI Помощник - это инструмент для автоматизации работы с метаданными приложений в ASO.dev с помощью внешних AI-ассистентов (Claude, ChatGPT и др.).
MCP-сервер позволяет AI видеть и редактировать ваши метаданные в реальном времени через защищённый локальный API.

MCP (AI Companion) — это инструмент, который позволяет подключить любого AI-ассистента (например, ChatGPT, Claude, Gemini) к вашему проекту ASO.dev. MCP помогает автоматизировать работу с метаданными приложения: названия, описания, ключевые слова, скриншоты и многое другое. Всё происходит локально и безопасно — ваши данные не покидают ваш компьютер.

• Быстрое заполнение и редактирование метаданных для App Store и Google Play
• Автоматизация рутинных задач с помощью AI
• Массовое обновление локализаций и полей
• Удобная работа через интерфейс или с помощью AI-ассистента

1. Откройте настройки ASO.dev → AI Companion
2. Нажмите “Старт” для запуска сервера MCP
3. Скопируйте готовый конфиг для подключения AI (кнопка на странице редактора)
4. В настройках вашего AI-ассистента (ChatGPT, Claude и др.) добавьте новый сервер:
   • Адрес: http://localhost:42111
   • Секретный ключ: не обязателен для локального подключения
   • OpenAPI: http://localhost:42111/openapi.json (если поддерживается)
5. Сохраните настройки и перезапустите AI-ассистент

• На страницах редактора есть кнопка запуска AI Companion
• Можно скопировать конфиг для подключения
• Все действия выполняются через удобные формы и кнопки

• Попросите AI “Заполни описание для всех языков через MCP”
• “Покажи текущие метаданные приложения”
• “Обнови скриншоты для App Store и Google Play”

• Проверить статус:

  curl http://localhost:42111/status

• Получить метаданные:

  curl -X POST -H "Content-Type: application/json" \
    -d '{"action": "get_editor_data"}' \
    http://localhost:42111/apple/metadata/editor/get

• Массовое заполнение:

  curl -X POST -H "Content-Type: application/json" \
    -d '{"localizations": {"en-US": {"title": "New Title"}}}' \
    http://localhost:42111/google/metadata/editor/bulk-fill

• Порт по умолчанию: 42111 (можно изменить)
• Секретный ключ: не обязателен для локального подключения
• Все данные остаются только на вашем компьютере
• AI не может публиковать изменения напрямую — только предлагает, финальное сохранение вручную
• Для удалённого доступа используйте туннели (ngrok, Cloudflare Tunnel)

Как подключить AI к MCP?
На страницах редактора есть кнопка запуска AI Companion — появится окно с готовым конфигом.

Нужен ли секретный ключ?
Для локальных подключений — нет, для скриптов и API-запросов рекомендуется.

Как изменить порт?
В настройках Global Settings → AI Companion → Port.

Что делать, если не удаётся подключиться?
Проверьте, что сервис запущен, порт не занят, и (если нужно) секрет указан верно.

Сервис работает только локально, ваши данные не покидают ваш компьютер и доступны только выбранному вами AI-ассистенту.

Вариант 1. Через настройки:

1. Перейдите в Настройки → AI Помощник.
2. Нажмите Старт (если сервис не запущен).
3. Здесь же можно скопировать секретный ключ и изменить порт (по умолчанию 42111).

Вариант 2. Через кнопку на страницах Редактор, Массовый редактор, Кросс-локализация:

1. На этих страницах есть отдельная кнопка “Старт” — она запускает или останавливает MCP-сервер прямо из интерфейса.
2. При необходимости эта же кнопка позволяет скопировать готовый JSON-конфиг для подключения MCP (одним кликом).

1. Откройте приложение Claude Desktop.
2. Перейдите в меню настроек (обычно через значок шестерёнки или пункт меню “Settings”).
3. Найдите пункт “Конфигурация” или “Configuration file”. Если не знаете, где он - откройте папку:

• macOS: Откройте Finder, нажмите Cmd+Shift+G и вставьте путь: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: Откройте Проводник и вставьте путь: %APPDATA%\Claude\claude_desktop_config.json

4. Откройте файл в любом текстовом редакторе (например, Блокнот или TextEdit).
5. Скопируйте готовый JSON-конфиг из ASO.dev (кнопка на странице Редактор, Массовый редактор, Кросс-локализация) и вставьте его в секцию mcpServers.
6. Сохраните файл и перезапустите Claude Desktop.
7. Готово! Теперь Claude сможет подключаться к MCP.

1. Откройте настройки вашего Custom GPT (обычно через “Actions” или “API” в интерфейсе).
2. Найдите раздел для добавления внешнего API.
3. Вставьте:

• Адрес: http://localhost:42111
• API Key: (опционально) скопируйте из настроек ASO.dev, вставьте в поле “X-Client-Secret”.
• OpenAPI-спека: импортируйте с http://localhost:42111/openapi.json (или добавьте вручную эндпоинты /apple/metadata/editor/get и /apple/metadata/editor/bulk_fill).

4. Сохраните настройки.
5. Теперь ChatGPT сможет обращаться к MCP и работать с вашими метаданными.

1. Откройте настройки вашего AI-инструмента.
2. Найдите раздел для подключения внешнего API или HTTP-запросов.
3. Вставьте адрес MCP: http://localhost:42111
4. Если есть поле для ключа - скопируйте секрет из ASO.dev и вставьте (опционально для localhost).
5. Если поддерживается OpenAPI - импортируйте спецификацию с http://localhost:42111/openapi.json.
6. Сохраните и перезапустите инструмент, если требуется.

• Всегда можно скопировать готовый конфиг одной кнопкой на страницах Редактор, Массовый редактор, Кросс-локализация.
• Если не видите нужных настроек - обратитесь к документации вашего AI-инструмента или напишите в поддержку ASO.dev.
• Для облачных/браузерных AI-инструментов может понадобиться туннель (ngrok, Cloudflare Tunnel), чтобы дать доступ к вашему MCP.

1. Откройте VS Code и нажмите на иконку Расширения (слева).
2. Найдите и откройте нужное расширение (например, Cline или Roo Code).
3. В боковой панели расширения найдите раздел MCP Servers и нажмите Configure MCP Servers (кнопка может выглядеть как шестерёнка или называться “Configure”).
4. Нажмите Add или + для добавления нового сервера.
5. Заполните поля:

• Name: ASO Companion
• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http —url http://localhost:42111

6. Поле секрет можно оставить пустым (для localhost) или скопировать из настроек ASO.dev при необходимости.
7. Нажмите Сохранить или OK.
8. Убедитесь, что новый сервер появился в списке и включён (переключатель или галочка).
9. Готово! Теперь вы можете использовать MCP в VS Code.

1. Откройте Cursor и нажмите на иконку Настройки (обычно шестерёнка внизу слева или вверху справа).
2. Перейдите в раздел Features и найдите MCP.
3. Нажмите Add new MCP server (плюсик или “Add”).
4. Заполните:

• Name: ASO Companion
• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http —url http://localhost:42111

5. Поле секрет оставьте пустым (для localhost).
6. Нажмите Сохранить.
7. Убедитесь, что сервер появился в списке и включён.
8. Готово! Cursor теперь может использовать MCP.

1. Откройте Antigravity и перейдите в Настройки (шестерёнка или меню).
2. Найдите раздел Внешние MCP-серверы или похожий.
3. Нажмите Добавить или Новый сервер.
4. Введите:

• URL: http://localhost:42111
• Секрет: (опционально, скопируйте из ASO.dev при необходимости)

5. Нажмите Сохранить или OK.
6. Убедитесь, что сервер есть в списке и включён.
7. Перезапустите Antigravity, если требуется.
8. Готово! Antigravity теперь подключён к MCP.

1. Перейдите в Settings → Features → MCP.
2. Нажмите Add new MCP server.
3. Заполните:

• Name: ASO Companion
• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http —url http://localhost:42111

4. Секрет не требуется для локального подключения.
5. Сохраните - сервер будет доступен для AI в Cursor.

1. Откройте настройки Antigravity.
2. Найдите раздел для внешних MCP-серверов.
3. Добавьте новый сервер:

• URL: http://localhost:42111
• (опционально) Секрет: ASODEV_SECRET_KEY

4. Сохраните и перезапустите ассистента при необходимости.

• Убедитесь, что MCP запущен (через настройки ASO.dev или кнопку на Редактор, Массовый редактор, Кросс-локализация).
• Все параметры для подключения можно скопировать одной кнопкой на страницах Редактор, Массовый редактор, Кросс-локализация.
• Для большинства современных редакторов достаточно указать команду запуска и URL, секрет для localhost не обязателен.

Если нужна инструкция для другой среды - напишите нам!

В современных редакторах (например, Cursor, Windsurf):

• Type: command (stdio)
• Command: npx -y @modelcontextprotocol/server-http --url http://localhost:42111

3. Если подключение локальное, секрет не обязателен.

Если ваш AI-инструмент требует ручной настройки:

{
  "mcpServers": {
    "aso-dev": {
      "url": "http://localhost:42111",
      "env": {
        "ASODEV_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Секретный ключ опционален для localhost. Все параметры можно скопировать из окна запуска AI Companion.

• Cursor: Settings → Features → MCP
• VSCode (Cline/Roo Code): В боковой панели расширения → MCP Servers → Configure MCP Servers
• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

Если ваш AI-ассистент не поддерживает MCP напрямую, используйте HTTP-запросы:

Порт: 42111 (можно изменить в настройках) Секрет: ASODEV_SECRET_KEY (опционально для localhost)

Проверить статус:

curl http://localhost:42111/status
# или с секретом:
curl -H "X-Client-Secret: YOUR_SECRET" http://localhost:42111/status

Получить данные редактора:

curl -X POST -H "Content-Type: application/json" \
     -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get
# или с секретом:
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json" \
     -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get

Массовое заполнение:

curl -X POST -H "Content-Type: application/json" \
     -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill
# или с секретом:
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json" \
     -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill

OpenAPI-спека: http://localhost:42111/openapi.json

• Порт: 42111 (по умолчанию, можно изменить в настройках)
• ASODEV_SECRET_KEY: опциональный секрет, копируется в настройках AI Companion
• JSON-конфиг: копируется одной кнопкой на страницах Editor/BulkEditor/Cross-Locales

• MCP-сервер работает только с текущим проектом ASO.dev
• Секретный ключ уникален для вашей установки
• AI не может напрямую публиковать изменения - только предлагает, финальное сохранение всегда вручную
• Для удалённого доступа используйте туннели (ngrok, Cloudflare Tunnel)

Где взять конфиг для подключения?
На страницах Editor/BulkEditor/Cross-Locales нажмите кнопку запуска AI Companion - появится окно с готовым JSON-конфигом.

Обязателен ли секретный ключ?
Для локальных подключений - нет, но для скриптов и API-запросов рекомендуется.

Как изменить порт?
В настройках Global Settings → AI Companion → Port.

Что делать, если не удаётся подключиться?
Проверьте, что сервис запущен, порт не занят, и (если нужно) секрет указан верно.

Сервис работает только локально, ваши данные не покидают ваш компьютер и доступны только выбранному вами AI-ассистенту.

Теперь MCP поддерживает не только Apple App Store, но и Google Play:

• Получение метаданных Google Play: /google/metadata/editor/get-data (POST)
• Массовое заполнение Google Play: /google/metadata/editor/bulk-fill (POST)

Примеры:

# Получить данные Google Play
curl -X POST -H "Content-Type: application/json" \
  -d '{"action": "get_google_editor_data"}' http://localhost:42111/google/metadata/editor/get-data

# Массовое заполнение Google Play
curl -X POST -H "Content-Type: application/json" \
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/google/metadata/editor/bulk-fill

Все методы теперь принимают параметры:

• pageId — идентификатор страницы (опционально)
• locales — список локалей (например, ["en-US", "ru-RU"])
• fields — список полей для выборки или заполнения
• data — объект с данными для массового заполнения

В JSON-RPC добавлены методы:

• get_google_editor_data — получить метаданные Google Play
• bulk_fill_google — массовое заполнение Google Play

Пример вызова через JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_google_editor_data",
    "arguments": {
      "locales": ["en-US", "ru-RU"],
      "fields": ["title", "description"]
    }
  }
}

OpenAPI-описание теперь содержит все новые endpoints для Apple и Google. Его можно импортировать для автогенерации клиентов.

• “Получить метаданные Google Play через MCP”
• “Массово обновить описания для всех локалей в Google Play через MCP bulk_fill_google”
• “Сделай POST на /google/metadata/editor/get-data и верни результат”

Проверить статус MCP:

curl http://localhost:42111/status
# или с секретом:
curl -H "X-Client-Secret: YOUR_SECRET" http://localhost:42111/status

Получить данные редактора:

curl -X POST -H "Content-Type: application/json" \
  -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get
# или с секретом:
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json" \
  -d '{"action": "get_editor_data"}' http://localhost:42111/apple/metadata/editor/get

Массовое заполнение метаданных:

curl -X POST -H "Content-Type: application/json" \
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill
# или с секретом:
curl -X POST -H "X-Client-Secret: YOUR_SECRET" -H "Content-Type: application/json" \
  -d '{"localizations": {"en-US": {"title": "New Title"}}}' http://localhost:42111/apple/metadata/editor/bulk_fill

OpenAPI-спека: http://localhost:42111/openapi.json

Вы можете писать ИИ-ассистенту такие запросы (промпты), чтобы он вызывал MCP-команды:

• “Получить текущие метаданные приложения через MCP”
• “Заполни все локализации новым заголовком через MCP bulk_fill”
• “Сделай HTTP POST на /apple/metadata/editor/get и верни результат”
• “Проверь статус MCP сервера и выведи ответ”
• “Сделай curl-запрос к MCP для массового заполнения метаданных”

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