MCP — ühenda oma AI-assistent

Mis on MCP?

MCP (Model Context Protocol) on avatud standard, mis ühendab AI-assistendid välisteenustega. rahvakaup.ee pakub MCP-serverit, mille kaudu sinu AI-assistent saab teha rahvakaup.ee’s täpselt seda, mida sina ise veebis teeksid — ainult vestluse kaudu, ilma et peaksid igale sammule nupule vajutama.

Praktikas tähendab see, et saad öelda oma assistendile näiteks „leia mulle Tallinnas alla 300 € maksvad sülearvutid” või „pane see jalgratas müüki, fotod on lisas” — ja assistent teeb selle ära sinu konto nimel. Server asub aadressil https://stream.rahvakaup.ee/mcp.

Alustamine

Ühendamiseks on kolm sammu:

Loo juurdepääsuvõti (token). Ava Seaded → MCP, vajuta „Loo uus võti”, anna sellele nimi ja vali, milliseid tööriistu see võti tohib kasutada. Token kuvatakse ainult üks kord — kopeeri see kohe (algab eesliitega rk_).
Lisa võti oma assistenti. Claude Code’i puhul:

claude mcp add --transport http --scope user rahvakaup \
  https://stream.rahvakaup.ee/mcp \
  --header "Authorization: Bearer rk_SINU_VÕTI"

Valmis. Küsi assistendilt midagi oma kuulutuste kohta — see näeb nüüd ainult neid tööriistu, mille võtmele andsid.

Sama serverit toetab iga MCP-ühilduv klient (Claude’i rakendused, ChatGPT MCP-tugi jne) — kasuta sama /mcp aadressi ja Bearer-tokenit.

Mida saab teha

Saadaolevad tööriistad sõltuvad sinu konto tasemest (Free / Pro / Premium) ja sellest, mille võtmele lubasid. Peamised rühmad:

Otsing ja sirvimine (kõik tasemed) — otsi kuulutusi, vaata kategooriaid ja üksikuid kuulutusi.
Sinu kuulutused — loo, muuda, tõsta esile (bump), märgi müüduks, lae üles ja eemalda fotosid, vaata statistikat.
Sõnumid ja pakkumised — loe oma vestlusi, vasta ostjatele, saada ja vasta pakkumistele.
Salvestatud otsingud, lemmikud, teavitused, tarnestrateegiad — halda neid kõiki vestluse kaudu.

Näited

„Otsi aktiivseid sülearvuteid Tallinnas alla 300 €.” — assistent kasutab otsingut ja toob tulemused vestlusse.
„Pane mu vana jalgratas müüki, hind 120 €, fotod on lisas.” — assistent loob kuulutuse ja laeb fotod üles.
„Vasta kõigile, kes küsisid, kas diivan on veel saadaval.” — assistent loeb su vestlused ja saadab vastused.
„Märgi mu diivan müüduks ja tõsta jalgratta kuulutus esile.” — assistent muudab kuulutuse olekut ja teeb bump’i.
„Tõlgi mu kuulutuse pealkiri ja kirjeldus inglise keelde.” — assistent kasutab tõlketööriista.

Kasu: rutiinne kuulutuste haldamine, ostjatele vastamine ja otsimine käib loomuliku vestlusena — kiiremini ja ilma liidese sammhaaval läbiklõpsamiseta. Eriti mugav, kui sul on palju kuulutusi või sõnumeid.

Krediidid ja piirangud

MCP-kõned kasutavad sama iganädalast krediidipooli kui muud funktsioonid: lugemine maksab 1 krediidi, kirjutamine 2. Nädalane kogus sõltub tasemest (Free 100). Tühja pooli korral tagastab server vea credits_exhausted — krediidid täienevad iga nädal. Mõni tegevus on kallim (nt kuulutuse esiletõstmine / bump 50 krediiti, AI-tõlge 10). Tööriista kõne, mida su võti ei luba, lükatakse tagasi.

Turvalisus

Token on nagu parool — ära jaga seda ega pane avalikku kohta (nt koodirepo).
Iga võti on piiratud sinu valitud tööriistadega ja sinu konto tasemega — anna ainult need õigused, mida vaja.
Võtme saad igal ajal tühistada Seaded → MCP lehel; pärast seda lakkab see kohe töötamast.
Token kuvatakse loomisel ainult korra. Kui kaotad selle, tühista vana ja loo uus.