uol-mcp-http

Servidor HTTP MCP para la API REST de contabilidad UOL (Streamable HTTP para Railway y Cursor).

Las lecturas se ejecutan inmediatamente. POST / PATCH / PUT / DELETE pasan por uol_request y necesitan confirm=true.

Entorno

• UOL_API_BASE_URL — raíz de la API del tenant, p. ej. https://YOUR-TENANT.ucetnictvi.uol.cz/api (con o sin /v1)

• UOL_API_EMAIL — correo de inicio de sesión de UOL (nombre de usuario de Basic Auth)

• UOL_API_TOKEN — token de Configuración de UOL → /api_tokens

• MCP_AUTH_TOKEN — token Bearer requerido por los clientes MCP

• PORT — puerto de escucha (Railway lo establece)

Demo (OpenAPI): https://test.demo.uol.cz/api + el correo/token de demostración de https://api.uol.cz/

Related MCP server: MCP Moloni ON

Puntos de conexión

• GET /health — comprobación de salud

• POST /mcp — MCP Streamable HTTP (autenticación requerida)

Cursor

No hagas commit de tokens reales. Añade esto localmente en .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 es MCP_AUTH_TOKEN en .deploy-secrets local (ignorado por git) y en el servicio de Railway.

Esta instancia actualmente se comunica con el tenant UOL demo (https://test.demo.uol.cz/api). Para la contabilidad en vivo de Gramodesky, cambia las variables de Railway UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN al tenant de producción (mismos valores que la tienda UOL_API_*).

GramBot (later)

Cuando el árbol de trabajo de la tienda esté limpio, adjunta HTTP MCP con MCP_UOL_URL + MCP_UOL_TOKEN (mismo patrón que Daktela / Fio).

Límite de tasa

UOL devuelve HTTP 429 durante 30 segundos cuando se excede: 30 solicitudes / 10 segundos (cuentas por cobrar: 10 / 10 segundos).