Integraatiot (ulkoiset työkalut)

Ceum voi yhdistyä ulkoisiin työkaluihin – kuten Claude Desktop, Cursor tai omat agenttisi – jotta ne voivat lukea ja päivittää tietojasi puolestasi. Jokainen yhteys käyttää luomaasi MCP-tunnusta. Integraatiot-sivulla hallitset näitä tunnuksia ja pidät silmällä, mitä ne ovat tehneet.

Tämä sivu koskee ulkoisten työkalujen yhdistämistä tunnuksella. sovelluksen oma sovelluksen sisäinen avustaja Rocky ei tarvitse tunnusta – otat sen toiminnot käyttöön kohdassa Avustajan asetukset.

Tilillä olevien tunnusten määrä on tilausraja, ja se on nolla jokaisessa tilauksessa, johon MCP ei kuulu. Tällaisessa tilauksessa Integraatiot-sivu ei ole lainkaan käytettävissä, ja aiemmin luotu tunnus lakkaa tunnistautumasta, kun tilausmuutos pudottaa MCP:n pois – tunnusta ei poisteta, joten ylempään palaaminen saa sen toimimaan jälleen. Tilaus ja laskutus luettelee tunnusrajan jokaiselle tilaukselle.

Tunnusten hallinta

Sivu luettelee olemassa olevat tunnuksesi seuraavin tiedoin:

• Nimi – otsikkosi (esim. ”Claude Desktop”, ”Cursor-asetukseni”).
• Tunnuksen etuliite – muutama ensimmäinen merkki, jotta voit erottaa tunnukset toisistaan.
• Viimeksi käytetty – milloin tunnus teki viimeksi kutsun.
• Luotu – milloin loit sen.

Toiminnot:

• Uusi tunnus – valitse nimi, aseta sitten sen käyttöoikeudet ja laajuus (alla); koko tunnus näytetään kerran, jotta voit kopioida sen. Sitä ei voi hakea myöhemmin, joten kopioi se ennen kuin suljet valintaikkunan. Tunnuksen luominen lasketaan tilauksesi tunnusrajaan.
• Muokkaa – nimeä tunnus uudelleen tai vaihda sen käyttöoikeudet ja laajuus milloin tahansa. Itse tunnusmerkkijono ei koskaan muutu.
• Mitätöi – kytkee tunnuksen pois. Mitätöity tunnus ei voi enää yhdistyä, mutta sen aiempi toiminta säilytetään, jotta voit yhä tarkastella sitä.

Mitätöidyt tunnukset poistuvat luettelosta. Niiden aiempi toiminta säilyy tarkastuslokissa – sieltä näet, mitä tunnus ehti tehdä ennen kuin se kytkettiin pois.

Valitse rivien valintaruuduilla useita tunnuksia ja mitätöi ne kerralla. Katso Joukkomuokkaus.

Käyttöoikeudet ja laajuus

Kun luot tai muokkaat tunnusta, päätät sekä mitä se voi tehdä että mihin se voi sen tehdä. Myöntämällä työkalulle vain sen tarvitsemat oikeudet estät vuotanutta tai virheellisesti toimivaa tunnusta koskemasta muuhun työtilaasi.

Työkalukäyttöoikeudet

Käyttöoikeudet ovat yksittäisten työkalujen sallittujen luettelo, ryhmiteltynä alueittain (tehtävät, projektit, asiakkaat, dokumentit ja niin edelleen). Uusi tunnus alkaa kaikki myönnettyinä; poista valinta siitä, mitä työkalu ei tarvitse.

• Kaikki luku / Kaikki kirjoitus – kaksi kytkintä yläosassa kääntävät jokaisen vain luku -työkalun tai jokaisen tietoja muuttavan työkalun kerralla kaikilla alueilla.
• Luku / Kirjoitus (aluekohtaisesti) – sama jako, mutta rajattuna yhteen alueeseen.
• Yksittäiset työkalut voi aina valita yksitellen.

Tunnus voi kutsua vain niitä työkaluja, jotka sille myönnät; kaikki muu hylätään.

Resurssilaajuus

Laajuus rajaa tunnuksen tiettyihin asiakkaisiin ja/tai projekteihin. Oletuksena tunnuksella on Täysi käyttöoikeus – se voi toimia kaikkeen, mukaan lukien kohteet, joilla ei ole asiakasta tai projektia (esim. kohdistamattomat tehtävät). Kytke täysi käyttöoikeus pois rajataksesi sitä, jolloin kaksi itsenäistä ulottuvuutta tulee näkyviin:

• Asiakkaat – aseta arvoon Kaikki asiakkaat (ei rajattu) tai tarkkaan tiettyjen asiakkaiden sallittujen luetteloon.
• Projektit – aseta arvoon Kaikki projektit tai tarkkaan tiettyjen projektien sallittujen luetteloon.

Molemmat ovat tarkkoja sallittujen luetteloita: kun ulottuvuus on asetettu ”tiettyihin”, vain lisäämäsi on tavoitettavissa. Tietueen on täytettävä molemmat ulottuvuudet ollakseen laajuudessa – sen on siis kuuluttava sallittuun asiakkaaseen ja sallittuun projektiin (ulottuvuutta, joka on jätetty ”Kaikki”-tilaan, ei tarkisteta).

Tarkkaile päällekkäisyyttä. Koska molempien ulottuvuuksien on täsmättävä, asiakkaan ja projektin, jotka eivät mene päällekkäin, sallimien luetteloon laittaminen tarkoittaa, että mikään tietue ei täsmää lainkaan – tunnus ei näe mitään. Jos haluat rajata vain projektin mukaan, jätä Asiakkaat ”Kaikki”-tilaan (ja päinvastoin). Tietue, jolta puuttuu linkki rajatussa ulottuvuudessa (tehtävä ilman projektia, kun projektit on rajattu), on myös laajuuden ulkopuolella.

Kaikki laajuuden ulkopuolella oleva on näkymätöntä ja koskematonta: luettelot palauttavat vain laajuudessa olevat tietueet, ja laajuuden ulkopuolella olevaan tietueeseen ID:llä toimiminen palauttaa ”laajuuden ulkopuolella” -virheen. Rajattu tunnus voi luoda uuden projektin vain, kun sen Projektit-ulottuvuus on ”Kaikki”, ja uuden asiakkaan vain, kun sen Asiakkaat-ulottuvuus on ”Kaikki”.

Laajuutta valvotaan kaikkialla, missä tietue linkittyy asiakkaaseen tai projektiin: asiakkaat, projektit, tehtävät, dokumentit, tilitapahtumat, aikakirjaukset, tehtäväkommentit (niiden ylätehtävän kautta), suhteet (molemmat päätepisteet) sekä työtilan haku- ja kalenterisyötteet (jotka palauttavat vain laajuudessa olevat kohteet). Se kattaa myös itse linkittämisen – tehtävän liittäminen projektiin, projektin asiakkaaseen tai aikakirjauksen tehtävään edellyttää molempien, sekä tietueen että sen kohteen, olevan laajuudessa. Kohteet, joilla ei ole asiakas-/projektilinkkiä – kalenteritapahtumat, tilaukset ja työtilan laajuiset määritykset kuten tilat, tehtävätyypit ja tunnisteet – pysyvät käytettävissä laajuudesta riippumatta.

Ulkoisen työkalun yhdistäminen

Sivu näyttää yhden valmiin liitettävän määritysleikkeen, joka toimii Claude Codessa, Claude Desktopissa ja Cursorissa. Kopioi se, korvaa paikkamerkki tunnuksellasi ja lisää se työkalusi määritystiedostoon – leikkeen vieressä oleva infokuvake kertoo, missä tuo tiedosto kunkin työkalun kohdalla sijaitsee.

Toiminnan tarkastelu

Voit tarkastella jokaista yhdistetyllä työkalulla tehtyä kutsua – katso Istunnot ja MCP-tapahtumat. Se tallentaa tehdyn toiminnon, lukiko kutsu tietoja vai muuttiko se niitä, onnistuiko se vai evättiinkö se, mikä tunnus sen teki, kohteena olleen tietueen ja milloin – näin voit auditoida sekä sen, mitä työkalusi ovat muuttaneet, että sen, mitä ne ovat katsoneet. Myös oma sovelluksen sisäisen komentopaletin ja Rockyn käyttösi näkyy siellä omana tekijänään.

Työnkulut

Yhdistä Claude Desktop

1. Luo tunnus Integraatiot-sivulta ja nimeä se vaikkapa ”Claude Desktop”.
2. Kopioi koko tunnus, kun se on näkyvissä – tämä on ainoa mahdollisuutesi.
3. Liitä määritysleike Claude Desktopin määritykseen ja pudota tunnuksesi siihen.
4. Käynnistä Claude Desktop uudelleen. Tunnuksen Viimeksi käytetty päivittyy sen ensimmäisen kutsun jälkeen.

Auditoi epäilyttävä muutos

Avaa MCP-tapahtumat-sivu ja rajaa muutoksen tapahtumisen päivämääräväliin. Etsi toiminto, joka teki muutoksen, ja vertaa sitä sitten tietueen omaan historiaan (katso Entiteetin muutosloki) nähdäksesi koko tilan ennen ja jälkeen.

Vaihda tunnus

Luo ensin uusi tunnus, vaihda työkalusi käyttämään sitä ja varmista, että se toimii. Mitätöi sitten vanha. Mitätöi mikä tahansa tunnus, jonka epäilet voineen vuotaa.

Vinkkejä ja erikoistapauksia

• Tunnuksia ei voi näyttää uudelleen. Jos kadotat tunnuksen, luo uusi.
• Aiempi toiminta säilyy mitätöinnin jälkeen. Tunnuksen mitätöinti ei pyyhi sitä, mitä se teki – sen aiemmat toiminnot näkyvät edelleen sen vanhalla nimellä.
• Toiminta säilytetään niin kauan kuin tilisi on olemassa.
• Tehtävätilat ja -tyypit voi rajata projekteittain MCP:n yli. Tehtävätilan ja -tyypin luonti/päivitystyökalut hyväksyvät allProjects- ja scopedProjectIds-arvot, ja list_task_statuses palauttaa ne – joten yhdistetty työkalu voi sekä asettaa että lukea projektikohtaisen laajuuden. Tehtävälle sen projekteille laajuuden ulkopuolella olevan tilan tai tyypin kohdistaminen hylätään viestillä, joka nimeää rikkovan projektin.

Mobiilissa

Ei käytettävissä mobiilisovelluksessa – hallinnoi verkkosovelluksesta.