Strežnik MCP

kubehz poganja oddaljeni strežnik Model Context Protocol (MCP). Aplikacija UI, kot sta Claude ali ChatGPT, lahko z njim dela s tvojimi gručami in prostori:

https://mcp.kubehz.cloud/mcp

Vsak klic orodja gre prek API-ja kubehz, z istimi preverjanji kot nadzorna plošča. Aplikacija nikoli ne more narediti več kot oseba ali ključ za agenta, za katerega deluje.

Povežeš se lahko na dva načina:

• V svojem imenu. Aplikacija te prijavi, ti pa jo enkrat dovoliš. Nato aplikacija deluje v tvojem imenu, v okviru dovoljenj, ki si jih dovolil.
• S ključem za agenta. Nobena oseba se ne prijavi. Orodja delujejo v okviru vloge, dosega in omejitve porabe ključa.

Vklopi aplikacije UI

Aplikacije UI so privzeto izklopljene. Dokler so izklopljene, nobena aplikacija ne more delovati za člana najemnika. Ključi za agente niso odvisni od te nastavitve.

Potrebuješ vlogo Owner ali Admin.

1. Na nadzorni plošči odpri Nastavitve → Aplikacije UI.
2. Vklopi Dovoli aplikacije UI (MCP).
3. Potrdi s svojim drugim faktorjem.

Za izklop drugi faktor ni potreben. Vse povezane aplikacije se nato takoj ustavijo, za vse člane. Aplikacije ostanejo na seznamih. Ko lastnik ali skrbnik aplikacije UI znova vklopi, aplikacije spet delujejo.

Poveži aplikacijo v svojem imenu

kubehz sprejme te aplikacije:

• Claude na claude.ai ali claude.com.
• ChatGPT na chatgpt.com.
• Aplikacijo na tvojem računalniku, ki prijavo sprejme na naslovu loopback, na primer Claude Code, Claude Desktop ali IDE.

Druge gostovane aplikacije kubehz zavrne.

Claude

1. V Claudu dodaj konektor po meri.
2. Kot URL prilepi https://mcp.kubehz.cloud/mcp.
3. Poveži konektor.
4. Prijavi se v kubehz.

ChatGPT

1. V ChatGPT ustvari konektor.
2. Kot URL prilepi https://mcp.kubehz.cloud/mcp.
3. Kot preverjanje pristnosti izberi OAuth.
4. Poveži konektor.
5. Prijavi se v kubehz.

Claude Code in druge lokalne aplikacije

claude mcp add --transport http kubehz https://mcp.kubehz.cloud/mcp

Druga lokalna aplikacija potrebuje samo URL, če podpira oddaljene strežnike MCP z OAuth.

Prvič se aplikacija registrira pri id.kubehz.cloud in odpre stran za prijavo v kubehz. Po prijavi kubehz pokaže stran Dovolite tej aplikaciji?.

Stran »Dovolite tej aplikaciji?«

Stran pokaže:

• ime aplikacije. To ime si je aplikacija izbrala sama.
• kaj lahko aplikacija naredi v tvojem imenu.
• naslov, na katerega se vrneš.

Imenu ne zaupaj. Namesto tega preveri naslov, na katerega se vrneš. Pričakuj:

• claude.ai ali claude.com za Claude.
• chatgpt.com za ChatGPT.
• 127.0.0.1, localhost ali [::1] s številko vrat za aplikacijo na tvojem računalniku.

Klikni Zavrni, če aplikacije nisi pravkar zagnal sam ali če naslov ne pripada aplikaciji, ki si jo zagnal. Aplikacija nato ne dobi dostopa. Klikni Dovoli le, če je oboje pravilno.

kubehz vpraša enkrat na aplikacijo. Poznejša prijava stran preskoči. Če aplikacija pozneje prosi za novo dovoljenje, stran vpraša le za novo dovoljenje.

Tvoja vloga je meja. Aplikacija nikoli ne more narediti več kot ti.

Privzeto aplikacija deluje v najemniku, ki si se mu pridružil najprej. Aplikacija lahko izbere drugega od tvojih najemnikov. Tam deluje le, če ima ta najemnik vklopljene aplikacije UI. Orodje whoami pokaže najemnika.

Dovoljenja

Aplikacija ne dobi ničesar razen whoami, dokler ne prosi za dovoljenje. Stran pokaže dovoljenja, za katera aplikacija prosi. Nadzorna plošča pokaže vsako s kratkim imenom.

Na strani	Na nadzorni plošči	Orodja
Vidi, kdo ste.	Samo identiteta	whoami
Vidi vaše prostore in gruče ter prenese njihove datoteke kubeconfig. Datoteke ne vsebujejo skrivnosti.	Ogled prostorov in gruč	list_spaces, get_space, space_kubeconfig, list_clusters, get_cluster, cluster_kubeconfig
Ustvari in izbriše prostore ter določi njihov zakup (kdaj potečejo).	Ustvarjanje in brisanje prostorov	create_space, delete_space, set_space_lease
Določi zakup vaših gruč (kdaj potečejo).	Določanje zakupa gruč	set_cluster_lease

Če aplikacija pokliče orodje brez ustreznega dovoljenja, kubehz klic zavrne in navede dovoljenje. Aplikacija te nato lahko znova prijavi in prosi zanj.

Orodja

Orodje	Dovoljenje	Kaj naredi
whoami	Brez	Pokaže klicatelja: ključ za agenta (vloga, doseg, potek, poraba v tem mesecu, doseženi viri) ali osebo (najemnik in vloga)
list_spaces	Ogled prostorov in gruč	Navede prostore, ki jih klicatelj doseže, s stanjem, omejitvami in zakupom
get_space	Ogled prostorov in gruč	Pokaže en prostor: stanje, končno točko, vozlišča, omejitve in zakup
space_kubeconfig	Ogled prostorov in gruč	Da kubeconfig prostora, za ključ za agenta (privzeto) ali za osebo
list_clusters	Ogled prostorov in gruč	Navede gruče, ki jih klicatelj doseže, gostovane in tiste, ki jih gostiš sam
get_cluster	Ogled prostorov in gruč	Pokaže eno gručo: stanje, različico, delovna vozlišča in zdravje
cluster_kubeconfig	Ogled prostorov in gruč	Da kubeconfig za agenta gostovane gruče
create_space	Ustvarjanje in brisanje prostorov	Ustvari prostor. Pripravljen je v nekaj sekundah in se obračuna na uro
delete_space	Ustvarjanje in brisanje prostorov	Izbriše prostor z vsem v njem. Tega ne moreš razveljaviti. V tvojem imenu klic ne uspe (glej spodaj)
set_space_lease	Ustvarjanje in brisanje prostorov	Določi, kdaj kubehz izbriše prostor: 1 do 720 ur od zdaj. V tvojem imenu deluje le poznejši konec
set_cluster_lease	Določanje zakupa gruč	Določi, kdaj kubehz izbriše gostovano gručo: 1 do 720 ur od zdaj. V tvojem imenu deluje le poznejši konec

V tvojem imenu aplikacija ne more izbrisati prostora ali premakniti konca zakupa bližje. Tudi prvi zakup za prostor ali gručo brez zakupa premakne konec bližje. Za vsako od tega je potreben tvoj drugi faktor, aplikacija pa ga ne more dati. Prostor izbriši ali zakup prostora skrajšaj na nadzorni plošči. Prostor, ki ga aplikacija ustvari brez zakupa, ostane, dokler ga ne izbrišeš.

Ključ za agenta ne potrebuje drugega faktorja. Z vlogo Urejevalec ali Skrbnik lahko izbriše prostor in nastavi kateri koli konec zakupa med 1 in 720 urami od zdaj.

Noben kubeconfig ne vsebuje skrivnosti. Kubeconfig za agenta zažene lo kubehz token s ključem iz okolja. Kubeconfig za osebo prijavi osebo v brskalniku.

Ključ za agenta teh dovoljenj ne uporablja. Odloča njegova vloga. Ključ z vlogo Pregledovalec lahko uporablja le whoami in orodja, ki berejo.

Poveži agenta s ključem

Agent brez osebe uporablja ključ za agenta. Agent s ključem pridobi žeton in ga pošlje kot Authorization: Bearer. Nobena stran ne prosi za soglasje in nastavitev aplikacij UI ne velja. Kar agent ustvari, dobi zakup.

TOKEN=$(lo kubehz token --format token)
curl -s https://mcp.kubehz.cloud/mcp \
  -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'

Žeton poteče. Ko strežnik odgovori z 401, s ključem pridobi nov žeton.

V svojem imenu ali s ključem za agenta

	V svojem imenu	S ključem za agenta
Kdo deluje	Ti, prek aplikacije	Strojna identiteta
Meja	Tvoja vloga in dovoljenja, ki si jih dovolil	Vloga, doseg in omejitev porabe ključa
Nastavitev aplikacij UI	Mora biti vklopljena	Ne velja
Kar ustvari	Ima zakup le, če ga aplikacija nastavi	Ima vedno zakup
Izbris prostora ali bližji konec zakupa	Ne prek aplikacije: potreben je tvoj drugi faktor	Z vlogo Urejevalec ali Skrbnik
Kje to vidiš	Nastavitve → Aplikacije UI	Dostop → Ključi za agente
Kako se konča	Prekličeš jo ali kubehz izbriše neuporabljeno aplikacijo	Prekličeš ključ ali pa poteče

Oglej si in prekliči povezane aplikacije

V Nastavitve → Aplikacije UI vsak član vidi Tvoje povezane aplikacije. Owner ali Admin vidi tudi Vse povezane aplikacije v tem najemniku. Aplikacija se na seznamu pojavi po prvem klicu orodja. Vsaka vrstica pokaže ime aplikacije, njena Dovoljenja, kdaj jo je oseba dovolila (Dovoljeno) ter kdaj je bila prvič in nazadnje uporabljena (Prvič uporabljeno, Nazadnje uporabljeno).

Za preklic aplikacije:

1. Odpri Nastavitve → Aplikacije UI.
2. V vrstici aplikacije klikni Prekliči.
3. V pogovornem oknu klikni Prekliči.

• Tvoja aplikacija se takoj ustavi, v vseh najemnikih. Če jo želiš znova uporabljati, se iz aplikacije znova prijavi v kubehz in jo znova dovoli.
• Owner ali Admin lahko aplikacijo prekliče za člana. Aplikacija se za tega člana v tem najemniku takoj ustavi. Ob naslednji prijavi kubehz člana vpraša, ali aplikacijo znova dovoli.

Po preklicu deluje le nova prijava. Žeton iz prejšnje prijave nikoli več ne deluje.

kubehz izbriše registrirane aplikacije, ki jih nihče ne uporablja:

• aplikacijo, ki je v 7 dneh po registraciji nihče ni dovolil in uporabil.
• aplikacijo, ki je nihče ni uporabil 90 dni.

Če želiš izbrisano aplikacijo znova uporabljati, jo znova poveži.

Lokalni MCP z lo

lo mcp je drug strežnik. Teče na tvojem računalniku in tvojemu urejevalniku ali agentu ponudi ukaze lo projekta lok8s kot orodja. Privzeto ponudi le ukaze, ki berejo. Nikoli ne ponudi ukaza, katerega izpis je dostopni podatek. Njegova orodja lo kubehz space in lo kubehz cluster kličejo API kubehz s ključem za agenta. Ukazi zunaj lo kubehz ne potrebujejo računa kubehz. Glej vodnik MCP za lok8s in referenco za lo mcp.