PRRO.cloud

Контакти

Відповідаємо в робочі дні.

Кабінет

MCP-сервер

prro-mcp дає ШІ-асистентам — Claude Code, Claude Desktop, Cursor та іншим клієнтам Model Context Protocol — доступ до стану ваших кас. Асистент бачить реальні зміни, завдання й доставки вебхуків і допомагає писати й налагоджувати інтеграцію: чому чек не пройшов, чи відкрита зміна, що відповів приймач вебхука. Сервер уже працює за адресою https://mcp.prro.cloud/mcp — достатньо додати її в асистент разом із токеном, встановлювати нічого не треба.

Опублікований в офіційному реєстрі MCP як io.github.prro-cloud/prro-mcp, код — на GitHub.

Лише читання

  • Нічого не реєструє.

    Жоден інструмент не подає документів у ДПС, не відкриває й не закриває змін і не змінює налаштувань.

  • Токен не зберігається.

    Віддалений сервер пересилає токен із заголовка Authorization в API PRRO.cloud і ніде його не зберігає; локальний бере його зі змінної оточення PRRO_TOKEN.

  • Окремий токен.

    Випустіть для асистента окремий машинний токен і обмежте його касами, які асистент має бачити, — найкраще тестовою. Білінг, рахунки й вебхуки бачить лише токен з доступом до всіх кас. Відкликати токен можна в кабінеті за jti, який показує інструмент whoami.

Підключення

Адреса сервера — https://mcp.prro.cloud/mcp. Токен передається в заголовку Authorization: Bearer кожного запиту; ліміт — 120 запитів на хвилину з одним токеном.

Claude Code — одна команда; для всієї команди той самий сервер можна описати в .mcp.json у корені проєкту, а токен кожен візьме зі свого оточення.

claude mcp add --transport http prro https://mcp.prro.cloud/mcp \
  --header "Authorization: Bearer ваш_токен"

Cursor — ~/.cursor/mcp.json для всіх проєктів або .cursor/mcp.json у проєкті:

{
  "mcpServers": {
    "prro": {
      "url": "https://mcp.prro.cloud/mcp",
      "headers": { "Authorization": "Bearer ${env:PRRO_TOKEN}" }
    }
  }
}

Локальний сервер

Веб-конектори claude.ai і ChatGPT, а також Claude Desktop через «Add custom connector» вимагають OAuth, якого віддалений сервер не підтримує. Для них — той самий сервер, запущений у вас:

  • Claude Desktop. Завантажте prro-mcp.mcpb з останнього релізу, відкрийте його і вставте токен у налаштуваннях розширення. Пакет містить збірки для macOS і Windows.
  • Готовий бінарник для Linux, macOS і Windows (amd64 і arm64) — з релізів; розпакуйте prro-mcp у каталог із PATH. У Claude Code: claude mcp add prro --env PRRO_TOKEN=ваш_токен -- prro-mcp.
  • Go 1.27+: go install github.com/prro-cloud/prro-mcp/cmd/prro-mcp@latest.
  • Docker: docker run -i --rm -e PRRO_TOKEN ghcr.io/prro-cloud/prro-mcp.

Що бачить асистент

ІнструментЩо повертає
whoami Клієнт, дозволи токена, доступні каси, строк дії
list_cash_registers Каси токена: ідентифікатор, фіскальний номер, режим, стан
get_cash_register_state Зміна та її підсумки, готівка, офлайн-сесія, позначка «потребує уваги»
get_task Фіскальне завдання: стан, фіскальний номер і посилання на чек або опис збою ДПС
get_dps_status Режим роботи з ДПС (онлайн чи офлайн) і телеметрія детектора
list_webhooks Вебхуки, їхні підписки й ліміт кількості
list_webhook_deliveries Історія доставок вебхука з помилками приймача
get_billing_usage Баланс, поріг блокування, кількість і вартість чеків за період
list_invoices Рахунки за розрахункові періоди
get_version Версії сервісу, контракту API, prro-mcp і prro-go

Окрім інструментів, сервер віддає ресурс prro://openapi.yaml — публічний контракт API, з яким його зібрано: асистент читає його, коли пише код інтеграції.

Що можна запитати

  • «Які каси бачить мій токен і чи відкрита на них зміна?»
  • «Чому завдання 0199… завершилося помилкою і що з цим робити?»
  • «Покажи невдалі доставки вебхука за останній день і поясни, що не так із моїм приймачем.»
  • «Скільки чеків ми пробили у вересні і скільки це коштувало?»
  • «Напиши обробник вебхука task.failed на Go за контрактом API.»