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. Значення 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. Віддалений сервер не підтримує 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 тієї версії, з якою зібрано сервер. Асистент читає контракт, коли пише код для роботи з API.

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

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