Paigalda · Streamable HTTP · autentimist pole

Lisa minutark oma tehisarule

Kleebi see lause oma tehisaru vestlusse „Paigalda minutark.ee MCP". Claude Code ja Codex lisavad serveri ise; ChatGPT-s ja Claude'i rakenduses tuleb server lisada seadetes — abiline ütleb, kuidas. Allpool on sama paigaldus kliendi kaupa käsitsi, juhuks kui vajad paigaldamisel abi.

Põhiandmed

Tehnilised ühendusandmed

Serveri aadress https://mcp.minutark.ee/
Autentimine Autentimist ega kontot ei ole. Server on avatud anonüümseks kasutamiseks.
Tööriistad statute, search, give_feedback — täisskeemid annab tools/list.
Andmete kuupäev Kontrollin…

Käsitsi

Vajad paigaldamisel abi? Paigaldus kliendi kaupa

Iga juhend on sama kujuga: eeldused, üks tegevus, kontroll (küsimus ja oodatav viidatud vastus) ja veaotsing. Iga kontrollküsimus on ühtlasi automaattesti juhtum, seega on juhendid testitud.

Claude Desktop / Claude veebi kohandatud konnektor

Eeldused
  • Claude Desktopi rakendus (või Claude veebis kliendiga, mis toetab kohandatud konnektoreid)
  • Internetiühendus aadressile https://mcp.minutark.ee
Üks tegevus

Lisa Claude'i seadetes MCP-server tüübiga Streamable HTTP ja aadressiga:

https://mcp.minutark.ee/

Autentimist, päiseid ega võtit ei seadistata.

Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-CLAUDE-DESKTOP

Veaotsing

Vaata allpool levinud probleeme.

ChatGPT

Eeldused
  • ChatGPT Plus või kallim pakett (tasuta paketis konnektoreid ei ole)
  • Veebibrauser — chatgpt.com. Konnektor lisatakse veebis; pärast lisamist töötab see ka rakendustes

Ametlikus ChatGPT rakenduste kataloogis minutarka veel ei ole; kuni selleni lisatakse server käsitsi seadete alt.

Üks tegevus

Kirjuta ChatGPT-le „Paigalda minutark.ee MCP" — ta lisab serveri ise ja kirjutab ka allpool oleva püsijuhise (mõõdetud 24.09.2026: uus vestlus tegi seejärel 9 tööriistakutset, iga § õige).

Käsitsi: Seaded → Pluginad (Plugins) → nupp Lisa (Add) → rippmenüüst Add MCP Server: nimi minutark. Transpordi vaikeväärtus on STDIO — vali Streamable HTTP, alles siis ilmub aadressi väli:

https://mcp.minutark.ee/

Autentimine: puudub.

Püsijuhis

ChatGPT ei pruugi tööriista ise kasutada — meie mõõtmistes hakkas mudel seda kasutama alles siis, kui küsimuses paluti seadusele viidata. Lisa Seaded → Isikupärastamine → Kohandatud juhised alla üks lause:

Eesti seaduste küsimustes kasuta minutarka ja viita paragrahvidele.
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-CHATGPT

Veaotsing

Kui vastuses viidet ei ole, vaata, kas vestluses näed tööriista kutsumist (ChatGPT ja Claude näitavad seda) ja vastuse juurde on riigiteataja.ee link. Kui kumbagi pole, ei kasutanud abiline tööriista. Vaata ka levinud probleeme.

Claude Code

Eeldused
  • Claude Code'i käsurearakendus on paigaldatud (npm install -g @anthropic-ai/claude-code)
  • Internetiühendus
Üks tegevus

Lisa MCP-server käsuga claude mcp add:

claude mcp add --transport http minutark https://mcp.minutark.ee/
Tähelepanu: lipp --transport http on vajalik. Ilma selleta eeldab claude mcp add stdio-transporti, mis kaug-HTTP-serverile ligi ei pääse: server ilmub seadistusse, aga tööriistu ei laeta.
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-CLAUDE-CODE

Veaotsing

Kui tööriistad pärast serveri lisamist ei ilmu, kontrolli, kas lisasid --transport http. Kui lisasid serveri juba ilma liputa, eemalda see ja lisa uuesti:

claude mcp remove minutark
claude mcp add --transport http minutark https://mcp.minutark.ee/

Seejärel taaskäivita Claude Code — seadistus loetakse käivitumisel.

VS Code Copilot

Eeldused
  • VS Code koos GitHub Copilot Chati laiendusega (v0.22+)
  • Internetiühendus
Üks tegevus

Loo või muuda projekti juurkaustas fail .vscode/mcp.json:

{
  "servers": {
    "minutark": {
      "type": "http",
      "url": "https://mcp.minutark.ee/"
    }
  }
}
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-VSCODE

Veaotsing

Kui tööriistad ei ilmu, taaskäivita VS Code — MCP seadistus loetakse käivitumisel. Vaata levinud probleeme.

Codex (OpenAI CLI)

Eeldused
  • Codex CLI, sisse logitud ChatGPT Plus või kallima paketiga (või OpenAI API võtmega)
  • Terminal
Üks tegevus

Kirjuta Codexile „Paigalda minutark.ee MCP" — ta teeb selle ise. Käsitsi:

codex mcp add minutark --url https://mcp.minutark.ee/

Sama kirje faili ~/.codex/config.toml kujul: [mcp_servers.minutark] ja url = "https://mcp.minutark.ee/". Alusta uut Codexi seanssi — seadistus loetakse käivitumisel.

Püsijuhis

Codex loeb iga seansi alguses faili ~/.codex/AGENTS.md (Seaded → Isikupärastamine → Kohandatud juhised kirjutab sama faili). Lisa sinna üks lause, et tööriist läheks käiku ilma meeldetuletuseta:

Eesti seaduste küsimustes kasuta minutarka ja viita paragrahvidele.
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-CODEX

Veaotsing

Kui tööriistad ei ilmu, kontrolli codex mcp list väljundit ja alusta uut seanssi. Vaata levinud probleeme.

Cursor

Eeldused
  • Cursori redaktor (v0.45+)
  • Internetiühendus
Üks tegevus

Lisa Cursori seadetes MCP-server tüübiga HTTP ja aadressiga:

https://mcp.minutark.ee/
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-CURSOR

Veaotsing

Kui tööriistad ei ilmu, taaskäivita Cursor — MCP seadistus loetakse käivitumisel. Vaata levinud probleeme.

Üldine MCP-klient

Eeldused
  • Mis tahes MCP-ühilduv klient, mis toetab Streamable HTTP transporti
  • Internetiühendus
Üks tegevus

Lisa kliendile need kolm rida:

endpoint: https://mcp.minutark.ee/
transport: streamable-http
auth: none
Kontroll

Küsimus: „Mida ütleb liiklusseaduse (LS) § 13 lõige 3?"

Oodatav vastus: viide LS § 13 lg 3-le koos sätte tekstiga, redaktsiooni kehtivusaeg, andmete räsi ja link ametlikule allikale riigiteataja.ee-s.

Probe case ID: C4-GENERIC

Veaotsing

Vaata allpool levinud probleeme.

Kolm tööriista

Mida abiline serverist küsida saab

Vastus on seaduse tekst sellisena, nagu see on Riigi Teatajas avaldatud. Server ei genereeri ega tõlgenda seda.

statute

Tagastab sätte teksti viite järgi. Akt, paragrahv, lõige, punkt ja kuupäev annavad sel päeval kehtinud redaktsiooni.

Näidestatute(act: "TuMS", paragraph: "4", date: "2027-01-01")

search

Otsib sätete tekstist. Vastuseks on viidatud sätted — pikemad tekstid lühendatult; täisteksti annab statute.

Näidesearch(query: "töölepingu ülesütlemine katseajal")

give_feedback

Vea või ettepaneku saab saata otse tööriista kaudu; kõik teated vaadatakse läbi. Sama teed saab teatada ka puuduvast kliendist.

Näidegive_feedback(category: "missing_capability", comment: "…")

Päringud

Kuidas pärida

Kui tead, millist seadust vajad, on statute(act, paragraph) täpne ega jäta vahele — kasuta seda enne search-i. search võtab paar terminit seaduse enda sõnavaras: mitte tervet lauset ega liitsõna, mida seadus ei kasuta (pärimisjärjekord annab 0 tabamust, kolmanda järjekorra pärijad tabab § 12 lg 3 ja § 15 lg 1). Ära kleebi inimese olukorda päringusse — see on teenuse leping (RT-SEARCH-QUERY).

Veaotsing

Levinud probleemid

429 Too Many Requests

Vastuse 429 võib anda kaks erinevat piirajat ja need näevad veidi erinevad välja:

  • Ühine anonüümne päringulimiit — serveri enda ämber, mida jagavad kõik sisselogimata kasutajad. Selle 429 kannab alati päist Retry-After: 60: oota nii kaua ja proovi uuesti.
  • IP-põhine limiit — servareegel mcp.minutark.ee ees, mis loeb ühe aadressi päringuid 10-sekundilises aknas. Selle 429 sisu on väike JSON; päis Retry-After on tagatud ainult serveri enda 429 puhul, nii et kui see puudub, oota umbes kümme sekundit ja proovi uuesti.

Mõlemal juhul tasub päringute tempot vähendada: klient, mis kordab päringuid tihedas tsüklis, jääb limiidi taha.

403 Forbidden

Brauseripõhistes klientides. Server kontrollib päist Origin, mille brauserid saadavad. Brauseripäritolud lubatakse selle paigalduse lubatud nimekirja alusel (charti allowedOrigins, peegeldatud platvormi marsruudinõudest); leht, mida serveeritakse nimekirjast puuduvast päritolust, saab 403. Kliendi poolel seda muuta ei saa; lahendus on lasta oma päritolu nimekirja lisada (saada give_feedback teade päritolu nimetades, vt allpool). Brauserivälised kliendid (Claude Desktop, Claude Code, curl) päist Origin ei saada ja neid see ei puuduta.

Tööriistad ei ilmu

Kui server on seadistatud, aga selle tööriistu kliendis ei näe, taaskäivita kliendirakendus. Enamik MCP-kliente loeb seadistust ainult käivitumisel. Kui probleem püsib, kontrolli, et serveri aadress on õige ja kättesaadav (curl https://mcp.minutark.ee/ peaks vastuse tagastama).

Puuduv klient

Teavitamine tööriista kaudu

Kui MCP-klienti ülaltoodud juhendid ei kata, saab puuduva võimekuse teate saata sama serveri tööriistaga give_feedback. Kõik teated vaadatakse läbi.

give_feedback(category: "missing_capability", comment: "Add a walkthrough for <your client>")

Põhimõtted

Kuidas teenus andmeid käsitleb

Kontot pole vaja

Registreeruda pole vaja. Võtit ega isikuandmeid ei küsita.

Päringuid ei salvestata

Minutark ei salvesta sinu küsimusi. Privaatsusteave.

Iga vastus viitab allikale

Link Riigi Teataja ametlikule tekstile ja selle teksti kehtivuse kuupäevad.

Teenus annab viiteid seadusele, mitte õigusnõu. Oma olukorra kohta küsi juristilt.