Pro AI asistenty (MCP)
Váš AI asistent (Claude a další, které podporují Model Context Protocol) se může ptát přímo naší databáze: návrhů zákonů, jejich textů, pozměňovacích návrhů, rozprav ve Sněmovně a hlasování. Jen čtení, 21 nástrojů.
Co to umí
MCP (Model Context Protocol) je standard, kterým se AI asistent připojí k externím datům. Místo aby odpovídal z paměti, zavolá naše nástroje a odpověď opře o skutečné údaje: tisk a jeho skóre, konkrétní paragraf návrhu, kdo co řekl v rozpravě, jak se hlasovalo.
- Návrhy zákonů 10. volebního období se skóre a důvody, jako na webu.
- Texty návrhů a pozměňovacích návrhů po paragrafech, včetně schváleného znění po 3. čtení.
- Stenoprotokoly: projevy, celé rozpravy k tiskům, změny textu po autorizaci.
- Hlasování k tiskům s rozdělením podle klubů.
- Hledání podle slov i podle významu: najde i projevy, které o tématu mluví jinými slovy.
- Ověření citace: asistent si může zkontrolovat, že výrok opravdu zazněl, než ho někomu přisoudí.
Jak to funguje
Kdo co dělá
- Váš asistent (Claude, ChatGPT a další) přemýšlí, co hledat, čte výsledky a píše odpověď. Běží u vás a na váš účet.
- Náš server jen vydává data z databáze: tisk, paragraf, projev, hlasování. Žádná umělá inteligence u nás odpovědi nepíše ani neupravuje.
- Váš rozhovor s asistentem nevidíme. K nám dorazí jen jednotlivá volání nástrojů, například „najdi projevy o zdražování energií“ nebo „dej mi § 44a tisku 221“.
Hledání podle slov a podle významu
Nástroje hledej_v_projevech a hledej_v_textech hledají dvěma způsoby a výsledky spojí:
- Podle slov (fulltext): najde místa, kde hledaná slova opravdu zazněla, bez ohledu na diakritiku. Probíhá celé u nás.
- Podle významu: najde i místa řečená jinak. Dotaz „zdražování energií“ tak najde i projev o „rostoucích cenách elektřiny“.
Hledání podle významu funguje takto: texty projevů a paragrafů máme předem převedené na „otisk významu“ (řadu čísel, takzvaný embedding). Při hledání se stejně převede i váš dotaz a v databázi se najdou nejbližší otisky. Převod dělá pomocný model text-embedding-3-large společnosti OpenAI. Není to chatovací AI: nic nepíše ani nehodnotí, jen převádí text na čísla. Dotaz musí převést stejný model jako uložené texty, proto to nemůže udělat váš asistent.
Co odchází mimo náš server
- Při hledání podle významu odchází text hledaného dotazu do OpenAI (několik slov, která asistent hledá). Posílá ho náš server svým jménem; OpenAI nedostane váš token, adresu ani zbytek rozhovoru. Zpracování se řídí podmínkami OpenAI pro jejich API.
- Nechcete-li to, řekněte asistentovi, ať hledá jen podle slov (parametr
rezim="fulltext"). Ostatní nástroje nic ven neposílají. - Hledání podle významu má denní strop pro všechny uživatele dohromady. Když se vyčerpá nebo OpenAI neodpoví do 3 sekund, hledá se jen podle slov; odpověď vždy uvádí, který způsob se použil (
rezim_pouzity).
Co si zaznamenáváme
U každého volání jen to, který nástroj se volal, kterým tokenem, kdy a jak dlouho trval (kvůli limitům a ladění). Text dotazů ani odpovědí neukládáme.
Přístup
- Adresa
https://mcp.cosepece.cz/mcp- Přenos
- Streamable HTTP, jen čtení
- Přihlášení
- hlavička
Authorization: Bearer <token> - Limity
- 60 volání za minutu a 2 000 za den na jeden token
Připojení
Claude Code
claude mcp add --transport http hlidac https://mcp.cosepece.cz/mcp --header "Authorization: Bearer VÁŠ_TOKEN"
Claude Desktop a další klienti s konfiguračním souborem
Klienti, kteří neumí poslat vlastní hlavičku, se připojí přes most mcp-remote (potřebuje Node.js):
{
"mcpServers": {
"hlidac": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.cosepece.cz/mcp",
"--header", "Authorization: Bearer VÁŠ_TOKEN"]
}
}
}
Token patří jen do vaší konfigurace. Kdo ho zná, čerpá vaše limity; při úniku napište a vydáme nový.
Nástroje
Podrobné parametry si asistent načte sám ze serveru; tady je přehled, co je k dispozici.
Návrhy zákonů a zákony
get_tisk | detail sněmovního tisku: předkladatel, fáze, skóre s důvody, měněné zákony, číslo ve Sbírce |
seznam_tisku | seznam návrhů s hledáním a řazením podle skóre nebo data |
tisky_menici_zakon | tisky a pozměňovací návrhy, které mění daný zákon (např. 586/1992) |
tisk_podle_sbirky | tisk, který byl vyhlášen ve Sbírce pod daným číslem |
Texty návrhů a pozměňovacích návrhů
osnova_textu | osnova textu (části, články, paragrafy, body), původní i schválené znění |
get_cel | jeden celek textu, např. „§ 17c“ nebo „Čl. I“ |
hledej_v_textech | hledání v textech návrhů a PN podle slov i podle významu, i podle měněného zákona |
Pozměňovací návrhy
pn_k_tisku | pozměňovací návrhy k tisku s autory a hodnocením AI |
get_pn | detail pozměňovacího návrhu včetně projevů, které ho zmiňují |
Rozprava a projevy (stenoprotokoly)
rozprava | celá rozprava k tisku v pořadí, jak zazněla, s reakcemi a zmíněnými PN |
projevy_k_tisku | rejstřík projevů k tisku s filtry podle řečníka, klubu a data |
projevy_recnika | projevy jedné osoby, i s hledanými slovy |
get_projev | celý text projevu s historií verzí a stavem autorizace |
hledej_v_projevech | hledání ve všech projevech podle slov i podle významu |
zmeny_projevu | projevy, jejichž text se po zveřejnění změnil (autorizace, korektury) |
najdi_osobu | poslanec nebo člen vlády podle jména |
program_schuze | body pořadu schůze Sněmovny |
Hlasování
hlasovani_k_tisku | všechna hlasování k tisku s výsledky a rozdělením podle klubů |
get_hlasovani | detail jednoho hlasování: kluby, hlas každého poslance a projevy, které se k němu vztahují |
Ověření a stav
over_citaci | ověří, že doslovná citace opravdu zazněla v projevu nebo stojí v textu zákona či PN |
stav_dat | stav dat a poslední synchronizace |
Ukázkové dotazy
- „Jak probíhala rozprava k tisku 221 a kdo v ní mluvil o zkrácení lhůty pro vymáhání dotací? Citace ověř.“
- „Které pozměňovací návrhy k tisku 311 mění jiný zákon než ten, který se projednává?“
- „Jak hlasovaly jednotlivé kluby o novele zákona o daních z příjmů?“
- „Co přesně mění tisk 221 v § 44a rozpočtových pravidel a od kdy to platí?“
- „Které projevy se po zveřejnění změnily a jak?“
Upozornění
Data jsou stejná jako na webu, ale odpověď skládá váš asistent a může se mýlit: špatně shrnout, přehlédnout souvislost nebo si citaci domyslet. Doslovné citace si nechte ověřit nástrojem over_citaci a důležité údaje zkontrolujte na psp.cz. Hodnocení AI v datech (skóre, titulky) má stejná omezení jako na webu, viz omezení odpovědnosti. Jiná strojová data (JSON, RSS) jsou na stránce Data a API.