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.»