MCP-сервер Quality QR

Создавайте и управляйте отслеживаемыми QR-кодами с помощью ИИ-ассистентов, таких как Claude, Cursor и любых других инструментов, совместимых с MCP.

В отличие от обычных генераторов QR-кодов, QR-коды Quality QR сохраняются в вашей учетной записи с возможностью отслеживания сканирований, аналитикой и функцией изменения целевой ссылки без необходимости повторной печати.

Эндпоинт: https://quality-qr.app/api/mcp

Настройка

1. Получите API-ключ

Зарегистрируйтесь на quality-qr.app и создайте API-ключ в разделе Dashboard > Settings > API Keys.

2. Настройте ваш MCP-клиент

Пользователи Smithery: Если вы устанавливаете через Smithery, вам будет предложено ввести apiKey напрямую — Smithery автоматически добавит заголовок Authorization. Приведенные ниже конфигурации предназначены для ручной настройки.

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на Mac):

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Добавьте в настройки MCP в Cursor:

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3. Начните использование

Спросите своего ИИ-ассистента:

"Create a QR code for https://example.com"
"Make a WiFi QR code for network MyWiFi with password guest123"
"Show me the analytics for my QR codes"
"List all my QR codes"
"Disable QR code abc123"

Доступные инструменты

Инструмент	Описание
`quality_qr_create`	Создание отслеживаемого QR-кода. 12 типов: URL, PDF, Меню, App Store, Соцсети, WiFi, vCard, Email, Телефон, SMS, Текст, Событие. Возвращает встроенный SVG.
`quality_qr_list`	Список ваших QR-кодов с возможностью фильтрации по типу и пагинацией.
`quality_qr_get`	Получение полной информации о QR-коде по ID.
`quality_qr_update`	Обновление целевого URL (для динамических типов), переименование или включение/отключение.
`quality_qr_delete`	Безвозвратное удаление QR-кода. Освобождает квоту тарифного плана.
`quality_qr_analytics`	Аналитика сканирований: общие показатели, ежедневные тренды, распределение по устройствам, топ стран.

Типы QR-кодов

Динамические (URL можно изменить после печати): URL, PDF, Меню, App Store, Соцсети

Статические (данные кодируются напрямую): WiFi, vCard, Email, Телефон, SMS, Текст, Событие

Лимиты использования

Вызовы инструментов MCP учитываются в рамках лимитов вашего API. Протокольные сообщения (initialize, tools/list) бесплатны.

Тариф	Вызовов инструментов / мес	История аналитики	Цена
Free	100	7 дней	Бесплатно
Pro	1,000	30 дней	€10/мес
Business	10,000	1 год	€30/мес

Заголовки ответов с лимитами

Каждый ответ содержит заголовки, помогающие отслеживать использование:

Заголовок	Описание
`X-RateLimit-Limit`	Максимально допустимое количество вызовов инструментов в месяц согласно вашему тарифу
`X-RateLimit-Remaining`	Количество оставшихся вызовов в текущем расчетном периоде
`X-RateLimit-Reset`	Временная метка UTC, когда лимит будет сброшен (ISO 8601)
`Retry-After`	Время в секундах, которое нужно подождать перед повторной попыткой (присутствует только в ответах `429`)

При получении ответа 429 Too Many Requests подождите количество секунд, указанное в Retry-After, прежде чем повторять запрос.

Безопасность

Все запросы аутентифицируются через API-ключ (Bearer token)
Ключи можно мгновенно отозвать через панель управления
QR-коды привязаны к вашей учетной записи (нет доступа между пользователями)
Операции администрирования, биллинга или управления командой не экспонируются
Соответствие GDPR и CCPA, хостинг в глобальной сети Cloudflare

Управление API-ключами

Ваш API-ключ предоставляет полный доступ к вашим QR-кодам и аналитике. Относитесь к нему как к паролю.

Регулярно обновляйте ключи. Создайте новый ключ в Dashboard > Settings > API Keys, обновите конфигурацию MCP-клиента, затем отзовите старый ключ. Вы можете иметь несколько активных ключей для ротации без простоев.
Немедленно отзывайте скомпрометированные ключи. Отзыв вступает в силу мгновенно — любые запросы, использующие старый ключ, будут отклонены.
Ограничьте доступ к файлам конфигурации. Конфигурации MCP-клиентов хранят ваш ключ в открытом виде. В macOS/Linux убедитесь, что только ваш пользователь может их читать (например, chmod 600). Избегайте добавления файлов конфигурации с реальными ключами в системы контроля версий.

Ссылки

Quality QR
Онбординг агентов (SKILL.md) — пошаговые инструкции для ИИ-агентов по автономному использованию Quality QR (исходный код)
Документация MCP
Документация API
Тарифы

Протокол

Это удаленный MCP-сервер, использующий потоковую передачу HTTP (JSON-RPC 2.0 через HTTP POST). Локальная установка не требуется. Совместим с протоколом MCP версии 2025-03-26.

Quality QR MCP