uol-mcp-http

UOL 회계 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초).