Для ИИ-агентов

QRTap внутри вашего ИИ-ассистента

Подключите QRTap к Claude Desktop, Claude Code или любому MCP-совместимому ассистенту — и печатные материалы клиента можно вести словами: «создай QR на меню и пришли картинку», «переведи код на новый адрес», «разбери новые отзывы». Двадцать инструментов, один блок конфигурации, никаких SDK.

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

Языковая модель сама по себе умеет только разговаривать. MCP (Model Context Protocol) — открытый стандарт, по которому ассистенту выдают инструменты: небольшой список действий с понятными названиями и параметрами. Ассистент видит этот список, сам решает, какой инструмент вызвать, и получает ответ обратно в диалог. Примерно как розетка: приложение не нужно переписывать под каждую модель — достаточно один раз воткнуть сервер.

MCP-сервер QRTap — маленькая программа, которая запускается на вашей машине рядом с ассистентом и общается с нашим REST API v1 по вашему ключу. Никакого отдельного доступа: те же права, те же лимиты, та же организация. Ассистент не видит ваш ключ как текст — он лежит в переменной окружения, а сервер подставляет его в заголовок сам.

Подключить за две минуты

Понадобится ключ API: владелец рабочего пространства выпускает его в кабинете на app.qrtap.kg/workspace/api — бесплатно и сразу, платить, чтобы попробовать, не нужно (бесплатный тариф: один ключ, 100 запросов в сутки). Ключ показывается один раз. И Node.js 20 или новее.

Поставить в один клик

Если вы пользуетесь одним из этих клиентов, ссылка откроет его и подставит настройки. Ключ в ссылке стоит подстановочный: замените qrt_live_XXXX на свой после установки.

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

Claude Desktop

Настройки → Developer → Edit Config, добавьте блок в claude_desktop_config.json и перезапустите приложение:

{
  "mcpServers": {
    "qrtap": {
      "command": "npx",
      "args": ["-y", "qrtap-mcp"],
      "env": {
        "QRTAP_API_KEY": "qrt_live_XXXX",
        "QRTAP_API_URL": "https://app.qrtap.kg"
      }
    }
  }
}

Claude Code

claude mcp add qrtap --env QRTAP_API_KEY=qrt_live_XXXX -- npx -y qrtap-mcp

Тот же блок mcpServers можно положить в .mcp.json в корне проекта — тогда конфигурация уедет в репозиторий вместе с кодом (ключ в неё, разумеется, не кладут: оставьте подстановку из окружения).

Другие MCP-клиенты и запуск из клона

Сервер говорит по MCP на stdin/stdout и пишет логи только в stderr, поэтому подходит любому stdio-клиенту. Если в вашем окружении npx ещё не находит пакет qrtap-mcp, запустите его из клона репозитория платформы:

{
  "mcpServers": {
    "qrtap": {
      "command": "node",
      "args": ["/path/to/mozart-qr-platform/packages/mcp-server/bin/qrtap-mcp.mjs"],
      "env": {
        "QRTAP_API_KEY": "qrt_live_XXXX",
        "QRTAP_API_URL": "https://app.qrtap.kg"
      }
    }
  }
}

Переменные окружения всего две: QRTAP_API_KEY — обязательная, QRTAP_API_URL — база API, по умолчанию https://app.qrtap.kg.

Двадцать инструментов

Каждый инструмент — это один вызов REST API v1 под вашим ключом. Ничего сверх того, что вы можете сделать сами: ассистент просто избавляет от написания запросов.

Остальная поверхность API — пакетное создание до 500 кодов, статистика по группам, шаблоны дизайна, вебхуки сканов, артефакты PDF — доступна обычными HTTP-запросами: см. документацию и спеку OpenAPI. Ассистент, умеющий делать HTTP-вызовы, справится и без MCP.

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

«Создай QR-код на наше меню example.com/menu и пришли картинку»

Вызовет qrtap_create_code и вернёт ссылку на PNG из png_url — файл сразу годится в печать.

«Меню переехало на новый адрес — переведи туда код со столов»

qrtap_change_destination: короткая ссылка в коде остаётся прежней, тираж перепечатывать не нужно.

«Сколько сканов у кода со стола №5 за июль? Разбей по дням»

qrtap_code_stats вернёт общее число сканов, разбивку по дням и по устройствам. Боты в счёт не идут.

«Собери визитку мастеру: имя, телефон, часы, услуги — и сделай на неё QR»

qrtap_create_page соберёт страницу и вернёт public_url, затем qrtap_create_code наведёт на неё код.

«Покажи новые отзывы и скажи, какие стоит опубликовать»

qrtap_list_reviews покажет очередь pending. Публикация — отдельным подтверждённым шагом.

«Какие заявки на запись пришли и на какие ещё не ответили?»

qrtap_list_bookings со статусом new — это и есть входящий ящик заявок.

«Сделай, чтобы с айфона код вёл в App Store, а с андроида — в Google Play»

qrtap_set_smart_rules: два правила по устройству, остальные попадают на основное назначение кода.

«Сделай короткую ссылку на эту акцию и посчитай переходы»

qrtap_create_short_link — тот же управляемый объект, что и код, с постоянным адресом и счётчиком.

Границы: где ассистент обязан спросить

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

Если ассистент работает без MCP

Модель, у которой есть только доступ в интернет, тоже разберётся: мы держим машиночитаемое описание сервиса по фиксированным адресам — /llms.txt (короткий индекс), /llms-full.txt (полное описание возможностей) и /openapi.json (спека OpenAPI 3.1, из которой генерируется клиент на любом языке).

Использование инструментов подчиняется тем же правилам, что и прямые вызовы API: Условия использования API, оферта и политика конфиденциальности. За содержимое ссылок, на которые ведут ваши коды, отвечаете вы — в том числе когда их создал агент.