uol-mcp-http

HTTP-MCP-Server für die UOL Accounting REST API (Streamable HTTP für Railway und Cursor).

Lesevorgänge werden sofort ausgeführt. POST / PATCH / PUT / DELETE laufen über uol_request und benötigen confirm=true.

Env

• UOL_API_BASE_URL — API-Root des Tenants, z. B. https://YOUR-TENANT.ucetnictvi.uol.cz/api (mit oder ohne /v1)

• UOL_API_EMAIL — UOL-Anmelde-E-Mail (Basic-Auth-Benutzername)

• UOL_API_TOKEN — Token aus UOL-Einstellungen → /api_tokens

• MCP_AUTH_TOKEN — Bearer-Token, das von MCP-Clients benötigt wird

• PORT — Listen-Port (Railway setzt diesen)

Demo (OpenAPI): https://test.demo.uol.cz/api + die Demo-E-Mail/das Demo-Token von https://api.uol.cz/

Related MCP server: MCP Moloni ON

Endpoints

• GET /health — Healthcheck

• POST /mcp — MCP Streamable HTTP (Authentifizierung erforderlich)

Cursor

Committen Sie keine echten Tokens. Fügen Sie dies lokal in .cursor/mcp.json hinzu:

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

YOUR_MCP_AUTH_TOKEN ist MCP_AUTH_TOKEN in lokalen .deploy-secrets (gitignored) und auf dem Railway-Dienst.

Diese Instanz spricht derzeit mit dem UOL-Demo-Tenant (https://test.demo.uol.cz/api). Für die Live-Buchhaltung von Gramodesky ändern Sie die Railway-Variablen UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN auf den Produktions-Tenant (gleiche Werte wie im Shop UOL_API_*).

GramBot (später)

Wenn der Shop-Worktree sauber ist, hängen Sie HTTP MCP mit MCP_UOL_URL + MCP_UOL_TOKEN an (gleiches Muster wie Daktela / Fio).

Rate-Limit

UOL gibt bei Überschreitung 30 Sekunden lang HTTP 429 zurück: 30 Anfragen / 10 Sekunden (Forderungen: 10 / 10 Sekunden).