Znalosti MCP

Hybridní RAG server pro znalostní korpusy GPS Dozor. Endpoint https://notebook.gpsdozor.cz/mcp (streamable HTTP, OAuth). Server vrací doslovné úryvky s citací, syntézu dělá volající model.

Zjišťuji stav…

Připojení

Vyžaduje Google účet @gpsdozor.cz. V Claude Code:

claude mcp add --transport http znalosti https://notebook.gpsdozor.cz/mcp

Pak /mcp a přihlásit. OAuth (authorization code + PKCE s dynamickou registrací klienta) zvládne Claude Code sám, žádné tokeny se nikam nevyplňují. Plugin prospektor má server v konfiguraci automaticky.

Nástroje

Nástroj	Parametry	Co dělá
`list_notebooks`		Seznam notebooků s popisem, autorem a počtem zdrojů.
`search`	notebookId, query, maxUryvku?, minSkore?, tier?, brand?	Hledání, hlavní nástroj. Detail níže.
`list_sources`	notebookId	Zdroje notebooku s metadaty a počtem zaindexovaných chunků.
`create_notebook`	name, description?	Založí notebook.
`delete_notebook`	notebookId	Smaže notebook i se zdroji a indexem.
`add_source`	notebookId, title, text, tier?, brand?, lang?, reviewedAt?, externalId?	Přidá textový zdroj. Text s osobními údaji server odmítne; se stejným `externalId` zdroj nahradí.
`remove_source`	sourceId	Odebere zdroj.

`search` podrobně

Parametr	Typ	Význam
notebookId	int	který korpus (tabulka níže)
query	string	přirozený jazyk; tvrzení funguje lépe než otázka
maxUryvku	int	výchozí 8, strop 30; pro rešerši ber 20
minSkore	float	práh podobnosti, výchozí 0,5
tier	string	úroveň volajícího: `public`, `customer`, `internal`; vrací jen zdroje té úrovně a nižší
brand	string	jen zdroje dané značky

Odpověď:

{
  "uryvky": [
    {
      "zdroj": "Honza z Inicia - prepisy 3",
      "radky": "5795-5797",
      "skore": 0.654,
      "text": "…doslovný text úryvku, cituje se odsud…"
    }
  ],
  "segmentuNadPrahem": 155,
  "nezaindexovanoChunku": 0
}

zdroj + radky je adresa citace v korpusu, ne cesta k souboru.
nezaindexovanoChunku > 0 znamená, že indexace ještě běží a výsledek je z části korpusu.
Skóre: 0,65+ silná shoda ve stejném jazyce, 0,55 až 0,65 posoudit, pod 0,55 šum. Prázdný výsledek = v korpusu to není.
Stejný text se vrací jen jednou.

Notebooky na serveru

id	Notebook	Jazyk	Obsah
21	Honza z Inicia	česky	copywriting, nadpisy, přistávací stránky, reference, český trh
22	Alex Hormozi	anglicky	stavba nabídky, cena, záruky, uzavírání, škálování
23	GPS Dozor podpora	česky	anonymizované e-maily podpory ve vláknech: jednotky, CAN, instalace, kompatibilita vozidel
24	GPS Dozor materiály	česky, část SK	FAQ, funkce, manuály, montáž, interní procesy, web

Aktuální seznam vrací list_notebooks.

Jak formulovat dotaz

Tvrzením, ne otázkou. Korpusy jsou mluvené slovo: „poslali jsme nabídku a pak se nic neděje“ najde první místo, „funguje posílání nabídek?“ mine i top 20.
V jazyce korpusu. Alex anglicky, ostatní česky. Mezi jazyky to funguje se ztrátou zhruba 0,1 skóre.
Dvě až tři formulace. Rozdíl mezi formulacemi je celý rozsah od „nic“ po „první místo“.
Přesné termíny (guarantee, kódy jednotek) nech v dotazu doslova, vzácné výrazy se hledají i přesnou shodou.

Stav serveru