Johku Maxin kytket itse omaan AI-avustajaasi, kuten Claudeen tai ChatGPT:hen, osoitteella https://mcp.johku.com/mcp. Kun kytkentä on päällä, AI-avustaja hakee tietoja Johku-kaupastasi ja tekee siellä muutoksia pyynnöstäsi. Tilaus ja kytkentä eivät vaadi Johkun apua.
Kytkentä käyttää MCP-yhteyttä (Model Context Protocol), joka on avoin tapa liittää AI-avustajaan ulkoisia palveluita. Claude kutsuu kytkentää nimellä connector (liitin) ja ChatGPT nimellä plugin (liitännäinen).
Tämä on eri kytkentä kuin Johku Support -kytkentä, joka ei vaadi kirjautumista ja näkee vain julkiset ohjeet. Johku Max vaatii kirjautumisen, ja sen kautta AI-avustaja pääsee kauppasi omiin tietoihin ja toimintoihin. Mitä Maxilla voi tehdä, kerrotaan ohjeessa Mikä on Johku Max?
Ennen kuin aloitat
Johku: tarvitset Johkussa oikeustason Ylläpitäjä. Kytkentä tehdään ylläpitäjän tunnuksilla, ja AI-avustaja toimii samoilla tunnuksilla.
AI-avustaja: oma AI-avustajasi on oma tilauksesi, eikä se sisälly Johku Maxiin.
Claude: ilmaisella Free-tilillä voit lisätä yhden oman liittimen (custom connector). Team- ja Enterprise-tileillä organisaation omistaja lisää liittimen ensin.
ChatGPT: tilisi ja työtilasi käytännöt ratkaisevat, voitko lisätä oman MCP-palvelimen.
1. Tilaa Johku Max
Jos kaupassasi on jo Johku Max, siirry kohtaan 2 tai 3. Jos Johku Max -kohdassa näkyy painike Tilaa Johku Max, Max ei ole vielä käytössä.
Avaa Johkun hallinnassa Asetukset → Yritysprofiili.
Avaa välilehti Johku-kauppiastili ja etsi kohta Johku Max.
Valitse Laskutuskausi: Vuosittain tai 1 kk välein.
Jos tarvitset enemmän käyttäjiä kuin lisenssiin sisältyy, kirjoita määrä kenttään Lisäkäyttäjät. Voit lisätä käyttäjiä milloin tahansa kauden aikana.
Jos näet kohdan Maksutapa, valitse Lasku tai Korttimaksu.
Tarkista summa kohdasta Yhteensä ja valitse Tilaa Johku Max.
Tarkista avautuvan ikkunan summa ja valitse Tilaus.
Johku Max laskutetaan etukäteen. Vuosikausi laskutetaan heti 12 kuukaudelta. Kuukausikausi laskutetaan heti kuluvan kuukauden loppuosalta ja sen jälkeen jokaisen kuukauden ensimmäisenä päivänä. Hinnat ovat sivulla Johkun hinnoittelu.
2. Kytke Johku Max Claudeen
Avaa Claude selaimessa osoitteessa claude.ai tai Claude Desktop -sovelluksessa.
Valitse Customize ja sieltä Connectors.
Klikkaa + Add ja valitse Add custom connector.
Kirjoita nimeksi Johku Max ja osoitteeksi https://mcp.johku.com/mcp. Klikkaa Continue.
Jätä Clauden tunnistamat kirjautumisasetukset ennalleen ja klikkaa Continue.
Valitse kohdassa Authentication vaihtoehto Sign in now ja klikkaa Add. Claude avaa Johkun kirjautumisen. Jatka kohdasta 4.
Kirjautumisen jälkeen aloita uusi keskustelu. Klikkaa keskustelukentän vasemman alakulman +-painiketta, valitse Connectors ja varmista, että Johku Max on kytketty päälle.
3. Kytke Johku Max ChatGPT:hen
Avaa ChatGPT:n Plugins-sivu osoitteessa chatgpt.com/plugins.
Klikkaa +-painiketta ja valitse Add custom MCP server.
Kirjoita nimeksi Johku Max ja kuvaukseksi esimerkiksi Johku-kauppani hallinta.
Valitse kohdassa Connection vaihtoehto Public endpoint ja kirjoita osoitteeksi https://mcp.johku.com/mcp.
Valitse tunnistautumistavaksi OAuth.
Lue ChatGPT:n riskivaroitus ja valitse I understand and want to continue.
Valitse Create as a plugin ja tarkista, että ChatGPT löytää Johkun työkalut. Asenna liitännäinen. ChatGPT avaa tämän aikana Johkun kirjautumisen. Jatka kohdasta 4.
Kirjautumisen jälkeen aloita uusi keskustelu. Kirjoita keskustelukenttään @ ja valitse Johku Max.
4. Kirjaudu Johkuun
AI-avustaja avaa Johkun kirjautumissivun Sign in to Johku MCP. Sivut ovat englanniksi.
Kirjoita sen Johku-tilisi sähköpostiosoite, jolla kirjaudut Johkun hallintaan, ja valitse Send sign-in code.
Kirjoita sivulle koodi, jonka saat sähköpostiisi.
Tarkista sivulta Authorize access to Johku MCP, mitä AI-avustajalle sallitaan, ja valitse Allow.
Kirjautuminen ei anna pääsyä uusiin kauppoihin. AI-avustaja pääsee vain kauppoihin, joissa Johku-tililläsi on jo käyttäjä, ja sillä on samat oikeudet kuin sinulla.
5. Tarkista, että kytkentä toimii
Kopioi kaupan tunniste Johkun hallinnasta: Asetukset → Yritysprofiili, välilehti Johku-kauppiastili, kenttä Kaupan tunniste, painike Kopioi.
Kirjoita AI-avustajalle esimerkiksi: Kerro Johku Maxin kautta, montako tuotetta on Johku-kaupassa, jonka tunniste on omakauppa. Älä muuta mitään. Käytä oman kauppasi tunnistetta.
Vertaa vastausta Johkun hallinnan tuotelistaan.
Avaa uudelleen välilehti Johku-kauppiastili. Kohdan Johku Max listassa Käyttäjät näkyy nyt nimesi ja Viimeisin käyttökerta.
Lopputulos
Nyt Johku Max on kytketty AI-avustajaasi. Voit pyytää avustajaa hakemaan tietoja Johku-kaupastasi ja tekemään siellä muutoksia. Kytkentä pysyy voimassa, kunnes poistat sen.
Hyvä tietää
AI-avustaja voi muuttaa kauppasi tietoja. Se toimii ylläpitäjän tunnuksilla. Tarkista tärkeät muutokset Johkun hallinnasta. Kun AI-avustaja pyytää lupaa muutokseen, lue pyyntö ennen kuin hyväksyt sen.
Käyttäjät. Käyttäjä saa käyttöoikeuden, kun hän käyttää Johkun hallintatyökaluja AI-avustajalla ensimmäisen kerran, jos lisenssissä on tilaa. Lisää paikkoja saat kohdasta Muuta lisäkäyttäjien määrää.
Useampi kauppa. Sama kytkentä toimii kaikissa kaupoissa, joissa sinulla on käyttäjä ja joissa on Johku Max. Mainitse pyynnössä kaupan tunniste.
Asiakkaiden henkilötiedot. AI-avustaja hakee Johkusta sen, mitä pyydät, myös asiakastietoja. Sen jälkeen tietoa käsitellään AI-palvelun ehtojen mukaisesti. Tarkista AI-palvelun tietosuoja-asetukset ja kerro palvelusta kauppasi tietosuojaselosteessa.
Nimetty asiantuntija. Maxin käyttäjä saa nimetyn asiantuntijan, joka tuntee Johkun ja sinun kauppasi. Kytkentä ei vaadi hänen apuaan.
Näin poistat kytkennän
Claude: avaa Customize → Connectors ja poista Johku Max valitsemalla Remove tai liittimen kolmen pisteen valikko.
ChatGPT: avaa chatgpt.com/plugins, avaa Johku Max ja valitse Remove.
Käyttäjän paikka: jos haluat antaa paikan jollekulle toiselle, avaa Johkun hallinnassa välilehti Johku-kauppiastili ja valitse käyttäjän kohdalta Poista käyttäjä. Käyttäjä menettää käyttöoikeuden minuutin kuluessa. Jos hän käyttää hallintatyökaluja myöhemmin uudelleen, hän saa paikan takaisin, jos tilaa on.
Johku Max -tilaus: kytkennän poistaminen ei peru tilausta. Peru se samalla välilehdellä painikkeella Peru Johku Max. Max on käytössä maksetun kauden loppuun, eikä sitä uusita sen jälkeen. Voit kumota peruutuksen siihen asti.
Jos jokin ei toimi
Selain näyttää ilmoituksen "Method not allowed." Avasit osoitteen https://mcp.johku.com/mcp selaimessa. Tämä on normaalia, sillä osoite on tarkoitettu AI-avustajille eikä selaimelle. Liitä osoite AI-avustajan asetuksiin vaiheen 2 tai 3 mukaisesti.
Kytkentä ei muodostu. Tarkista, että osoite on täsmälleen https://mcp.johku.com/mcp: alussa https:// ja lopussa /mcp. Poista kytkentä ja lisää se uudelleen.
Claude ei anna lisätä liitintä. Clauden Team- ja Enterprise-tileillä organisaation omistaja lisää liittimen ensin kohdassa Organization settings → Connectors, ja sen jälkeen voit ottaa sen käyttöön. Free-tilillä voi olla vain yksi oma liitin, joten poista ensin aiempi oma liitin.
AI-avustaja kertoo, ettei kaupassa ole Johku Maxia. Johkun hallintatyökalut toimivat vain kaupoissa, joissa on Johku Max. Tilaa Max vaiheen 1 mukaisesti tai tarkista, että pyynnössä on oikea kaupan tunniste.
AI-avustaja kertoo, ettei tililläsi ole käyttäjää kaupassa. Olet kirjautunut sähköpostiosoitteella, jolla ei ole käyttäjää tässä kaupassa. Poista kytkentä ja lisää se uudelleen, ja kirjaudu sillä sähköpostiosoitteella, jolla kirjaudut kaupan Johkun hallintaan.
Käyttäjän kohdalla lukee "Ei käyttöoikeutta, käyttäjäraja ylittyy". Lisenssin kaikki paikat ovat käytössä. Poista joku käyttäjä tai lisää paikkoja kohdassa Muuta lisäkäyttäjien määrää.
Johku Max -kohdassa lukee "Johku Max on keskeytetty, koska viimeisin maksu on erääntynyt." Max palautuu käyttöön, kun maksu on saatu.
Vastaus ei ratkaise tilannetta. Katso Näin otat yhteyttä Johkun tukeen. Kerro tuelle kaupan tunniste, käyttämäsi AI-avustaja ja mitä se vastasi.