KUURA + MCP

Yhdistä oma tekoälyavustaja Kuurasivuihisi

Kerro avustajallesi mitä haluat muuttaa, pyydä uusi sivusto tai kysy näyttökertoja. MCP-yhteydellä avustaja voi tehdä nämä asiat suoraan Kuuraan antamiesi oikeuksien rajoissa. Kuura tallentaa versiot, paketoi sivut ja hoitaa julkaisun.

Kopioi käyttöönotto-ohje Hallitse omia yhteyksiä

Mikä MCP on ja mihin sitä käytetään?

MCP eli Model Context Protocol on yhteinen tapa yhdistää tekoälyavustaja muihin palveluihin. Sen avulla avustaja voi keskustelun lisäksi hakea tietoa ja käyttää palvelun sallittuja toimintoja. Kuuran kohdalla tämä tarkoittaa omien verkkosivujesi lukemista, muokkaamista ja julkaisemista sekä lisäosien ja näyttökertojen käsittelyä.

Avustaja lähettää muutokset Kuuraan. Sivustosi säilyvät Kuurassa ja julkaiseminen tapahtuu Kuuran kautta, samalla tavalla kuin lähdekoodieditorissa tehtyjen muutosten jälkeen.

Kopioi ohje ja anna avustajan auttaa

Tämä ohje on julkinen. Et tarvitse kirjautumista sen lukemiseen tai kopioimiseen. Oikeudet hyväksyt myöhemmin Kuuran omalla sivulla.

1. Kopioi ohje

Liitä alla oleva ohje käyttämällesi tekoälyavustajalle. Ohjeen lukeminen ja kopioiminen ei vaadi kirjautumista.

2. Hyväksy Kuuran sivulla

Kirjaudu omalla tililläsi ja valitse sivustot sekä oikeudet. Sähköpostin pitää olla vahvistettu.

3. Testaa yhteys

Pyydä avustajaa testaamaan tilitiedot, sivustolista ja ohjeen luku. Jatka tehtävää, kun tarvittavat kutsut onnistuvat.

Kerro tehtävä samassa viestissä ohjeen kanssa. Oletusoikeuksilla voit sekä katsoa tilastoja että muokata ja julkaista valitsemiasi sivustoja. Voit valita hyväksyntäsivulla myös pelkän katseluyhteyden.

Muokkaus tallentuu ensin luonnokseksi, jonka voit esikatsella. Jos haluat muutoksen myös näkyviin sivustolle, pyydä esimerkiksi: ”Tee testimuokkaus ja julkaise se.” Julkaisu menee jonoon ja valmistuu yleensä noin 10 sekunnissa–1 minuutissa; ruuhkassa se voi kestää pidempään. Avustaja seuraa valmistumista ja vahvistaa, kun muutos on julkaistu.

Suosittelemme Analyzer-pikatestiä muutosten jälkeen ja ennen julkaisua. Pyydä esimerkiksi: ”Tarkista sivustoni kaikki linkit ja SEO-perustiedot. Kerro rikkinäiset ja tarkistamatta jääneet kohteet.” Tarkistus tarvitsee vain sivuston lukuoikeuden eikä käytä AI-krediittejä. Julkaisun jälkeen kannattaa tarkistaa myös linkkien julkinen HTTP-tila.

Ohje avustajalle

Auta minua käyttämään Kuuraa. Kysy yhdellä viestillä vain puuttuvat tiedot: tehtävä, sivusto ja tarvittaessa ajanjakso. Käytä jo antamiani vastauksia. Etene näin:

1. Tarkista nykyiset Kuura-työkalut. Jos ne näkyvät, siirry kohtaan 5. Muuten tarkista tämän avustajan MCP-asetukset. Palvelin: https://app.kuura.app/mcp (Streamable HTTP, OAuth, dynaaminen asiakasrekisteröinti). Codex CLI samassa ympäristössä: codex mcp list; lisää vain puuttuva yhteys komennolla codex mcp add kuura --url https://app.kuura.app/mcp. Jos et voi hallita tämän avustajan asetuksia, opasta käyttäjää niihin. Selvitä lisäohjeista vain puuttuva tieto tai konkreettinen virhe.

2. Käynnistä yksi OAuth-kirjautuminen. add voi aloittaa sen jo; älä käynnistä rinnalle login-komentoa. Jo lisätylle yhteydelle käytä tarvittaessa codex mcp login kuura (tai tallennettua nimeä). Käytä automaattisesti avautuvaa selainta ja samaa välilehteä; jos sivu ei avaudu, avaa saman käynnissä olevan pyynnön linkki kerran. Valitse Kuuran sivulla suomi (ui_locales=fi). Minä kirjaudun ja hyväksyn valinnat. Älä avaa toista hyväksyntää toiseen selaimeen.

3. Oletuksena pyydä kaikki Kuuran oikeudet, jotta voin samalla yhteydellä lukea tilastoja, muokata ja julkaista sivustoja, käyttää lisäosia ja henkilötietoja sekä lukea mediakirjastoa ja lisätä sinne kuvia (media:read ja media:write). Älä rajaa yhteyttä automaattisesti lukuoikeuksiin ensimmäisen tilastokysymyksen perusteella. Valitsen sivustot ja hyväksyn näkyvät oikeudet Kuuran lomakkeella. Uusien sivustojen luominen vaatii lisäksi pääsyn kaikkiin omiin nykyisiin ja tuleviin sivustoihin; sitä ei valita automaattisesti. Vain jos haluan pelkän katseluyhteyden, valitse sites:read ja analytics:read.

4. Tarkista OAuthin jälkeen kuura_account: connection_id ja scopes. Muokkaus tarvitsee sites:write ja julkaisu sites:publish. Mediakirjastoon lataus tarvitsee media:write. Jos tehtävän tarvitsemat oikeudet puuttuvat eikä niitä ole vielä hyväksytty, pyydä yksi uusi hyväksyntä tarvittaville oikeuksille. Jos uusi hyväksyntä on jo annettu mutta kuura_account palauttaa vanhan connection_id:n, nykyinen istunto käyttää vanhaa yhteyttä. Päivitä tämän avustajan MCP-yhteys kerran, jos mahdollista. Ellei uusi yhteys tai sen työkalut lataudu, pyydä avustajan tai IDE-laajennuksen uudelleenkäynnistys ja anna tehtävän jatkoviesti. Kerro täsmällinen tilanne, älä kaikkien työkalujen puuttuvan, jos luku toimii. Lopeta kierros tähän; älä toista hyväksyntää tai kirjaudu ulos kokeeksi.

5. Kutsu kuura_account, kuura_list_sites ja lue kuura://guide MCP-resurssina. Raportoi kolme tulosta lyhyesti ja tarkista tehtävän oikeudet; jos ne puuttuvat, toimi kohdan 4 mukaan. Tarkista site_ids ja all_own_sites: [64] tarkoittaa yhtä sivustoa, jonka tunniste on 64. Valitse sivusto nimen perusteella ja jatka next_after_id-sivutusta tarvittaessa. Epäselvä näkymä ei yksin osoita liian laajaa pääsyä. Älä katkaise yhteyksiä vianetsintäkokeena.

6. Jatka suoraan pyytämääni tehtävää. Näyttökertojen ”kaikki” tarkoittaa kuura_get_analytics(site_id, period="all"): kerro päivähistorian summa, laskuri ja saatavilla oleva ajanjakso; älä arvaa puuttuvia lukuja. Muutoksissa lue nykyinen lähdekoodi, säilytä muu sisältö ja tallenna luonnos. MVC: site_files.site_kind="mvc_multi_page", yhteinen layout_html ja pages[].content_html. Layoutin <rime-content></rime-content> sijoittaa sivun sisällön, <rime-title></rime-title> otsikon, <rime-description></rime-description> kuvauksen ja <rime-navigation></rime-navigation> navigation-listan linkit. Tarkempi rakenne on kuura://guide-ohjeessa ja kuura_save_source-skeemassa. Onnistuneen tallennuksen jälkeen kerro: ”Muutos on tehty ja tallennettu luonnokseksi”, ja anna esikatselulinkki. Pelkkä tallennus ei jonota julkaisua; sivuston deploy_status=pending ei tarkoita epäonnistunutta tallennusta eikä todista julkaisujonoa. Julkaise vain pyynnöstäni ja myönnetyillä oikeuksilla. Jos pyysin muokkausta ja julkaisua, jatka kuura_publish-kutsuun ilman uutta lupakysymystä. Kerro: ”Muutos on tallennettu, julkaisu on jonossa ja valmistuu yleensä noin 10 sekunnissa–1 minuutissa.” Seuraa kuura_get_job(site_id, job_id)-kutsuilla noin 10 sekunnin välein, kunnes työ on success, failed tai cancelled; älä lopeta pending-tilaan. Jos minuutti ylittyy, kerro viiveestä ja jatka seurantaa, älä jonota julkaisua uudelleen. Vahvista vasta success-tilassa: ”Muutos on tehty ja julkaistu”, ja anna sivuston linkki. Jos seuranta estyy, kerro viimeisin vahvistettu tila ja työn tunniste. Kuvat: kuura_upload_image lisää sivuston liitteen, kuura_upload_media lisää henkilökohtaiseen mediakirjastoon ja palauttaa heti julkisesti avattavan kuvalinkin. Hyväksytyt muodot ovat JPEG, PNG ja WebP, enintään 2 MiB, 8 megapikseliä ja 8192 px kummallakin sivulla; SVG ja muut tiedostot eivät kelpaa. Dynaamisen sisällön muutos voi näkyä heti. Älä pyydä salasanoja tai tunnisteita keskusteluun.

Suositeltu pikatesti: aja kuura_analyze_site tallennetulle version_id:lle muutosten jälkeen ja ennen julkaisua. Tarkista kaikki sivut, sisäiset linkit, ankkurit, placeholderit ja SEO-perustiedot. Testi ei muokkaa tai julkaise eikä käytä AI-krediittejä. Julkaisun jälkeen aja kuura_check_links samalla version_id:llä ja check_http=true, jotta myös julkisten linkkien HTTP-tila tarkistetaan. Jatka next_after_link-arvolla after_link-kentässä samalla versiolla ja rajauksilla, kunnes next_after_link=null. Kokoa kaikkien erien tulokset ja kerro rikkinäiset sekä tarkistamatta jääneet linkit. skipped, unchecked tai scan_truncated eivät todista kaikkien linkkien toimivuutta. JavaScript-linkkejä, lomakkeita, mailto/tel-kohteita ja ulkoisia ankkureita ei todenneta.

Avustajasi täytyy tukea etä-MCP-yhteyttä ja OAuth-kirjautumista. Jos yhteyttä ei voi lisätä keskustelussa, avustaja auttaa ohjelman asetuksissa. Pelkkä ohjeen liittäminen ei vielä avaa pääsyä sivustoihisi.

Sivuston linkkien ja SEO:n pikatesti

Pikatestiohje avustajalle

Suositeltu pikatesti: aja kuura_analyze_site tallennetulle version_id:lle muutosten jälkeen ja ennen julkaisua. Tarkista kaikki sivut, sisäiset linkit, ankkurit, placeholderit ja SEO-perustiedot. Testi ei muokkaa tai julkaise eikä käytä AI-krediittejä. Julkaisun jälkeen aja kuura_check_links samalla version_id:llä ja check_http=true, jotta myös julkisten linkkien HTTP-tila tarkistetaan. Jatka next_after_link-arvolla after_link-kentässä samalla versiolla ja rajauksilla, kunnes next_after_link=null. Kokoa kaikkien erien tulokset ja kerro rikkinäiset sekä tarkistamatta jääneet linkit. skipped, unchecked tai scan_truncated eivät todista kaikkien linkkien toimivuutta. JavaScript-linkkejä, lomakkeita, mailto/tel-kohteita ja ulkoisia ankkureita ei todenneta.

Testaa olemassa oleva yhteys

Yhteystesti avustajalle

Testaa nykyinen Kuura-yhteys: kutsu kuura_account, kuura_list_sites ja lue kuura://guide. Raportoi jokainen erikseen. Näytä connection_id, scopes ja sivustorajaus sekä tehtävän sivusto. Tarkista muokkaukseen sites:write ja julkaisuun sites:publish. Jos oikeuksia ei ole hyväksytty, pyydä niiden hyväksyntä kerran. Jos ne on jo hyväksytty uudelle yhteydelle mutta kuura_account näyttää vanhaa yhteyttä, päivitä avustajan MCP-yhteys; tarvittaessa pyydä uudelleenkäynnistys ja anna tehtävän jatkoviesti. Pelkkä uudelleenkäynnistys ei myönnä oikeuksia. Jos lukutyökalut toimivat, kerro se. Älä toista kirjautumista tai katkaise yhteyttä kokeeksi. Älä pyydä tunnuksia keskusteluun.

Yhteyden tiedot ja ongelmatilanteet

Palvelimen osoite: https://app.kuura.app/mcp
Yhteystapa: Streamable HTTP. Kirjautuminen: OAuth selaimessa, dynaaminen asiakasrekisteröinti.

Hyväksy yhteys siinä selaimessa, joka avautuu automaattisesti. Yksi kirjautumisyritys ja yksi hyväksyntävälilehti riittävät. Ohjelman pyytämistä oikeuksista voit jättää tarpeettomat valitsematta Kuuran sivulla.

Jos vain lukeminen toimii, tarkista yhteyden oikeudet. Muokkaus tarvitsee sites:write ja julkaisu sites:publish. Mediakirjastoon lataus tarvitsee media:write. Jos hyväksyit jo uuden yhteyden mutta avustaja näyttää vanhaa yhteysnumeroa, päivitä avustajan MCP-yhteys. Uudelleenkäynnistystä tarvitaan vasta, jos uusi yhteys tai sen työkalut eivät muuten lataudu. Uudelleenkäynnistys ei itsessään myönnä oikeuksia.

Oikeuksien valintalomake avautuu avustajan käynnistämästä kirjautumisesta. Kuuran yhteysnäkymä näyttää jo annetut hyväksynnät. Sivuston tunniste #64 tarkoittaa yhtä sivustoa; sivustojen määrä näkyy erikseen.

Jos sivusto puuttuu tai oikeudet eivät riitä, yhdistä uudelleen ja hyväksy tarvitsemasi sivustot ja oikeudet. Uusien sivustojen luominen vaatii pääsyn myös tuleviin omiin sivustoihin. Yhteys on voimassa enintään 30 päivää.

Ohje ei sisällä salasanoja tai pääsytunnisteita. Oletuspakettiin kuuluvat myös valittujen sivustojen yhteydenottojen ja varausten henkilötiedot sekä koko henkilökohtainen mediakirjasto. Kaikki oikeudet näkyvät hyväksyntäsivulla, ja voit poistaa niitä. Yhteydet voi katkaista Kuuran hallinnassa.

Mitä voit tehdä Kuuran MCP-yhteydellä?

Useita sivustoja, sama avustaja

Valitse sivusto tai luo uusi. Muokkaa yksittäistä sivua, monisivuista kokonaisuutta tai yhteistä MVC-ulkoasua.

”Lisää yrityssivustolleni uusi palvelut-sivu.”

Lähdekoodi, kuvat ja versiot

Muokkaa HTML:ää, CSS:ää ja JavaScriptiä, tuo kuvia ja tallenna luonnoksia. Palauta tarvittaessa vanha versio uudeksi luonnokseksi.

”Vaihda etusivun otsikko ja säilytä muu ulkoasu.”

Sisällöt ja lisäosat

Luo uutisia ja blogitekstejä, muuta tuettuja lisäosa-asetuksia ja kalenterin viikoittaisia aukioloaikoja.

”Lisää uutinen ensi viikon tapahtumasta.”

Näyttökerrat ja julkaisu

Hae päiväkohtaiset näyttökerrat olemassa olevasta laskurista. Pyydä tarkistamasi version julkaisu ja seuraa sen valmistumista.

”Paljonko näyttökertoja oli tänään ja eilen?”

Sinä päätät oikeuksista

Yhdistäminen vaatii oman Kuura-tilin ja vahvistetun sähköpostiosoitteen. Valitset sivustot ja sen, saako avustaja vain lukea tietoja, muokata luonnoksia vai myös julkaista. Salasana kirjoitetaan Kuuran kirjautumissivulle, ei avustajan keskusteluun.

Yhteydenottojen ja varausten henkilötiedot sekä koko henkilökohtainen mediakirjasto tarvitsevat erilliset luvat. Laskutus, verkkotunnusten tilaaminen, DNS, koko sivuston pysyvä poistaminen ja asiakasviestien lähettäminen hoidetaan Kuuran omissa näkymissä.

Avaa yhteyksien hallinta

Myös julkaistu sisältö tukee avustajia

Kuuran hostingissa julkaistut, indeksoinnin sallivat sivut saavat Markdown-tekstiversiot, sisältöhakemiston ja löytölinkit. Avustajat voivat lukea julkista sisältöä ilman MCP-yhteyttä. Tämän sivun MCP-yhteys on erillinen tapa hallita omia sivustojasi hyväksymilläsi oikeuksilla.

Katso agent-ready-tuki ja julkaistun sivuston testitulokset

Usein kysyttyä MCP:stä

Voinko käyttää MCP:tä Hosting-paketilla?

Kyllä. Hosting maksaa 4,99 €/kk + alv 25,5 % (6,26 €/kk) ja sisältää oman domainin liittämisen. Se ei sisällä kuukausittaisia AI-krediittejä. Voit tehdä sivut aloituskrediiteillä tai omalla avustajallasi MCP:n kautta. MCP-lähdekoodimuokkaus ja julkaiseminen eivät kuluta Kuuran AI-krediittejä. Oman avustajan mahdolliset maksut määräytyvät sen palveluntarjoajan mukaan. Verkkotunnuksen rekisteröinti ja vuosimaksu eivät sisälly.

Pitääkö minun käyttää MCP:tä?

Ei. MCP on vapaaehtoinen lisätapa käyttää Kuuraa. Voit luoda, muokata ja julkaista sivustosi suoraan Kuuran selainnäkymissä ja käyttää Kuuran omia tekoälytoimintoja ilman ulkoisen avustajan yhdistämistä.

Tarvitaanko ohjeen lukemiseen kirjautuminen?

Ei. Tämä sivu ja kopioitava ohje ovat julkisia. Kirjautuminen ja vahvistettu sähköposti tarvitaan vasta, kun hyväksyt avustajan pääsyn omiin sivustoihisi.

Millainen avustaja toimii Kuuran kanssa?

Tarvitset avustajan, joka tukee etä-MCP-palvelimia (Streamable HTTP), OAuth-selainkirjautumista ja dynaamista asiakasrekisteröintiä. Kopioi yllä oleva ohje ohjelmaasi. Jos ohjelma ei voi lisätä yhteyttä itse, avustaja neuvoo oikeat asetukset. Tuki riippuu käyttämästäsi ohjelmasta.

Julkaiseeko avustaja muutokset heti?

Lähdekoodin tallennus tekee uuden luonnosversion. Julkaisu tehdään erillisellä toiminnolla ja se vaatii julkaisu-oikeuden. Pyydä avustajaa näyttämään muutos tarkistettavaksi ennen julkaisua. Dynaamisten lisäosien ja jo julkaistujen uutisten tai blogitekstien muutokset voivat näkyä heti.

Voinko rajata tai katkaista yhteyden?

Kyllä. Valitset hyväksynnässä omat sivustot ja oikeudet. Henkilötietojen ja koko mediakirjaston lukeminen tarvitsee erilliset luvat. Voit katkaista yhteyden Kuuran Tekoälyavustajat-sivulla. Jo jonossa olevat julkaisut voivat valmistua normaalisti.