MCP-palvelin

Hobin MCP-palvelin (Model Context Protocol) antaa tekoälyavustimen tehdä samoja seuran ylläpitotehtäviä, joita teet hallintapaneelissa. Avustaja kirjautuu sinun Hob-tunnuksellasi ja näkee vain ne seurat ja toiminnot, joihin sinulla on jo oikeus.

MCP ei ole erillinen moduuli eikä sitä oteta käyttöön seuran moduulivalinnassa. Yhteys on yksi osoite koko Hobissa; seura valitaan vasta kirjautumisen jälkeen.

Tämä sivu kuvaa käytännön käyttöä, ei teknistä API-dokumentaatiota.

Kenelle sopii?

• Ylläpitäjille, jotka haluavat pyytää avustinta luomaan kausia, tunteja, coneja tai jäseniä
• Seuroille, joissa hallintatyötä tehdään keskustelemalla avustimen kanssa, ei pelkästään lomakkeita täyttämällä
• Tilanteisiin, joissa avustin tarvitsee lukea seuran tietoja (jäsenet, ohjelma, palautteet) ennen muutosta

MCP ei korvaa Hobin käyttöliittymää. Jäsenen ilmoittautuminen, maksaminen ja muut jäsenen toiminnot hoidetaan edelleen Hobissa.

Yhdistäminen

Palvelin käyttää streamable HTTP -yhteyttä. Osoite tuotannossa:

https://hob.fi/mcp/

Käytä osoitetta kauttaviivalla lopussa. Polku ei ole seuran alla (ei muotoa /ex_seura/mcp/).

1. Lisää MCP-asiakkaaseen (esimerkiksi Claude Desktop, Cursor tai MCP Inspector) streamable HTTP -palvelin, jonka URL on https://hob.fi/mcp/.
2. Jätä asiakastunnus ja salaisuus tyhjiksi, jos asiakas osaa rekisteröityä itse (dynaaminen asiakasrekisteröinti). Hob tarjoaa rekisteröinnin OAuth-palvelimellaan.
3. Ensimmäisellä työkalukutsulla asiakas avaa selaimen. Kirjaudu sisään omalla Hob-tunnuksellasi.
4. Tämän jälkeen avustin kutsuu työkaluja Bearer-tunnuksella. Kirjautumaton käyttäjä ei pääse palvelimeen.

Seuran valinta

Yhdellä yhteydellä näet kaikki seurat, joihin tunnuksesi kuuluu. Avustimen kannattaa ensin listata seurat ja vasta sitten tehdä seuran sisäisiä toimintoja.

Jokaisesta seurasta näkyy nimi, tekninen tunnus, aikavyöhyke ja käytössä olevat moduulit. Aika ilman aikavyöhykettä tulkitaan seuran paikallisena aikana (conissa conin omalla vyöhykkeellä, jos se on asetettu). Vastauksissa ajat palautetaan ISO 8601 -muodossa offsetin kanssa.

Kun seura on valittu, avustin voi kysyä, mitkä ylläpitotyökalut ja hakukokoelmat ovat käytössä juuri tuossa seurassa ja millä oikeuksilla. Työkalu, jota et saa kutsua, jää listalle merkinnällä, ettei se ole käytettävissä — avustin voi kertoa, mikä oikeus puuttuu, sen sijaan että ominaisuus piilotettaisiin.

Jäsenrekisterin työkalut ovat mukana, vaikka jäsenrekisteri ei olisi seuran ainoa moduuli. Älä pyydä avustinta kutsumaan työkaluja seuran käyttämättömään moduuliin: kutsu voidaan estää.

Muutokset, oikeudet ja jäljitys

Lukutyökalut hakevat tietoja. Kirjoittavat työkalut muuttavat seuran dataa (luonti, päivitys, julkaisu, poisto).

Jokainen kirjoittava kutsu vaatii lyhyen perustelun (miksi muutos tehdään) ja merkinnän, mikä avustin muutoksen teki. Muutos tallennetaan Hobin versiohistoriaan sinun käyttäjätunnuksellasi.

Oikeudet ovat samat kuin hallintapaneelissa. Jos et saa luoda jäseniä tai coneja käyttöliittymässä, et saa tehdä sitä MCP:n kautta. Pyydä tarvittaessa seuran pääkäyttäjää myöntämään vastaava rooli.

Yksityisyys

Työkalujen vastauksissa henkilötiedot (sähköposti, puhelin, sukunimi) lyhennetään oletuksena. Luonti ja haku voivat silti käyttää täyttä sähköpostia tai nimeä suodattimena.

Täydet henkilötiedot vastauksissa edellyttävät seuran palvelinasetusta. Tätä ei kytketä päälle MCP-kutsulla.

Mitä kunkin moduulin kautta voi tehdä

MCP ei julkaise kaikkea Hobin toiminnallisuutta. Alla on se, mitä avustin voi tällä hetkellä hoitaa. Jos moduulia ei ole listattu, sille ei ole MCP-työkaluja.

Yleiset työkalut

Kaikille kirjautuneille:

• testata, että yhteys toimii
• listata seurat, joihin tunnuksella on pääsy
• listata seuran moduulien työkalut ja hakukokoelmat
• hakea tietoja seuran kokoelmista (jäsenet, tunnit, conit ja niin edelleen), jos oikeudet riittävät

Jäsenrekisteri

Katso myös jäsenrekisteri.

Avustin voi:

• hakea jäseniä (henkilöitä), jäsenkausia ja jäsenluokkia
• luoda uuden jäsenen (henkilön, ei jäsenyyttä)
• luoda, päivittää ja kopioida jäsenkauden (kopiointi tuo lomakkeen ja jäsenluokat)
• luoda ja päivittää jäsenluokan (hinta, kuvaus, säännöt)

Jäsenyyden hyväksyntä tai hylkäys ei ole vielä MCP:ssä. Jäsen ja jäsenyys ovat eri asioita: jäsen on henkilö, jäsenyys on kausi- ja luokkakohtainen ilmoittautuminen.

Viikkotunnit

Katso myös viikkotunti-moduuli. Tekninen tunniste on danceclub.

Avustin voi:

• hakea kausia, tunteja (aktiviteetteja), tapahtumia ja kausikortteja
• luoda ja päivittää kauden
• luoda ja päivittää tunnin (kertakäynti, kurssi tai molemmat)
• luoda ja päivittää kausikortin ja kytkeä sen tunteihin
• luoda yksittäisiä tapahtumia tai generoida toistuvat tapahtumat viikkovälillä (esimerkiksi tiistaisin kauden loppuun, valitut päivät pois)
• päivittää tai poistaa tapahtuman (poisto epäonnistuu, jos tapahtumaan on ilmoittautumisia)

Tyypillinen järjestys: kausi → tunnit → tapahtumat (tai generointi) → kausikortit → tarvittaessa tunnin päivitys, jotta suositeltu kortti kytkeytyy. Ilmoittautumisia tai jonoja ei hallita MCP:llä.

Conit

Katso myös coni-moduuli.

Avustin voi:

• hakea coneja, ohjelmanumeroita ja ohjelmaehdotuksia sekä ohjelmaan osallistujia
• luoda conin (luonti ei julkaise sitä)
• päivittää conin asetuksia, aikoja, tiloja ja lomakkeita
• julkaista conin (erillinen toimenpide)
• luoda ja päivittää ohjelmanumeron
• hyväksyä ohjelmaehdotuksen ohjelmaksi tai hylätä ehdotuksen viestillä

Coniin ilmoittautumista, jonoa, majoituksen varaamista tai osallistujien vahvistamista ei tehdä MCP:llä. Ohjelmarivi ei sisällä osallistujia — osallistujat haetaan erikseen.

Palautekyselyt

Katso myös palautemoduuli.

Avustin voi:

• hakea palautekyselyitä ja annettuja vastauksia
• luoda ja päivittää kyselyn (slug, intro, lomake, päättymishetki)
• julkaista kyselyn, jotta vastauksia otetaan vastaan

Vastauksen lähettäminen jäsenenä ei ole MCP-työkalu. Julkaisematon kysely ei ole avoinna vastaajille.

Varaukset

Katso myös varausmoduuli. Tekninen tunniste on lending.

Avustin voi:

• luoda lainattavan resurssin (tila tai väline)
• lisätä resurssille varauslogiikan (säännön)
• kytkeä iCalendar-osoitteen aikatauluun (valinnainen suodatin kalenterin tapahtumille)
• kytkeä nimetyn aikataulun varauslogiikkaan
• luoda, päivittää ja poistaa varauksen ylläpitäjänä (resurssi slugin ja lainaaja sähköpostin perusteella)

Ylläpitäjän varaus MCP:n kautta ei noudata varauslogiikan rajoja (kapasiteetti, ehdot). Käytä tätä harkiten. Lainaajaa tai resurssia ei vaihdeta päivityksellä — luo tarvittaessa uusi varaus.

Viestintä

Hallintapaneelissa osio on Viestintä. Tekninen tunniste on messaging.

Avustin voi:

• hakea uutiskirjeitä (luonnokset ja julkaistut)
• luoda luonnosuutiskirjeen, joka on sidottu lähteeseen (esimerkiksi coni tai kausi)
• päivittää tai poistaa julkaisemattoman luonnoksen

Uutiskirjeen lähettäminen tai julkaisu ei ole MCP:ssä. Julkaistua kirjettä ei voi muokata eikä poistaa tämän kautta.

Käytännön vinkkejä

• Kerro avustimelle ensin seura (nimi tai tekninen tunnus) ja mitä haluat saada aikaan, esimerkiksi “luo syyskauden viikkotunnit”.
• Pyydä avustinta listaamaan seuran työkalut, jos jokin toiminto ei onnistu — kyse voi olla puuttuvasta oikeudesta tai siitä, ettei moduuli ole käytössä.
• Anna kirjoittaville toimille selkeä syy (“kausi 2026 avataan”).
• Älä oleta, että avustin voi hyväksyä jäsenyyksiä, ilmoittaa jäseniä tunneille tai lähettää uutiskirjeitä — nämä eivät ole MCP:ssä.
• Tarkista tulos hallintapaneelista, jos muutos on julkinen (conin julkaisu, palautekyselyn avaus).