uol-mcp-http

UOL Accounting REST API 用のHTTP MCPサーバー（RailwayとCursor向けのStreamable HTTP）。

読み取りは即座に実行されます。POST / PATCH / PUT / DELETEはuol_requestを経由し、confirm=trueが必要です。

環境変数

• 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 — MCPクライアントが要求するBearerトークン

• PORT — 待ち受けポート（Railwayが設定）

デモ（OpenAPI）: https://test.demo.uol.cz/api + https://api.uol.cz/ のデモメール/トークン

Related MCP server: MCP Moloni ON

エンドポイント

• 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 は、ローカルの .deploy-secrets（gitignore対象）とRailwayサービス上の MCP_AUTH_TOKEN です。

このインスタンスは現在 UOLデモ テナント（https://test.demo.uol.cz/api）と通信しています。本番のGramodesky会計を使用するには、Railwayの変数 UOL_API_BASE_URL / UOL_API_EMAIL / UOL_API_TOKEN を本番テナントに変更してください（ショップの UOL_API_* と同じ値）。

GramBot（後日）

ショップのワークツリーがクリーンになったら、MCP_UOL_URL + MCP_UOL_TOKEN でHTTP MCPを接続します（Daktela / Fioと同じパターン）。

レート制限

UOLは制限を超えると30秒間HTTP 429を返します: 30リクエスト / 10秒（売掛金: 10 / 10秒）。