PRRO.cloud

io.github.prro-cloud由 GitHub 账号 prro-cloud 发布v0.4.0更新于 Nov 1, 2026

Read-only access to PRRO.cloud fiscal cash registers, shifts, tasks, billing and webhooks.

已验证Streamable HTTP可网页运行金融开发者工具商业与电商

概览

AI 生成的概览

以只读方式访问 PRRO.cloud 的收银机、班次、财税任务、账单与 Webhook，便于排查乌克兰 PRRO 集成问题。

可以做什么
  • 查看收银机与状态：列出令牌可见的收银机、班次状态、汇总、现金与离线会话
  • 查询财税任务：状态、财税编号、收据链接或 ДПС 失败原因
  • 查看账单与发票：余额、封禁阈值、各期间收据数量与费用
  • 检查 Webhook：订阅、投递历史与接收方错误
  • 识别令牌：客户端、权限、可访问收银机与有效期，以及服务与 API 版本
  • 读取随附的 OpenAPI 契约资源以协助编写集成代码
适用场景
适合将财税收银机（PRRO）集成到商店或会计系统的开发者，让助手看到收银机、任务与 Webhook 投递的真实状态并解释失败原因。也适合查看班次状态、账单用量或收据任务失败原因。
运行要求
需要 PRRO.cloud 后台签发的机器 API 令牌：本地服务器通过 PRRO_TOKEN 传入，远程端点 mcp.prro.cloud 通过 Authorization Bearer 头传入。本地运行需要 mcpb 包、二进制文件、Go 1.27 以上或 Docker。远程服务器每个令牌每分钟限 120 次请求，且不支持 OAuth，因此 claude.ai 与 ChatGPT 网页连接器需使用本地服务器。
安装前请注意
令牌属于凭据，不要把含令牌的客户端配置提交到仓库。应为助手单独签发令牌并限制其可见的收银机，最好使用测试收银机；账单、发票与 Webhook 仅对可访问全部收银机的令牌可读。远程服务器会在每次请求时把令牌转发给 PRRO.cloud API。所有工具均为只读，注册收据、开关班次与管理 Webhook 等操作被有意排除。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PRRO.cloud，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.prro-cloud%2Fprro-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "prro-cloud": {
      "type": "http",
      "url": "https://mcp.prro.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

prro-mcp

[CI]

MCP-сервер для API PRRO.cloud. Дає ІІ-асистентам (Claude Code, Claude Desktop, Cursor та іншим клієнтам Model Context Protocol) доступ до ваших кас, змін, фіскальних завдань, білінгу і вебхуків.

Для кого: розробники, які інтегрують ПРРО в магазин чи облікову систему. Асистент бачить реальний стан кас, завдань і доставок вебхуків і допомагає писати й налагоджувати інтеграцію: чому чек не пройшов, чи відкрита зміна, чи тестова вона, що відповів приймач вебхука.

  • Лише читання. Жоден інструмент не реєструє документів у ДПС, не відкриває і не закриває змін, не змінює налаштувань.
  • Працює локально через stdio (токен — зі змінної оточення) або як віддалений сервер https://mcp.prro.cloud/mcp (токен — у заголовку Authorization), нічого не встановлюючи.
  • Побудований на prro-go і офіційному Go SDK MCP.
  • Віддає асистенту контракт API (OpenAPI) — для написання коду інтеграції.

Токен

Випустіть окремий машинний токен для асистента в кабінеті, у розділі токенів:

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

Токен — облікові дані: не комітьте конфігурацію MCP-клієнта з ним у репозиторій.

Встановлення

Claude Desktop — завантажте prro-mcp.mcpb з останнього релізу, відкрийте його двічі клацнувши і вставте токен у налаштуваннях розширення. Пакет містить збірки для macOS і Windows.

Готовий бінарник — архів для Linux, macOS або Windows (amd64/arm64) з релізів; розпакуйте prro-mcp у каталог із PATH.

Go (потрібен Go 1.27 або новіший):

sh
go install github.com/prro-cloud/prro-mcp/cmd/prro-mcp@latest

Docker:

sh
docker run -i --rm -e PRRO_TOKEN ghcr.io/prro-cloud/prro-mcp

Перевірка: prro-mcp -version.

Віддалений сервер

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

Claude Code:

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

Або в .mcp.json проєкту (токен — з оточення кожного розробника):

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

Cursor — ~/.cursor/mcp.json або .cursor/mcp.json:

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 Code

sh
claude mcp add prro --env PRRO_TOKEN=ваш_токен -- prro-mcp

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

json
{  "mcpServers": {    "prro": {      "command": "prro-mcp",      "env": { "PRRO_TOKEN": "${PRRO_TOKEN}" }    }  }}

Claude Desktop

Найпростіше — пакет prro-mcp.mcpb (див. Встановлення). Вручну — у claude_desktop_config.json (Settings → Developer → Edit Config):

json
{  "mcpServers": {    "prro": {      "command": "/повний/шлях/до/prro-mcp",      "env": { "PRRO_TOKEN": "ваш_токен" }    }  }}

Cursor

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

json
{  "mcpServers": {    "prro": {      "command": "prro-mcp",      "env": { "PRRO_TOKEN": "${env:PRRO_TOKEN}" }    }  }}

Docker у будь-якому клієнті

json
{  "mcpServers": {    "prro": {      "command": "docker",      "args": ["run", "-i", "--rm", "-e", "PRRO_TOKEN", "ghcr.io/prro-cloud/prro-mcp"],      "env": { "PRRO_TOKEN": "ваш_токен" }    }  }}

Змінні оточення

ЗміннаПризначення
PRRO_TOKENМашинний токен API. Обов'язкова.
PRRO_BASE_URLАдреса API замість https://api.prro.cloud — для локального стенда.
PRRO_LANGМова повідомлень про помилки API: uk (типово) або en.
PRRO_MCP_LOG_LEVELРівень журналу: debug, info (типово), warn, error. Журнал іде в stderr; на debug видно запити до API. Токен у журнал не потрапляє.
PRRO_MCP_RATE_LIMITЛише з -http: запитів на хвилину з одним токеном, типово 120; 0 — без ліміту.

Інструменти

Усі інструменти лише читають і позначені readOnlyHint. Результат — структуровані дані (structuredContent за вихідною схемою) плюс коротке текстове зведення. Гроші — рядками, як в API: суми чеків і готівки — у гривнях, суми білінгу — у копійках.

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

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

Свідомо не входять операції, що пишуть: реєстрація чеків, відкриття і закриття змін, заява залишку готівки, керування офлайн-сесіями, зняття позначки уваги, створення, зміна, видалення і повтор вебхуків.

Приклади запитів

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

Розробка

sh
make test       # тести з -racemake lint       # golangci-lintmake build      # bin/prro-mcpmake sync-spec  # оновити копію контракту з ../prro-go

Тест контракту звіряє інструменти з internal/spec/openapi.yaml: кожна операція контракту або обслуговується інструментом, або явно виключена — нова операція в контракті валить тест.

Випуск

  1. Перенести зміни з [Unreleased] у розділ версії в CHANGELOG.md.
  2. git tag v0.1.0 && git push origin v0.1.0 — workflow Release збере архіви, образ ghcr.io/prro-cloud/prro-mcp, пакет prro-mcp.mcpb і server.json з SHA-256 пакета, додасть їх до релізу, а workflow MCP Registry опублікує server.json у реєстрі MCP через GitHub OIDC. Повторити публікацію для вже випущеного тега: gh workflow run registry.yml -f tag=v0.1.0.
  3. Покласти server.json із релізу в корінь репозиторію і закомітити.

Локально без публікації: make snapshot, потім scripts/mcpb.sh 0.0.0.

server.json містить і віддалений сервер (remotes), тож версію з ним публікувати лише тоді, коли https://mcp.prro.cloud/mcp уже працює.

Розгортання віддаленого сервера

З прапорцем -http сервер слухає Streamable HTTP без сесій: MCP на /mcp, перевірка живості на /healthz; токен приходить від клієнта, PRRO_TOKEN у цьому режимі заборонений. Файл Compose, змінні, приклади Caddy і nginx, вимоги до проксі й безпеки — у deploy/.

Ліцензія

Apache 2.0

来源：README.md，提交 864c373

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

4
  1. v0.4.0最新Nov 1, 2026
  2. v0.3.0Oct 22, 2026
  3. v0.2.0Oct 17, 2026
  4. v0.1.0Oct 15, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分