Koko-liitin

Päivitetty viimeksi: 13. elokuuta 2026

Koko yhdistyy Claudeen ja ChatGPT:hen sovelluksena, joten keskustelussa suunnittelemasi matka voidaan tallentaa Koko-tilillesi, avata kartalla, jakaa matkakumppaneille ja muokata myöhemmin samasta keskustelusta. Tämä sivu käy läpi käyttöönoton, sen mitä kukin työkalu tekee, mihin avustaja yltää ja mihin ei, sekä rajat.

Käyttöönotto

Tarvitset ilmaisen Koko-tilin. Luo tili ensin osoitteessa kokotravel.ai tai yhdistämisen aikana.

Palvelimen tiedot

MCP-päätepiste: https://kokotravel.ai/mcp
Siirtotapa: streamable HTTP (tilaton JSON-RPC)
Tunnistautuminen: OAuth 2.1, PKCE ja dynaaminen asiakasrekisteröinti. Liitettävää client ID:tä tai API-avainta ei ole.

Claudessa

Avaa Settings → Connectors ja lisää Koko joko hakemistosta tai mukautettuna liittimenä yllä olevalla päätepisteellä.
Klikkaa Connect. Koko-sovelluksen kirjautumissivu aukeaa.
Kirjaudu sisään Googlella, sähköpostilla ja kuusinumeroisella koodilla tai Koko-käyttäjänimelläsi ja salasanallasi. Myönnä sitten käyttöoikeus.

ChatGPT:ssä

Lisää Koko sovellushakemistosta tai liittimenä yllä olevalla päätepisteellä.
Klikkaa Yhdistä ja kirjaudu Koko-tilillesi samalla tavalla.

Claude Codessa tai muussa MCP-asiakkaassa

claude mcp add --transport http koko https://kokotravel.ai/mcp

Aja sitten /mcp ja viimeistele kirjautuminen selaimessa.

Mitä liitin osaa

Kuusi työkalua, kaikki rajattuina siihen tiliin, jolla kirjauduit sisään. Lukutyökalut voivat toimia ilman erillistä kysymystä joka kerta; kirjoitustyökalut muuttavat tallennettua sisältöäsi, ja update_koko korvaa listan kokonaan, joten Claude kysyy ennen sen ajamista.

send_to_koko Tallenna lista tai suunnitelma Koko-sovellukseen Kirjoitus

Luo tilillesi uuden listan tai suunnitelman keskustelussa kuvatuista paikoista. Pelkistä paikoista tulee lista; kellonaikoineen päiviin ryhmitellyistä paikoista tulee suunnitelma. Koko geokoodaa jokaisen paikan ja täydentää sitten taustalla arvosanat, aukioloajat ja kuvat. Palauttaa katselulinkin heti.

my_koko Omat listat & suunnitelmat Vain luku

Listaa sen, mitä tililläsi jo on: otsikko, tyyppi, paikkojen määrä ja id. Mitään muuta tililtäsi ei paljasteta.

get_koko Avaa lista tai suunnitelma muokattavaksi Vain luku

Palauttaa yhden listan tai suunnitelman muokattavana rakenteena, jotta avustaja voi muuttaa sitä ja työntää uuden version takaisin.

check_koko_status Tarkista rakentamisen eteneminen Vain luku

Kertoo, kuinka pitkällä rakentaminen on: vastaanotettu, paikannetaan, rikastetaan, valmis. Hyödyllinen heti tallennuksen jälkeen, koska sijainnit ilmestyvät ensin ja kuvat vasta perässä.

update_koko Päivitä lista tai suunnitelma Täysi korvaus

Korvaa olemassa olevan listan tai suunnitelman sisällön uudella versiolla. Kaikki, mikä korvaavasta versiosta puuttuu, poistetaan – siksi tämä lasketaan tuhoavaksi ja kysyy sinulta ensin. Id ja jakolinkki pysyvät samoina, joten kaikki, joiden kanssa jo jaoit sen, näkevät päivityksen.

refresh_details Päivitä arvosanat & kuvat Kirjoitus

Hakee olemassa olevalle listalle uudelleen arvosanat, arvostelut, aukioloajat ja kuvat. Tämä maksaa Koko-sovellukselle rahaa jokaisesta paikasta, joten se arvioi kustannuksen ensin ja kuluttaa vasta kun vahvistat.

Kumppanityökalut (sertifioidut tekijät)

Kahdeksan lisätyökalua aukeaa sertifioiduille tekijöille eli kumppaniohjelman jäsenille, jotka julkaisevat Löydä-osiossa. Muilla tileillä ne vastaavat “ei sertifioitu tekijä” eivätkä muuta mitään. Jokainen niistä on rajattu omaan kauppapaikkaasi.

creator_profile Oma tekijäprofiili Vain luku

Lukee kauppapaikkasi profiilin: nimi, merkit, iskulause, esittely, sijainti, linkit, sosiaaliset kanavat, oletushinta ja se, näytkö Löydä-osiossa.

update_creator_profile Päivitä oma tekijäprofiili Kirjoitus

Muuttaa samoja kenttiä. Lähetä vain se, minkä pitää muuttua; merkit korvataan yhtenä kokonaisuutena. Käyttäjätunnusta ei voi koskaan vaihtaa, koska se on julkinen URL-osoitteesi.

my_listings Omat listaukset Vain luku

Kaikki omistamasi listat ja suunnitelmat sekä tieto siitä, onko listaus Löydä-osiossa, sen hintataso, jakolinkki, 30 päivän katselut sekä kaikkien aikojen ostot ja tuotot.

set_listing Julkaise Löydä-osioon / poista sieltä Kirjoitus

Nostaa yhden listasi tai suunnitelmasi julkiselle Löydä-hyllylle vakiohinnastosta valitulla hinnalla (Ilmainen, $1, $2, $5, $10) tai ottaa sen pois. Pois ottaminen tyhjentää aina hinnan.

creator_stats Tekijän tilastot Vain luku

Katselut, yksilöidyt katsojat, ostot ja tuotot 7, 30 tai 90 päivän ajalta, kauppapaikasta kokonaisuutena tai yhdestä listauksesta, summina ja päiväkohtaisena sarjana.

create_coupons Luo kuponkikoodeja Kirjoitus

Luo koodeja maksulliselle listaukselle: yhden koodin tai viisikymmentä, kertakäyttöisiä tai yhden koodin monella käyttökerralla. Kuponki määrittää alemman hintatason, jonka ostaja maksaa (oletuksena ilmainen), ei koskaan prosenttia.

coupons Listauksen kupongit Vain luku

Kaikki yhden listauksesi koodit, voimassa olevat ja poistetut, sekä tieto siitä, kuinka monta kertaa ja kuka niitä käytti.

disable_coupon Poista kuponki käytöstä Kirjoitus

Estää koodin lunastamisen. Sen historia säilyy.

Esimerkkikehotteet

“Tee minulle lista kolmesta kuuluisasta ramen-paikasta Shibuyassa, Tokiossa: Ichiran Shibuya, Nagi Golden Gai ja Hakata Ippudo Shibuya. Tallenna se Koko-sovellukseen nimellä ‘Shibuya Ramen’.”

Käyttää työkalua send_to_koko. Saat katselulinkin takaisin.

“Suunnittele yksi päivä Asakusassa, Tokiossa: Senso-ji klo 09:00, lounas Daikokuya Tempurassa klo 12:00, Tokyo Skytree klo 14:00. Tallenna se Koko-sovellukseen nimellä ‘Asakusa Day’.”

Käyttää työkalua send_to_koko ja tallentaa suunnitelman listan sijaan, koska kohteilla on kellonajat.

“Mitä minulla on tallennettuna Koko-sovelluksessa?”

Käyttää työkalua my_koko.

“Onko Shibuya Ramen -listani jo valmis?”

Käyttää työkalua check_koko_status.

“Poista Shibuya Ramen -listaltani Hakata Ippudo ja lisää tilalle Afuri Ebisu.”

Käyttää ensin työkalua get_koko ja sitten update_koko. Sama linkki, päivitetty sisältö.

Mihin avustaja yltää ja mihin ei

Voi: luoda, lukea ja päivittää listoja ja suunnitelmia siinä Koko-tilissä, jolla kirjauduit sisään.
Ei voi: nähdä kenenkään toisen käyttäjän sisältöä, poistaa tiliäsi, muuttaa kirjautumistietojasi tai julkistaa mitään. Julkaiseminen Koko-sovelluksen julkiselle Löydä-hyllylle on rajattu Koko-sovelluksen omille ylläpitotileille; tavallisella tilillä pyyntö tallennetaan sen sijaan yksityisesti, ja vastaus kertoo sen sinulle.
Tallennettavan sisällön yksityisyys: liittimen kautta luodut listat ja suunnitelmat ovat yksityisiä. Katselulinkki avautuu vain sinulle, kun olet kirjautuneena Koko-verkkosovellukseen. Jakaminen on erillinen, tietoinen askel, jonka teet sovelluksessa.
Mitä Koko saa: vain ne pyynnöt, jotka avustaja tekee puolestasi, esimerkiksi listan tallennettavista paikannimistä. Keskustelusi jää avustajan palveluntarjoajalle. Kaikki yksityiskohdat tietosuojakäytännössä.

Rajat

Työkalukutsut on rajattu noin 30 kutsuun minuutissa käyttäjää kohden. Sen ylittyessä saat vastauksen 429 ja otsakkeen Retry-After.
Tallennukset rakennetaan taustalla ja ne jonottavat kuormituksessa. Isolla suunnitelmalla kestää noin minuutin, ennen kuin kuvat ja arvosanat ovat kaikki paikoillaan.
Liitin on ilmainen, eikä mikään sen tekemä voi kuluttaa rahaa. Koko-sovelluksen ydin on niin ikään ilmainen; osa tekijöistä myy listojaan sovelluksen Löydä-hyllyllä App Store -ostoina, mutta maksutiedot eivät kummassakaan tapauksessa päädy Koko-sovellukseen. Tavallisten tilien rajat ovat käyttöehdoissa.
Koko on pienen tiimin rakentama varhaisen vaiheen esiversio. Paikkojen tiedot tulevat kolmansilta osapuolilta ja voivat olla vanhentuneita; tarkista tärkeät asiat ennen kuin lähdet niiden takia matkaan.

Yhteyden katkaiseminen

Katkaise Koko-yhteys avustajasi omista liitinasetuksista. Se peruu käyttöoikeustokenin heti, ja Koko lakkaa hyväksymästä puolestasi tehtyjä pyyntöjä. Listasi ja suunnitelmasi jäävät Koko-tilillesi. Jos haluat poistaa myös ne, poista tilisi UKK:n tilinpoisto-osiosta.

Tuki

Ihminen lukee jokaisen viestin. Laita sähköpostia osoitteeseen [email protected] ja kerro, mitä pyysit avustajalta ja mitä sait takaisin. Katso myös UKK, tietosuojakäytäntö ja käyttöehdot.