uol-mcp-http

HTTP MCP сервер для UOL Accounting REST API (Streamable HTTP для Railway и Cursor).

Чтения выполняются немедленно. POST / PATCH / PUT / DELETE проходят через uol_request и требуют confirm=true.

Env

• UOL_API_BASE_URL — корень API тенанта, например https://YOUR-TENANT.ucetnictvi.uol.cz/api (с /v1 или без)

• UOL_API_EMAIL — электронная почта для входа в UOL (имя пользователя Basic Auth)

• UOL_API_TOKEN — токен из настроек UOL → /api_tokens

• MCP_AUTH_TOKEN — Bearer-токен, требуемый MCP-клиентами

• PORT — порт прослушивания (Railway устанавливает его)

Демо (OpenAPI): https://test.demo.uol.cz/api + демо-email/токен с https://api.uol.cz/

Related MCP server: MCP Moloni ON

Endpoints

• GET /health — проверка работоспособности

• POST /mcp — MCP Streamable HTTP (требуется аутентификация)

Cursor

Не коммитьте реальные токены. Добавьте это локально в .cursor/mcp.json:

{
  "mcpServers": {
    "uol": {
      "url": "https://uol-mcp-production.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

YOUR_MCP_AUTH_TOKEN — это MCP_AUTH_TOKEN в локальном .deploy-secrets (в gitignore) и в сервисе Railway.

Этот экземпляр в настоящее время общается с демо-тенантом UOL (https://test.demo.uol.cz/api). Для реального учёта Gramodesky измените переменные Railway UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN на производственный тенант (те же значения, что и в магазине UOL_API_*).

GramBot (later)

Когда рабочее дерево магазина чистое, подключите HTTP MCP с MCP_UOL_URL + MCP_UOL_TOKEN (та же схема, что и Daktela / Fio).

Rate limit

UOL возвращает HTTP 429 на 30 секунд при превышении: 30 запросов / 10 секунд (дебиторская задолженность: 10 / 10 секунд).