Ühenda Uku Claude'iga (AI-assistent, MCP)

Claude’i ühendamine Ukuga lubab sul küsida AI-assistendilt oma klientide, ülesannete ja tundide kohta tavakeeles. Samuti saab ta sinu eest aega mõõta või ülesandeid luua.

Iga aktiivne kasutaja ettevõttes, mis on Elite paketil, saab oma konto Claude’ist sisse logides ühendada. Sisselogimise tee ei nõua Ukus mingit eriõigust.

Ühendus on isiklik. Ühendus tegutseb sisseloginud inimesena ja kannab täpselt tema ligipääsu. Kolleegile ei saa Claude’i ühendust seadistada, seega ühendab igaüks enda oma.

Vahekaarti Avalik API näevad ainult Ettevõtte omanikud ja Ettevõtte peakasutajad. Ainult nemad saavad luua assistendi võtme, mida vajab brauserita tee. Ettevõtte kasutajad ei näe API võtmeid üldse.

Ukust ei ole vaja midagi peale sinu tavalise konto. Terve seadistus käib Claude’is.

1. Ava Claude’is Customize → Connectors. Klõpsa Add custom connector.
2. Kleebi aadressiks https://app.getuku.com/mcp, pane nimeks Uku ja klõpsa Add.
3. Jäta Advanced settings puutumata. Sealsed OAuth-i kliendi väljad on valikulised ja Uku registreerib sinu Claude’i rakenduse ise.
4. Klõpsa Connect. Avaneb brauseriaken Uku ekraaniga Kas ühendada Ukuga?, kus on küsiva rakenduse nimi. Ekraanil on rida „It can see and do only what you can.“
5. Logi Ukusse sisse, kui sa juba sisse logitud ei ole, ja vali ettevõte.
6. Klõpsa Luba. Claude näeb nüüd Ukut igas vestluses.

Claude’i Team või Enterprise paketil lisab organisatsiooni omanik ühenduse korra jaotises Organization settings → Connectors. Seejärel logib iga kasutaja ise sisse.

Uku loob ühenduse jaoks taustal isikliku võtme. See kehtib 24 tundi ja uuendab end ise, kuni ühendus on lubatud. Võti ilmub vahekaardi Avalik API võtmete loendisse ja selle kustutamine lõpetab ühenduse kohe.

Sisselogimine on soovitatav tee ka Claude Code’is ja ükski võti ei liigu käest kätte.

1. Käivita claude mcp add --transport http uku https://app.getuku.com/mcp.
2. Kirjuta Claude Code’is /mcp, vali uku ja seejärel Authenticate.
3. Avaneb brauser. Logi Ukusse sisse ja klõpsa Luba.

Käsk claude mcp list näitab, kas uku on ühendatud. Käsk claude mcp remove uku võtab ühenduse maha.

Serveris, konteineris või muul brauserita masinal ei ole kedagi, kes klõpsaks Luba. Kasuta selle asemel assistendi võtit, Claude Code’i enda failis .mcp.json.

Tee: Seaded & Äpid → Avalik API → Avalik API

1. Ava Seaded & Äpid ja mine jaotisse Avalik API. Dialoog avaneb vahekaardil Avalik API (kõrval on Ülevaade ja (vana) API).
2. Sammus Kopeeri oma ettevõtte UUID klõpsa Kopeeri. See väärtus on sinu päis X-Uku-Company.
3. Keri paneelini Ühenda AI-assistent (Claude) ja ava plokk Developer setup (Claude Code and other clients that take headers).
4. Klõpsa Loo assistendi võti ja seejärel Kopeeri seadistus. Plokis on juba mõlemad väärtused.
5. Pane plokk faili .mcp.json.

{
  "mcpServers": {
    "uku": {
      "type": "http",
      "url": "https://app.getuku.com/mcp",
      "headers": {
        "X-Uku-Company": "SINU_ETTEVÕTTE_UUID",
        "X-API-Key": "SINU_ASSISTENDI_VÕTI"
      }
    }
  }
}

Aadress, mille ühendad, otsustab, kui palju Ukust assistent näeb. https://app.getuku.com/mcp on terve assistent: kõik tegevused ühes ühenduses. Enamik büroosid tahabki just seda ja võib siit edasi lugemise lõpetada.

Uku pakub ka nelja kitsamat aadressi. Igaüks neist kannab assistendi ühte osa ja sa ühendad neid nii palju, kui vaja:

Ühenda /mcp/core koos nendega, mida veel valid. See kannab jagatud tegevusi, millele ülejäänud toetuvad, seega on ühendus ilma selleta palju nõrgem. Lisa iga aadress eraldi kohandatud ühendusena ja logi igasse sisse. Claude Code’is käivita claude mcp add uuesti teise nimega, näiteks uku-work.

Claude ulatub kõige rohkem sinna, kuhu sinu enda Uku konto — ja mõnes kohas vähem. Finantsandmed on ainus asi, mida isiklik ühendus vaikimisi ei kanna. Sisselogimislehe märkeruut on ainus viis neid lisada.

Enamik muudatusi näitab eelvaadet ja ootab sinu nõusolekut. Lühike nimekiri toimub kohe esimese palve peale: aja mõõtmine, ülesande loomine, faili üleslaadimine ja tulemusnäitajate värskendamine. AI-assistendi võimalused katab mõlemad nimekirjad täies mahus ja ka piirid, kuhu assistent meelega ei ulatu. Sinu andmed ja AI-assistendid katab, mis liigub sinu AI-teenusepakkujani ja mida Uku salvestab.

Iga ühendus on juurdepääs sinu enda Uku vaatele. Eemalda see kohe, kui seda enam vaja ei ole.

• Eemalda sisselogitud ühendus Claude’is, võttes ühenduse maha. Samuti saad kustutada selle rea vahekaardi Avalik API võtmete loendist. Rea kustutamine lõpetab ühenduse kohe, isegi kui Claude näitab seda veel ühendatuna.
• Iga rida näitab oma võtme algust, näiteks uku_live_xxx…, seega saad rea õige ühendusega kokku viia. Rea lõpus olev abiikoon näitab viimast kasutust, IP-lubaloendit ja loomise aega.
• Sisselogitud ühendus uuendab ise oma 24-tunnist võtit, kuni ühendus on lubatud. Käsitsi loodud assistendi võti ei aegu kunagi.
• Deaktiveeritud kasutaja ühendus lakkab töötamast. Uku kontrollib igal päringul, kas omanik on veel ettevõtte aktiivne kasutaja.
• Paketi alandamine viib ühenduse maha. Paketti kontrollitakse igal päringul. Vii büroo Elite paketilt ära ja töötav Claude’i ühendus läheb kohe pimedaks.
• Uku salvestab, mida assistent tegi — millist tegevust kutsuti, millal ning millise inimese ja võtmega. Salvestatakse edastatud väärtuste nimed ja tüübid, mitte väärtused ise.

• Pärast aadressi kleepimist ei juhtu midagi. Sinu Claude’i pakett ei pruugi kohandatud ühendusi sisaldada. Team või Enterprise paketil ei ole organisatsiooni omanik Ukut veel lisanud.
• Sisselogimine õnnestub, aga Claude ei saa Ukut kutsuda. Ühenduse rida on Ukus kustutatud. Eemalda ühendus Claude’is ja lisa uuesti.
• Nõusolekuekraan keeldub. Sinu büroo ei ole Elite paketil.
• Ühendus töötas varem, nüüd on surnud. Sinu Uku kasutaja on deaktiveeritud või ühendus eemaldati Claude’is. Lisa uuesti ja logi sisse.
• Finantsnumbrid puuduvad. Finantsandmete ruut jäi märkimata või sul ei ole konto haldamise õigust. Ühenduse peab looma keegi, kellel see õigus on.

Sisselogitud ühendus kutsub Ukut Anthropicu enda serveritest, mitte arvutist, mille taga sa istud. Uku aadress peab seetõttu olema avalikust internetist kättesaadav. Tulemüüri reegel, ainult VPN-i kaudu ligipääs või sissetulevate aadresside filter blokeerib ühenduse, kuigi Uku töötab sinu brauseris edasi. Claude Code on teistsugune, sest see kutsub sinu enda masinast.

Käivita Claude uuesti. Claude Code’is käivita claude mcp list ja kontrolli, kas uku on ühendatud.

Kui osa tegevusi pakutakse ja osa mitte, oled tõenäoliselt ühendanud kitsama aadressi. Kontrolli seadistatud aadressi ülaloleva tabeli järgi.

Assistendi võti on kustutatud või üks kahest väärtusest on vale. Ava vahekaart Avalik API ja kontrolli, kas rida AI-assistent (Claude) on veel loendis. Loo uus võti, kopeeri uuesti ka ettevõtte UUID ja asenda mõlemad väärtused. Ainult võtme asendamine jätab alles vale ettevõtte tunnuse, mis kukub samamoodi läbi.

Tõrge 403 koos paketti puudutava teatega tähendab, et büroo ei ole enam Elite paketil.

Võti käib faili, mitte kunagi vestlusse. Kui kleepisid selle vestlusse, on võti nüüd selle vestluse sees alles. Kustuta selle rida vahekaardi Avalik API võtmete loendist ja loo uus.

Paneel Ühenda AI-assistent (Claude) on nähtav igal paketil, aga näitab seadistussamme ainult Elite paketil. Oma paketi vaatamiseks mine Seaded & Äpid → Ettevõte → Ülevaade. Uku paketid katab, mida iga pakett sisaldab.

Sisselogimiseks Claude’ist ei ole seda vahekaarti vaja. Vahekaart ilmub ainult Ettevõtte omanikele ja Ettevõtte peakasutajatele ning vajab, et Avalik API äpp oleks ettevõttele Elite paketil aktiveeritud.

Uku Claude’i ei paku. Sa ühendad Claude’i rakenduse, mida juba kasutad, ja ühenduse Uku-poolne osa tuleb Elite paketiga. Kas sinu Claude’i konto saab kohandatud ühenduse lisada, otsustab Anthropic.