Подключение ИИ-инструмента

Подключение ИИ-инструмента

Когда MCP включён для этого развёртывания AppScreenshots, подключите совместимый ИИ-инструмент к:

https://appscreenshots.net/api/mcp

Выберите HTTP/Streamable HTTP и OAuth. Войдите в аккаунт AppScreenshots в браузере, выберите проекты и ассеты, доступные инструменту, и решите, может ли он создавать проекты. Доступ к базе данных и API-ключ не нужны.

Подключение клиента

Команды ниже регистрируют эндпоинт в каждом клиенте. После подключения завершите вход через браузер, когда клиент его покажет.

claude mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

codex mcp add appscreenshots --url https://appscreenshots.net/api/mcp
codex mcp login appscreenshots

gemini mcp add --transport http --scope user appscreenshots https://appscreenshots.net/api/mcp

{
  "mcpServers": {
    "appscreenshots": {
      "url": "https://appscreenshots.net/api/mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "appscreenshots": {
        "type": "http",
        "url": "https://appscreenshots.net/api/mcp",
        "oauth": {
          "type": "authorization_code",
          "scope": "projects:read projects:write assets:read offline_access"
        }
      }
    }
  }
}

Набор для подключения

Публичный репозиторий appscreenshots-mcp содержит готовые файлы конфигурации для всех клиентов выше, опциональный Skill агента с описанием workflow скриншотов и команду doctor, проверяющую сервер из терминала:

git clone https://github.com/horace68/appscreenshots-mcp.git
node bin/appscreenshots.mjs config claude    # вывести фрагмент конфигурации клиента
node bin/appscreenshots.mjs install-skill claude
node bin/appscreenshots.mjs doctor

Помощник только печатает конфигурацию и устанавливает Skill. Это не локальный stdio-сервер — используйте штатное удалённое подключение клиента.

Инструменты

Девять инструментов ниже доступны через Streamable HTTP. Клиенты могут добавлять к именам префиксы. Источник истины для схем входных данных и прав аккаунта — хостируемый сервер.

Операции редактирования

update_project принимает различаемый список операций:

• set_name — переименовать проект
• add_frame / remove_frame / reorder_frames — управлять кадрами
• upsert_element — вставить или заменить элемент; требует полной геометрии и сохраняет опущенные поля того же типа
• patch_element — частичная правка по id элемента; менять тип нельзя
• remove_element — удалить элемент
• set_background — задать фон одного кадра; общие фоны фиксируются по кадрам
• set_locales — задать 1–20 языков и язык по умолчанию
• set_canvas — размер холста (100–5000) и режим (separate или continuous)

Элементы несут типографику, поля мокапов устройств, ссылки assetId на изображения, фигуры, иконки, rotation и stackOrder. Изображения указываются только авторизованным assetId — никогда URL или локальным путём; существующие ссылки хранятся на сервере, не отправляйте их обратно.

Каждая логическая запись должна использовать свежий ключ идемпотентности; повторно применяйте его только при идентичном повторе. После конфликта ревизий прочитайте свежую версию и продолжайте. Никогда не передавайте SQL, HTML или скрипты как инструкции правок.

Ошибки

Ошибки приходят телом JSON {code, message} с isError: true:

Авторизация и лимиты

Сервер использует OAuth 2.1 с PKCE и входом через браузер:

• Скоупы: projects:read, projects:write (только если вы разрешаете создание или правки), assets:read и offline_access.
• Токены доступа действуют один час, а токены обновления — 30 дней.
• Токенам доступа нужна действующая авторизация: после отзыва подключения существующие токены перестают работать немедленно.
• Лимиты: 60 вызовов MCP в минуту на бесплатном тарифе, 120 в минуту на платных. Превышение даёт HTTP 429 с Retry-After: 60.
• Тело запроса ограничено 2 МБ; проект — 20 кадрами и 100 элементами на кадр.

Права тарифа действуют как обычно: ограничения проектов, платных шаблонов, кастомных шрифтов и пакетного экспорта не меняются, платы за хостируемый ИИ нет — дизайн и тексты даёт подключённый ИИ.

Начните со своих скриншотов

Загрузите оригинальные скриншоты в веб-редактор. Затем авторизуйте этот проект или выберите отдельные ассеты на странице согласия. MCP не предоставляет инструменты бинарной загрузки; файл, приложенный к чату, автоматически сервису недоступен.

Попробуйте такой промпт:

Дизайн и тексты создаёт подключённый ИИ; MCP сохраняет редактируемые проекты. get_project_preview возвращает ссылку на редактор и инструкции проверки, а не байты изображения. Агент с браузерными инструментами может открыть редактор, осмотреть скриншоты, поправить дизайн через MCP и безопасно перезагрузить страницу, чтобы увидеть свежую версию. Вход в браузере отделён от OAuth MCP, а несохранённые правки нужно сохранить перед перезагрузкой. Предпросмотр и экспорт выполняются в веб-редакторе.

Управление доступом

Откройте Settings → Connected AI tools, чтобы изменить выбранные проекты/ассеты или отозвать подключение. Инструмент не видит невыбранные проекты. Если сайт и ИИ-инструмент правят один проект одновременно, перед сохранением конфликтующих изменений перечитайте свежую версию.

Проверка в браузере не требует Browserless или фоновой очереди рендеринга. Этот MCP даёт инструменты проектов и руководство по браузерной проверке, а не облачный рендеринг. Без браузерных/графических инструментов агент должен вернуть ссылку на редактор и сообщить, что визуальная проверка не выполнена, а не утверждать обратное.

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

Заметки по клиентам и актуальная матрица верификации — в руководстве по устранению неполадок набора.