prro-mcp
MCP-сервер для API PRRO.cloud. Дає ІІ-асистентам (Claude Code, Claude Desktop, Cursor та іншим клієнтам Model Context Protocol) доступ до ваших кас, змін, фіскальних завдань, білінгу і вебхуків.
Power your agent
URL ของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
https://mcp.prro.cloud/mcpปุ่ม Claude ด้านบนจะเปิด Claude พร้อมกรอกชื่อและ URL ให้แล้ว คุณยังต้องยืนยันที่นั่นเอง
claude mcp add --transport http io.github.prro-cloud-prro-mcp https://mcp.prro.cloud/mcpRun in a terminal.
{ "mcpServers": { "io.github.prro-cloud-prro-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.prro.cloud/mcp" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
MCP-сервер для API PRRO.cloud. Дає ІІ-асистентам (Claude Code, Claude Desktop, Cursor та іншим клієнтам Model Context Protocol) доступ до ваших кас, змін, фіскальних завдань, білінгу і вебхуків.
Read-only access to PRRO.cloud fiscal cash registers, shifts, tasks, billing and webhooks.
Для кого: розробники, які інтегрують ПРРО в магазин чи облікову систему. Асистент бачить реальний стан кас, завдань і доставок вебхуків і допомагає писати й налагоджувати інтеграцію: чому чек не пройшов, чи відкрита зміна, чи тестова вона, що відповів приймач вебхука.
https://mcp.prro.cloud/mcp (токен — у заголовку
Authorization), нічого не встановлюючи.Випустіть окремий машинний токен для асистента в кабінеті, у розділі токенів:
jti — його показує
інструмент whoami.Токен — облікові дані: не комітьте конфігурацію MCP-клієнта з ним у репозиторій.
Claude Desktop — завантажте prro-mcp.mcpb з
останнього релізу,
відкрийте його двічі клацнувши і вставте токен у налаштуваннях розширення.
Пакет містить збірки для macOS і Windows.
Готовий бінарник — архів для Linux, macOS або Windows (amd64/arm64) з
релізів; розпакуйте
prro-mcp у каталог із PATH.
Go (потрібен 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
Перевірка: prro-mcp -version.
https://mcp.prro.cloud/mcp — той самий набір інструментів без
встановлення. Токен передається в заголовку Authorization: Bearer кожного
запиту; сервер пересилає його в API PRRO.cloud і ніде не зберігає. Ліміт —
120 запитів на хвилину з одним токеном.
Claude Code:
claude mcp add --transport http prro https://mcp.prro.cloud/mcp \
--header "Authorization: Bearer ваш_токен"
Або в .mcp.json проєкту (токен — з оточення кожного розробника):
{
"mcpServers": {
"prro": {
"type": "http",
"url": "https://mcp.prro.cloud/mcp",
"headers": { "Authorization": "Bearer ${PRRO_TOKEN}" }
}
}
}
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 mcp add prro --env PRRO_TOKEN=ваш_токен -- prro-mcp
Або для всієї команди — у .mcp.json в корені проєкту; токен кожен бере зі
свого оточення, тож файл можна комітити:
{
"mcpServers": {
"prro": {
"command": "prro-mcp",
"env": { "PRRO_TOKEN": "${PRRO_TOKEN}" }
}
}
}
Найпростіше — пакет prro-mcp.mcpb (див. Встановлення).
Вручну — у claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"prro": {
"command": "/повний/шлях/до/prro-mcp",
"env": { "PRRO_TOKEN": "ваш_токен" }
}
}
}
~/.cursor/mcp.json (для всіх проєктів) або .cursor/mcp.json у проєкті:
{
"mcpServers": {
"prro": {
"command": "prro-mcp",
"env": { "PRRO_TOKEN": "${env:PRRO_TOKEN}" }
}
}
}
{
"mcpServers": {
"prro": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "PRRO_TOKEN", "ghcr.io/prro-cloud/prro-mcp"],
"env": { "PRRO_TOKEN": "ваш_токен" }
}
}
}
Усі інструменти лише читають і позначені readOnlyHint. Результат —
структуровані дані (structuredContent за вихідною схемою) плюс коротке
текстове зведення. Гроші — рядками, як в API: суми чеків і готівки — у
гривнях, суми білінгу — у копійках.
Ресурс prro://openapi.yaml — публічний контракт API (OpenAPI 3.1), з
яким зібрано сервер. Асистент читає його, коли пише код інтеграції.
Свідомо не входять операції, що пишуть: реєстрація чеків, відкриття і закриття змін, заява залишку готівки, керування офлайн-сесіями, зняття позначки уваги, створення, зміна, видалення і повтор вебхуків.
0199… завершилося помилкою і що з цим робити?»task.failed на Go за контрактом API.»make test # тести з -race
make lint # golangci-lint
make build # bin/prro-mcp
make sync-spec # оновити копію контракту з ../prro-go
Тест контракту звіряє інструменти з internal/spec/openapi.yaml: кожна
операція контракту або обслуговується інструментом, або явно виключена —
нова операція в контракті валить тест.
[Unreleased] у розділ версії в CHANGELOG.md.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.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/.
Read-only access to PRRO.cloud fiscal cash registers, shifts, tasks, billing and webhooks.
{ "mcpServers": { "io.github.prro-cloud-prro-mcp": { "url": "https://mcp.prro.cloud/mcp", "headers": {} } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก http สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: PRRO_TOKEN, PRRO_BASE_URL, PRRO_LANG, PRRO_MCP_LOG_LEVEL
PRRO.cloud เข้าถึงได้ผ่าน HTTP
ตรวจสอบล่าสุดเมื่อ 2026-11-10 Read-only access to PRRO.cloud fiscal cash registers, shifts, tasks, billing and webhooks.