AI asistenti (MCP)

EOS Hub má MCP server, takže AI asistenti ako Claude, ChatGPT alebo Claude Code môžu pracovať s vašimi EOS dátami. Môžete sa opýtať „Aké mám otvorené úlohy a ako dopadol náš Scorecard tento týždeň?“ alebo „Pridaj do Leadership Teamu problém s oneskoreným releasom“ a asistent odpovie z EOS Hub alebo zmenu urobí za vás.

MCP (Model Context Protocol) je otvorený štandard, cez ktorý sa AI asistenti pripájajú k iným aplikáciám.

INFO

Asistent pracuje s vašimi právami, nikdy nie s väčšími. Vidí a mení presne to, čo vy vo webovej aplikácii, a len v organizáciách, ktoré AI asistentov povolili. Pripojenie Len čítanie nemôže nič zmeniť.

Skôr než začnete: organizácia to musí povoliť

AI asistenti sú v každej organizácii vypnutí, kým ich nepovolí vlastník (Owner) alebo admin:

1. Otvorte Nastavenia organizácie > Všeobecné.
2. Zapnite Povoliť AI asistentov (MCP) a potvrďte.

Kým je to vypnuté, asistenti organizáciu vôbec nevidia; vaše ostatné organizácie to neovplyvní. Vypnutie platí okamžite a pripojenia všetkých ostávajú, takže po opätovnom zapnutí prístup funguje znova.

Operátor platformy môže MCP vypnúť aj pre celú platformu (Platforma > MCP), napríklad pri incidente.

Pripojenie asistenta

Otvorte Nastavenia > AI asistenti (MCP) a skopírujte Adresu servera. Je to adresa vášho EOS Hub s /mcp na konci, napríklad https://eoshub.pixon.eu/mcp.

Claude (claude.ai a Claude Desktop)

1. V Claude otvorte Settings > Connectors a zvoľte Add custom connector.
2. Zadajte názov (napríklad EOS Hub) a vložte adresu servera.
3. Kliknite na Connect. Otvorí sa okno s EOS Hub.
4. Prihláste sa do EOS Hub cez Google alebo heslom, ak už nie ste prihlásení.
5. Skontrolujte žiadosť a kliknite na Povoliť (pozri Súhlasová obrazovka).

Okno sa zavrie a Claude môže EOS Hub používať. V plánoch Team a Enterprise môže konektor najprv musieť pridať vlastník organizácie v Claude.

ChatGPT

1. V ChatGPT otvorte Settings > Apps & Connectors > Advanced settings a zapnite Developer mode.
2. Vytvorte konektor s adresou servera a autentifikáciou OAuth.
3. Prihláste sa do EOS Hub a kliknite na Povoliť.

Claude Code

Spustite:

claude mcp add --transport http eos-hub https://eoshub.pixon.eu/mcp

Potom v Claude Code napíšte /mcp, zvoľte eos-hub a prihláste sa do EOS Hub v okne prehliadača, ktoré sa otvorí.

Iné nástroje a skripty (API kľúč)

Nástroje, ktoré sa nevedia prihlásiť cez prehliadač, môžu namiesto toho použiť API kľúč. Posielajú ho v hlavičke Authorization: Bearer ak_… na adresu servera. Platí prístup kľúča (len čítanie alebo čítanie a zápis), rovnako ako pri REST API.

Súhlasová obrazovka

Keď sa asistent pripája, EOS Hub ukáže, o čo žiada:

• Názov aplikácie a kam sa vrátite, napríklad claude.ai. Názov si aplikácia volí sama, preto skontrolujte adresu: ak ste pripojenie nezačali vy, kliknite na Zamietnuť.
• Prístup:
  • Len čítanie: asistent môže čítať úlohy, problémy, Rocks, Scorecardy, porady a V/TO.
  • Čítanie a zmeny: môže aj vytvárať a meniť úlohy, problémy, Rocks, hodnoty Scorecardu a zápisy z porád.
• Správa platformy (len operátori platformy, predvolene nezaškrtnuté): čítať organizácie, používateľov a spätnú väzbu platformy, spravovať spätnú väzbu a určovať správcov platformy.
• Vaše organizácie, pri každej či je pre AI asistentov dostupná alebo vypnutá.

Čo asistent dokáže

Oblasť	Čítanie	Zmeny (Čítanie a zmeny)
Orientácia	kto ste, vaše organizácie a tímy s vašimi rolami, dnešný dátum, aktuálny týždeň Scorecardu a kvartál; prehľad tímu	—
Úlohy	vaše úlohy naprieč tímami, úlohy tímu, úlohy po termíne	vytvoriť, upraviť, dokončiť, znova otvoriť, zmazať
Problémy	problémy tímu podľa stavu, priority alebo podľa toho, či sú krátkodobé alebo dlhodobé	vytvoriť, upraviť, presunúť medzi krátkodobé a dlhodobé, zmeniť stav (Otvorený, Rieši sa, Vyriešený), zmazať
Rocks	tímové a firemné Rocks s míľnikmi	vytvoriť, upraviť, nahlásiť stav (on/off track, hotovo), pridať a dokončiť míľniky, zmazať
Scorecard	metriky s cieľmi a posledných 1–26 týždňov	pridať metriku s cieľom (alebo bez neho, len na sledovanie), vlastníkom a jednotkou; zadať alebo odstrániť hodnotu týždňa s poznámkou (splnené/nesplnené určí cieľ)
Porady	porady s hodnoteniami a ich komentármi, segues, headlines, kaskádovými správami, hosťami a úlohami a problémami, ktoré na nich vznikli	naplánovať poradu na deň alebo zaznamenať poradu, ktorá už prebehla (začiatok a dĺžka; admini tímu), pridať headline o zákazníkoch, zamestnancoch alebo firme alebo kaskádovú správu, ohodnotiť poradu; admini tímu aj nastavia hodnotenie člena (s komentárom) alebo jeho účasť a zapíšu poznámky z porady
Celé REST API	akákoľvek operácia REST API, nájdená vyhľadávaním	to isté, s právami používateľa -- napr. import histórie tímu
Referencie	V/TO (firemná vízia a trakcia tímu), organizačná štruktúra, hodnotenie ľudí, dokumenty	—
Spätná väzba	—	poslať problém alebo nápad prevádzkovateľom platformy
Platforma (operátori)	organizácie, používatelia, spätná väzba	nastaviť stav a internú poznámku spätnej väzby; urobiť z používateľa správcu platformy alebo bežného používateľa

Keď asistent číta V/TO tímu, dostane firemnú víziu spoločnú pre všetky tímy organizácie, 1-ročný plán tímu, Rocks aktuálneho kvartálu a otvorené dlhodobé problémy tímu (oboje priamo z modulov) a archív starých ručne písaných zoznamov, ak existuje -- rovnaké údaje ako GET /teams/{teamId}/vision v REST API. Pri čítaní, vytváraní a úprave problémov rozlišuje krátkodobé problémy (na týždenné stretnutie) od dlhodobých (do V/TO), napríklad „Pridaj sťahovanie kancelárie medzi dlhodobé problémy leadership tímu". Platí to od verzie servera 1.7.0.

Celé REST API: search_api, read_api, write_api

Na to, čo nástroje vyššie nepokrývajú, asistent siahne do REST API cez tri všeobecné nástroje namiesto desiatok špeciálnych:

• search_api nájde operácie podľa slov („metric values batch", „meeting guests") a jednu opíše celú: jej parametre, telo požiadavky a odpovede.
• read_api posiela požiadavky GET -- jednu alebo až 20 naraz.
• write_api posiela požiadavky POST, PUT, PATCH a DELETE -- jednu alebo až 100 za sebou, voliteľne so zastavením pri prvej chybe. Každá môže byť skúšobný beh (dry run): vykoná sa a vráti späť, takže asistent vidí, čo by sa uložilo.

Volania bežia v EOS Hub ako prihlásený používateľ (bez API kľúča) s právami pripojenia: pripojenie len na čítanie dostane iba search_api a read_api a organizácia, ktorá AI asistentov nepovolila, ich odmietne ako každý iný nástroj. Majú vlastný limit 600 volaní za minútu. Meniť môžu len prácu tímu – úlohy, issues, Rocks, Scorecard, porady, dokumenty, V/TO – a vracať importy: členstvo v organizácii a tímoch, roly, nastavenia, Accountability Chart, People Analyzer a platformu menia len ľudia v aplikácii.

Takto asistent importuje históriu tímu, napr. „Naimportuj posledných 14 porád SW tímu z tejto tabuľky": s tým, čo vytvára, posiela externalId a importBatchId, takže opakovaný beh nič nevytvorí dvakrát a celý import sa dá vrátiť späť (pozri Import histórie). Platí to od verzie servera 1.11.0.

Niektoré veci ostávajú vo webovej aplikácii a v REST API: vedenie L10 porady krok po kroku, úprava, presúvanie a mazanie metrík Scorecardu, úpravy V/TO a organizačnej štruktúry, hodnotenie ľudí, dokumenty a nastavenia organizácie a platformy.

K dispozícii je aj pripravený prompt Prepare a Level 10 meeting. V Claude ho vyberte z promptov konektora a zadajte tím. Asistent zozbiera Scorecard, Rocks, úlohy po termíne a otvorené problémy a pripraví program porady.

Mazanie väčšina asistentov potvrdzuje; EOS Hub tieto akcie označuje ako deštruktívne.

Správa pripojení

Nastavenia > AI asistenti (MCP) > Pripojené aplikácie zobrazuje každého asistenta, ktorého ste pripojili, s jeho prístupom, dátumom pripojenia a posledného použitia. Kliknutím na Odpojiť (ikona zástrčky) pripojenie ukončíte: asistent okamžite stratí prístup.

Opätovné pripojenie tej istej aplikácie nahradí jej predchádzajúce pripojenie.

Pri väčšom počte pripojení hľadajte podľa názvu aplikácie alebo filtrujte podľa Aplikácie a kliknutím na hlavičku stĺpca zoznam zoradíte. Tieto filtre sú oddelené od filtrov zoznamu API kľúčov na tej istej stránke -- pozrite si Filtrovanie zoznamov.

Operátor platformy vidí počet pripojení každého používateľa v Platforma > Používatelia a môže tam pripojenie ukončiť, napríklad pri strate zariadenia.

Platforma > MCP ukazuje operátorovi celý obraz:

• Pripojené aplikácie: každé aktívne pripojenie. Vidno používateľa, aplikáciu a jej druh (Claude, ChatGPT, aplikácia na počítači ako Claude Code či Cursor, alebo iná aplikácia s doménou) a udelené práva. Ďalej organizácie používateľa (tie s vypnutými AI asistentmi sú označené), kedy sa pripojil a kedy pripojenie naposledy použil, a ako dlho platí prihlásenie (aktuálny prístupový token a do kedy sa samo obnovuje). Odpojiť okamžite zruší jeho tokeny.
• Registrované aplikácie: aplikácie, ktoré sa zaregistrovali na prihlasovacom serveri. Pri každej vidíte názov, client ID, kam posiela prihlásenie, kedy a z akej IP sa zaregistrovala, kedy bola naposledy použitá a koľko má pripojení. Odpojiť a zmazať odpojí všetkých, ktorí aplikáciu používajú, a odstráni jej registráciu. Aplikácie sa registrujú samy, takže sa aplikácia môže zaregistrovať znovu; jej používatelia potom musia dať súhlas znova. Zmazať nepoužité registrácie odstráni registrácie staršie ako deň, ktoré sa nikdy nepripojili, napríklad z nedokončeného prihlásenia; aplikácie, ktorých používatelia sa len odpojili, ostávajú.

Ktoré nástroje asistent volal, sa zatiaľ nezaznamenáva.

Bezpečnosť

• EOS Hub používa OAuth 2.1 s PKCE. Vaše heslo ani Google účet sa k asistentovi nikdy nedostanú; asistent dostane len tokeny vydané EOS Hub.
• Prístupové tokeny platia jednu hodinu. Asistent ich obnovuje refresh tokenom, ktorý platí 30 dní a pri každom obnovení sa vymení. Ak by sa niekedy znova použil starý refresh token, EOS Hub predpokladá, že ho niekto skopíroval, a pripojenie ukončí.
• Tokeny fungujú len pre MCP server, nikdy pre REST API, a EOS Hub z nich ukladá len odtlačky (hashe).
• Prístup sa riadi vašimi aktuálnymi rolami. Ak vás odoberú z tímu alebo organizácie, asistent ten prístup stratí okamžite. Pozastavená organizácia je len na čítanie.

Riešenie problémov

Problém	Čo robiť
Asistent nevidí žiadnu organizáciu	Vlastník alebo admin musí povoliť AI asistentov v Nastavenia organizácie > Všeobecné. Stránka nastavení vypíše vaše organizácie, kde je to ešte vypnuté.
„Toto pripojenie sa nedá nastaviť“	Aplikácia sa chcela vrátiť na adresu, ktorú nezaregistrovala. Začnite pripojenie znova z aplikácie.
„AI asistenti sú vypnutí“	Operátor platformy vypol MCP. Skúste to neskôr.
Akcia zlyhá s forbidden	Vaša rola to nedovoľuje (napríklad divák nemôže pridávať úlohy) alebo je pripojenie Len čítanie.
Akcia zlyhá s orgSuspended	Organizácia je pozastavená a len na čítanie.
Asistent po čase prestane fungovať	Pripojenie bolo odpojené alebo vypršalo po 30 dňoch nepoužívania. Pripojte ho znova.