AI asistenti
Vzdálený MCP server
Stateless Streamable HTTP adaptér nad stejnými službami, oprávněními a limity jako REST API v1.
Připojení
Endpoint: https://volnekurty.cz/api/mcp
Header: Authorization: Bearer <OSOBNI_API_TOKEN>Primární protokol je 2026-07-28, kompatibilní fallback 2025-11-25. Každý POST musí nést jednu JSON-RPC zprávu; endpoint neposkytuje dlouhé streamy ani OAuth discovery.
Nástroje
| Tool | Scope | Jednotky |
|---|---|---|
get_catalog | catalog:read | 1 |
list_venues | catalog:read | 1 |
get_venue | catalog:read | 1 |
search_availability | catalog:read + availability:read | počet dní |
list_my_favorites | favorites:read | 1 |
get_my_access | platný token | 0 |
tools/list, inicializace a discovery nečerpají denní jednotky, ale podléhají společnému krátkodobému limitu.
Klienti a skutečně ověřená kompatibilita
Oficiální MCP TypeScript klient 2.3.1: automatizovaným integračním testem prošlo připojení, discovery, všech šest tools a 401 po odvolání přes skutečný HTTP handler.
Claude custom connector: oficiální dokumentace popisuje vlastní request headers včetně Bearer tokenu. Proti veřejnému nasazení VolnéKurty ale zatím nebyl prakticky ověřen, proto ho neoznačujeme za potvrzeně kompatibilní.
ChatGPT: osobní Bearer režim nepodporujeme ani neslibujeme. Integrace je odložená na samostatnou OAuth fázi.
Token nevkládej do promptu