← Tagasi kõigi artiklite juurde

Ühenda Claude või ChatGPT oma broneeringutega — micali.online'il on nüüd MCP-server

#MCP #Claude #ChatGPT #AI #broneerimissüsteem #integratsioonid #automatiseerimine
Ühenda Claude või ChatGPT oma broneeringutega — micali.online'il on nüüd MCP-server

Avad Claude'i või ChatGPT, kirjutad „kes ei ole veel laupäeva kursuse eest maksnud?" — ja saad nimekirja nimede ja telefoninumbritega. Ei mingit sisselogimist rakendusse, ei klikkimist läbi sündmuste ja broneeringute. Täpselt seda micali.online nüüdsest võimaldab.

Selle taga on MCP — Model Context Protocol. See on avatud standard, mis lahendab ühe konkreetse asja: kuidas AI-assistent saab turvaliselt ligipääsu võõrale rakendusele. Mitte nii, et annad talle parooli, ega nii, et kopeerid kuhugi ekspordi. Vaid nii, et rakendus ise kuulutab välja loetelu asjadest, mida saab teha, ja assistent valib sealt — sinu sisselogimisega ja sinu õiguste piires.

micali.online'il on nüüdsest oma MCP-server. See artikkel räägib täpselt, mida ta teab, mida ta teadlikult ei tea, ja miks me selle nii üles ehitasime.

Kuidas ühendada

See on kolm sammu ja võtab alla minuti.

  • Kirjuta oma assistendile, et soovid ühendada MCP-serveri, ja saada talle aadress https://mcp.micali.online — terve, ilma millegita järel. Kuskil ei pea midagi klikkima ega seadetest otsima; piisab sellest, kui kirjutad selle. Aadressi leiad ka rakendusest kohast Profiil → AI-ühendused, koos kopeerimisnupuga.
  • Avaneb meie sisselogimisleht. Sisestad e-posti, saad 6-kohalise koodi ja kirjutad selle ümber. See on täpselt sama sisselogimine mis rakenduses — mitte mingit uut parooli, mitte mingit API-võtit, mida peaksid kuskil hoidma.
  • Valmis. Sellest hetkest näeb assistent su kontosid ja saad küsima hakata.

Selles protsessis ei teki kuskil saladust, mida peaksid valvama. See ongi mõte: vestlusesse kleebitud API-võti on võti, mis elab vestluse ajaloos igavesti.

Mida saab küsida, kui haldad kontot

Andsime assistendile kaksteist tööriista. Need ei ole käsklused, mida peaksid õppima — assistent valib nende hulgast ise, lähtudes sellest, mida sa tavalises lauses küsid. Aga on aus kirja panna, mis sellel loetelul on, sest see on täpne piirjoon sellest, mida AI saab su konto kohta teada:

  • Sündmused ja ajad — nimekiri sündmustest koos infoga, kui täis mis ajad on, ning ühe sündmuse kogu seadistus: mahutavus, tähtajad, maksed, kinnitamine.
  • Broneeringud — kes on millisele ajale kirjas, koos kontaktandmete ja olekuga kinnitatud / makstud / oli kohal. Saab piirata ühe kuupäevaga või ainult maksmata või kinnitamata broneeringutega.
  • Ootenimekiri — kes ootab vabanevat kohta, kõige kauem oodanust alates.
  • Külastajad — otsing nime, e-posti või telefoni järgi ning seejärel ühe inimese profiil koos tema liikmesuste ja viimaste broneeringutega.
  • Ettemaksupaketid — mida sa müüd, mis hinnaga, millise piiranguga ja mitu inimest seda hetkel kasutab.
  • Teenused ja tellimused — milliseid teenuseid pakud ja kellel on nendele antud perioodil aeg broneeritud.
  • Broneeringu oleku muutmine — kinnitatud, makstud, oli kohal.
  • Broneeringu tühistamine kliendi eest.

Kümme neist kaheteistkümnest tööriistast ainult loevad. Muuta saab kahte asja: broneeringu olekut ja selle tühistamist. See ei ole juhus — sellest räägib kogu järgmine peatükk.

Praktilisemalt öeldes on need küsimused nagu: „mitu vaba kohta on järgmisel nädalal?", „kas Tammel on pakendil veel kordi järel?", „kes reede kursuselt eelmine kord ei tulnud?", „märgi Peetri laupäev makstuks". Assistent leiab ise õige konto, sündmuse ja broneeringu; sina ei pea neid identifikaatoritega nimetama.

Mida saab küsida, kui oled klient

MCP-serveril on ka teine pool. Kui oled külastaja — ehk inimene, kes broneerib kellegi juures —, ühendud täpselt samamoodi ja saad enda jaoks viis tööriista:

  • nimekirja organisatsioonidest, kus oled registreeritud,
  • enda broneeringud — nii sündmused kui tellitud teenused, vaikimisi ainult tulevased,
  • enda liikmesused koos infoga, mitu korda oled kasutanud ja mitu jäänud,
  • otsingu aegade järgi, mida saad broneerida, koos vabade kohtade arvuga,
  • enda broneeringu tühistamise — arvestades tähtaega, mille korraldaja on seadnud.

„Mis mul järgmisel nädalal on?" või „mitu korda mul veel jäänud on?" on küsimus, mille jaoks ei peaks keegi pidama veebilehte avama.

Mida assistent teadlikult ei tea

See on osa, mida peame funktsioonide loetelust olulisemaks. AI-le kliendiandmetele ligipääsu andmine on otsus, millel peavad olema selged piirid — ja need saab ka selgitada.

Assistent ei näe kunagi rohkem kui sina. Sisselogimistoken ütleb ainult, kes sa oled; see ei ütle midagi selle kohta, mida sul on õigus näha. Seetõttu kontrollib iga tööriist iga üksiku kutse juures uuesti, et sa tegelikult haldad seda kontot. Ei ole olemas midagi sellist nagu „parasjagu avatud konto", millele saaks toetuda — ja seega ka mitte võimalust küsimisega libiseda võõrasse kontosse.

Meeskonnaliikmed on praegu välja lülitatud. Kui kellelgi on su kontol meeskonnaliikme roll, näeb ta rakenduses ainult neid sündmusi ja teenuseid, mille oled talle määranud. See piirang tuleks programmeerida eraldi iga tööriista sisse — ja piisab, kui see ununeb ühes ainsas andmebaasipäringus, et talle näidataks võõrast registreerunute nimekirja. Kuni see pole tööriistadesse loomulikult sisse ehitatud, saab ta ühendamisel selge veateate, mitte poolikut ligipääsu. Parem väljas kui peaaegu õige.

Pöördumatud tegevused on märgitud pöördumatuks. MCP protokoll lubab igal tööriistal kuulutada, kas see ainult loeb, kas selle mõju saab tagasi võtta ja kas see on hävitav. Broneeringu tühistamine on märgitud hävitavaks — sellega kustutame rea, saadame kliendile teate ja pakume vabanenud koha kohe ootenimekirja esimesele. Nii Claude kui ChatGPT küsivad tänu sellele märgistusele enne täitmist. Lisaks on otse tööriista kirjelduses juhis, et assistent peab sulle esmalt ette lugema kliendi nime ja sündmuse kuupäeva ning ootama selgesõnalist kinnitust.

Me ei näe su vestlusi. Assistent töötab sinu enda Claude'i või ChatGPT tellimusel ja räägib sinuga otse. Meie näeme oma poolel ainult üksikuid tööriistakutseid, mis meieni jõuavad — ehk sama, mida näeksime, kui sa klikiksid rakenduses. Su küsimuste ega vastuste tekst meieni kunagi ei jõua.

Sisselogimine ja lahtiühendamine

Ligipääs, mida ei saa ühe nupuga tühistada, ei ole korralik ligipääs. Rakendusest leiad kohast Profiil jaotise AI-ühendused: nimekirja kõigist ühendatud assistentidest koos ühendamise ja viimase kasutamise kuupäevaga ning iga juures nupu Ühenda lahti.

Lahtiühendamine toimub koheselt ja puudutab ainult seda üht ühendust — su sisselogimine brauseris ja teised ühendused jäävad puutumata. Sama jaotis on olemas ka külastajatele nende profiilis.

Ligipääsutoken kehtib viis tundi ja assistent uuendab seda automaatselt; uuendamisel on 90-päevane lagi. Isegi kui unustaksid ühenduse täielikult, kaob see seega iseenesest aja jooksul.

Neile, keda huvitab tehniline pool

Server räägib Streamable HTTP-d ja toetab nii protokolli versiooni 2025-06-18 kui ka 2025-03-26. Autoriseerimine on OAuth 2.1 koos PKCE-ga (meetod S256; plain-t me üldse ei aktsepteeri) ning dünaamilise kliendi registreerimisega vastavalt RFC 7591-le — just seetõttu piisab aadressi kleepimisest ilma, et peaksid kuskil midagi eelnevalt looma. Discovery-dokumendid asuvad seal, kust kliendid neid otsivad: /.well-known/oauth-protected-resource ja /.well-known/oauth-authorization-server. Tokeni tühistamine käib revoke-i kaudu vastavalt RFC 7009-le.

See tähendab, et ei ühendu ainult Claude ja ChatGPT, vaid kõik, mis räägib MCP-d — Claude Code, Codex, Cursor ja teised tööriistad, mis vahepeal lisanduvad. Ühtegi neist ei pea me eraldi toetama; selles ongi standardi mõte.

Kui palju see maksab

Mitte midagi. MCP-server on osa micali.online'ist kõigile kontodele ja sellel ei ole omaette hinnakirja. AI töötab sinu enda Anthropicu või OpenAI tellimusel, seega ei teki meie poolel mudelikulu — ja seega ka põhjust selle eest sinult raha küsida.

Kui soovid AI-d otse rakenduses, on see juba ka olemas: Küsi AI-lt tunneb rakendust ja su kontot ning sõnumite tekstide genereerimine aitab sul kirjutada e-kirja või SMS-i. MCP on midagi muud — see on nende hetkede jaoks, kui oled juba mingis assistendis ega taha ümber lülituda.

Kuidas alustada

Kopeeri aadress https://mcp.micali.online kohast Profiil → AI-ühendused, kirjuta oma assistendile, et soovid ühendada selle MCP-serveri, ja logi sisse e-postiga ja koodiga. Esimene küsimus, mida soovitame proovida, on igav ja ütleb palju: „mis mul sel nädalal kalendris on ja kes veel maksnud ei ole?"

Kui tööriistade loetelust jääb sul puudu midagi, mida oma assistendilt ootaksid, kirjuta meile. Uue tööriista lisamine on meile lihtne — raske on otsustada, millised neist tohivad midagi muuta. Selle otsuse tegemisel aitab su kogemus meid rohkem kui meie oma hinnang.

Proovi micali.online