MCP
Jak připojit Superpowered Platform k AI přes MCP
Připojení ke Claude, Claude Code, Codexu, ChatGPT a dalším MCP klientům, prompt ke zkopírování a přehled až 75 nástrojů podle role.
Po připojení může váš AI asistent načíst a exportovat uložený Superpowered report, projít coachingová doporučení a pracovat se stránkami Space přímo z platformy. Vedoucí týmů, administrátoři, vlastníci a partneři navíc dostanou přístup ke statistikám, reportům členů a týdenním týmovým reportům v rozsahu své role. Po samostatném povolení mohou administrátoři a vlastníci provádět i přesně vymezené organizační změny. Stejná MCP adresa funguje v Claude, Claude Code, Codexu, ChatGPT Desktop a dalších klientech, kteří podporují vzdálené MCP servery a OAuth.
Adresa MCP serveru je https://sp.aimee.coach/api/mcp. Připojení používá váš Superpowered účet a OAuth souhlas. API klíč ani vlastní OAuth Client ID nepotřebujete.
#Nejrychlejší nastavení: dejte tento prompt svému asistentovi
Zkopírujte celý prompt tlačítkem vpravo nahoře a vložte ho do aplikace, ve které chcete Superpowered Platform používat. Asistent buď připojení nastaví, nebo vás provede přesnými kroky. Hotovo je až po skutečném načtení vašeho profilu.
Zkopírujte a vložte do svého AI asistenta
Přečti si návod https://docs.aibility.org/metodika/mcp a připoj v tomto klientovi MCP server Superpowered Platform na adrese https://sp.aimee.coach/api/mcp pomocí nativního nastavení vzdáleného MCP. Pokud umíš nastavení klienta změnit, udělej to. Pokud ne, dej mi přesný postup pro tento klient a počkej, až ho dokončím. Použij OAuth: otevři přihlášení a nech mě potvrdit požadovaný přístup. Nežádej po mně API klíč ani vlastní OAuth Client ID a žádný klíč neukládej. Po připojení zavolej nástroj `get_my_profile` a shrň můj aktuální Superpowered profil; pokud ještě nemám dokončený výsledek, řekni to přímo. Nastavení je hotové až ve chvíli, kdy tento nástroj vrátí skutečná data. Neskonči po pouhém přidání serveru nebo přihlášení.#Co můžete po připojení zadat
- „Načti můj nejnovější Superpowered report. U každého doporučení uveď, z které části reportu vychází."
- „Exportuj můj poslední report jako HTML a ulož ho pod názvem, který vrátí platforma."
- „Najdi existující veřejný odkaz na můj poslední hotový report."
- „Vypiš moje coachingová doporučení a najdi témata, která se opakují."
- „Najdi všechny stránky ve Space, ke kterým mám přístup."
- „Načti statistiky naší organizace za posledních 30 dní a připrav CSV." Tato možnost vyžaduje organizační čtení.
- „Najdi poslední hotový report mého týmu a shrň doporučení pro další týden." Vedoucí týmu dostane jen reporty svých týmů.
- „Jaká je účast v posledním check-inu?" Tato možnost vyžaduje plné organizační čtení.
- „Jako admin připrav náhled změny výchozího jazyka organizace na slovenštinu. Nic neprováděj, dokud náhled nepotvrdím."
- „Připrav pozvánku pro
anna@example.com. Než požádáš o potvrzení, ukaž příjemce, co se odešle a proč. Zatím nic neposílej." - „Prověř hromadný import těchto členů. Než požádáš o potvrzení, vysvětli, zda aktuální kampaň někomu odešle nebo naplánuje e-mail."
- „Připrav aktivaci kampaně od 15. září do 30. září. Před oběma potvrzeními ukaž příjemce, obsah a časy zpráv."
- „Archivuj tento organizační prompt. Ukaž mi přesný dopad a vyžádej obě oddělená potvrzení."
- „Spusť ZIP export organizace bez e-mailového upozornění, kontroluj stav přes MCP, stáhni hotový ZIP přes nový odkaz a ověř celý počet bajtů i to, že ZIP jde otevřít."
Význam jednotlivých částí výsledku vysvětluje stránka jak číst váš výsledek. S problémy při přihlášení pomůže FAQ k přihlášení a přístupu.
#Ruční připojení podle aplikace
V Claude na webu nebo v desktopové aplikaci otevřete Customize → Connectors, klikněte na + a zvolte Add custom connector. Vložte MCP adresu, konektor přidejte a pak se přihlaste přes OAuth.
Na individuálním účtu můžete konektor přidat sami. U Team a Enterprise účtu ho nejdřív přidává vlastník v Organization settings → Connectors; člen se potom připojí vlastním Superpowered účtem. Vlastní OAuth Client ID ani secret nevyplňujte.
V terminálu spusťte:
claude mcp add --transport http --scope user superpowered https://sp.aimee.coach/api/mcpPotom otevřete Claude Code, napište /mcp a u serveru superpowered spusťte přihlášení. OAuth se otevře v prohlížeči. Stav ověříte příkazem claude mcp list.
V ChatGPT Desktop nebo Codexu otevřete Settings → MCP servers → Add server. Zvolte Streamable HTTP, server pojmenujte Superpowered Platform, vložte MCP adresu, uložte ho a aplikaci restartujte. Potom u serveru zvolte Authenticate.
V Codex CLI nebo IDE rozšíření můžete stejné připojení uložit do ~/.codex/config.toml:
[mcp_servers.superpowered]
url = "https://sp.aimee.coach/api/mcp"Přihlášení spustíte příkazem codex mcp login superpowered; aktivní servery zkontrolujete přes /mcp nebo codex mcp list. ChatGPT Desktop, Codex CLI a Codex IDE rozšíření na stejném počítači sdílejí tuto konfiguraci.
ChatGPT na webu nepřebírá lokální MCP konfiguraci z Codexu. Vzdálené MCP nástroje se tam používají přes pluginy v ChatGPT Work a jejich dostupnost může řídit administrátor workspace.
Pokud v ChatGPT na webu nevidíte možnost přidat nebo nainstalovat odpovídající plugin, použijte ChatGPT Desktop, Codex, Claude nebo Claude Code. Samotné vložení MCP adresy do běžného chatu připojení nevytvoří.
V Cursoru nebo jiném klientovi hledejte MCP servers, Custom connector nebo Integrations. Přidejte vzdálený server typu Streamable HTTP, vložte MCP adresu a dokončete OAuth přihlášení.
Klient musí podporovat vzdálené HTTPS MCP servery a OAuth. Pokud nabízí jen lokální stdio server nebo vyžaduje ručně vložený API klíč, tento přímý způsob připojení nepodporuje.
Po přihlášení potvrďte přístup k vlastním Superpowered datům, stránkám Space a případně organizacím, ve kterých máte oprávněnou roli nebo vedete tým. Pak požádejte asistenta, aby zavolal get_my_profile. Tím ověříte server, přihlášení i oprávnění jedním skutečným načtením dat.
#Kolik nástrojů dostanete
Tabulka ukazuje maximum po povolení osobních dat, Space a případně správy organizace. Skutečný seznam závisí na vaší roli a oprávněních, která při připojení schválíte.
| Vaše role | Dostupný katalog |
|---|---|
| Běžný uživatel nebo člen organizace | 11 osobních a Space nástrojů. Celkem 11. |
| Vedoucí týmu | 11 osobních a Space + 12 organizačních nástrojů pouze pro vedené týmy. Celkem 23. |
| Partner organizace | 11 osobních a Space + 25 organizačních nástrojů pouze pro čtení. Celkem 36. |
| Administrátor organizace | 11 osobních a Space + až 26 organizačních nástrojů pro čtení. Po povolení správy také až 30 nástrojů pro změny a 5 nástrojů pro jejich bezpečné potvrzení. Celkem až 72. |
| Vlastník organizace | 11 osobních a Space + až 26 organizačních nástrojů pro čtení. Po povolení správy také až 33 nástrojů pro změny a 5 nástrojů pro jejich bezpečné potvrzení. Celkem až 75. |
Pokud nepovolíte Space, zůstane vám 9 osobních nástrojů. Vedoucí týmu dostane organizační nástroje jen pro týmy, které vede. Partner může organizační data pouze číst. Změny v organizaci jsou dostupné jen administrátorům a vlastníkům po výslovném povolení správy. Uživatel s více rolemi dostane jejich společný katalog bez duplicit; maximum je 75.
#Osobní data a Space: 11 nástrojů
Tyto nástroje pracují pouze s vaším účtem a s obsahem, ke kterému máte aktuálně přístup.
| Nástroj | Co umí |
|---|---|
get_my_profile | Načte jméno, jazyk, počty assessmentů a doporučení a aktuální odvozený Superpowered výsledek. |
list_my_assessments | Vypíše vaše assessmenty, jejich stav, datum a dostupná metadata výsledku. |
get_my_assessment | Načte detail jednoho vašeho assessmentu. |
get_my_report | Načte uložený strukturovaný report. |
export_my_report | Vrátí uložený report jako Markdown nebo HTML včetně názvu souboru. |
get_my_report_share_link | Vrátí existující veřejný odkaz na váš hotový report. |
list_my_coaching_recommendations | Vypíše vaše coachingová doporučení od nejnovějších. |
get_my_coaching_recommendation | Načte celé jedno doporučení v čitelném formátu. |
export_my_coaching_recommendations | Připraví jedno nebo všechna hotová doporučení jako Markdown. |
list_my_space_sites | Vypíše stránky Space dostupné přímo, přes organizaci nebo přes tým. |
download_my_space_site | Vytvoří odkaz pro stažení dostupné stránky Space. Odkaz platí 120 sekund. |
Názvy nástrojů znát nemusíte. Stačí napsat třeba: „Najdi můj poslední report a shrň mi tři nejsilnější stránky" nebo „Najdi ve Space materiál k našemu workshopu a stáhni ho."
#Organizační data: podle vaší role
Platforma načte členství, roli a vedené týmy znovu při každém požadavku. Běžný člen přes MCP neuvidí data ostatních lidí. Vedoucí týmu vidí jen lidi, assessmenty, statistiky a týmové reporty patřící do týmů, které právě vede. Administrátor nebo vlastník čte svou organizaci; partner čte všechny své aktuální organizace.
| Nástroj | Co umí | Dostupnost |
|---|---|---|
list_my_organizations | Vypíše organizace, aktuální roli, rozsah čtení a vedené týmy. | Vedoucí týmu, admin, vlastník, partner |
list_members | Vypíše členy, role, týmy a dostupný stav assessmentu. | Všichni s organizačním čtením |
list_teams | Vypíše týmy a počty členů. | Všichni s organizačním čtením |
list_assessments | Vyhledá a filtruje assessmenty organizace. | Všichni s organizačním čtením |
get_assessment | Načte detail výsledku assessmentu. | Všichni s organizačním čtením |
get_report | Načte uložené části reportu konkrétního assessmentu. | Všichni s organizačním čtením |
export_member_report | Vrátí uložený report oprávněného člena jako Markdown nebo HTML. | Všichni s organizačním čtením |
get_organization_statistics | Načte stejné statistické karty a řádky členů jako platforma, omezené rolí nebo vedenými týmy. | Všichni s organizačním čtením |
export_organization_statistics | Připraví aktuální tabulku statistik jako CSV. | Všichni s organizačním čtením |
list_team_checkin_reports | Vypíše dostupné hotové týdenní týmové reporty. | Všichni s organizačním čtením |
get_team_checkin_report | Načte jeden uložený týmový report a souhrn účasti. | Všichni s organizačním čtením |
export_team_checkin_report | Vrátí uložený týmový report jako Markdown. | Všichni s organizačním čtením |
get_organization_context | Načte schválený firemní kontext a jeho stav. | Admin, vlastník, partner |
list_campaigns | Vypíše assessmentové kampaně organizace. | Admin, vlastník, partner |
get_campaign | Načte detail konkrétní kampaně. | Admin, vlastník, partner |
get_checkin_participation | Ukáže účast a stav lidí v check-inech. | Admin, vlastník, partner |
get_upcoming_coaching_schedule | Načte souhrnný plán firemních AI check-inů ve zvoleném období. | Admin, vlastník, partner |
list_activity | Ukáže souhrny návštěv členů organizace. | Admin, vlastník, partner |
get_user_activity | Načte časové údaje návštěv jednoho člena. | Admin, vlastník, partner |
list_organization_prompts | Vypíše prompty vlastněné danou organizací. | Admin, vlastník, partner |
get_organization_prompt | Načte celý organizační prompt a jeho metadata. | Admin, vlastník, partner |
list_sites | Vypíše stránky Space organizace nebo jejího týmu. | Admin, vlastník, partner |
get_site | Načte metadata jedné organizační stránky Space. | Admin, vlastník, partner |
get_organization_export_status | Načte stav a průběh posledního ZIP exportu organizace. | Admin, vlastník, partner |
download_organization_export | Vytvoří nový odkaz na hotový a neexpirovaný ZIP. Odkaz platí 120 sekund a při stažení znovu ověří oprávnění. | Admin, vlastník, partner |
Přístup vždy odpovídá vaší aktuální roli v platformě. Pokud se role nebo vedení týmu změní, projeví se to při dalším použití nástroje.
#Jak MCP vrací exporty a velké soubory
Textové exporty dostane asistent přímo. Space a celý organizační ZIP se stahují přes zabezpečený odkaz platný 120 sekund, takže lze stáhnout i velké soubory.
| Způsob | Nástroje | Výsledek |
|---|---|---|
| Textový export | export_my_report, export_my_coaching_recommendations, export_member_report, export_organization_statistics, export_team_checkin_report | Obsah a název souboru dostane asistent přímo. |
| Stažení souboru | download_my_space_site, download_organization_export | Čerstvý odkaz na HTML nebo ZIP, platný 120 sekund. |
U velkého souboru požádejte asistenta, aby ověřil staženou velikost a zkontroloval, že HTML nebo ZIP jde otevřít. Pokud se stažení přeruší, vyžádejte nový odkaz a stáhněte soubor znovu.
Celý organizační export má tři kroky: admin nebo vlastník spustí start_organization_export bez e-mailového upozornění, oprávněný admin, vlastník nebo partner kontroluje get_organization_export_status a po dokončení si přes download_organization_export vyžádá nový odkaz. Partner může načíst a stáhnout existující export, ale nemůže nový export spustit.
#Správa organizace: admin až 30, vlastník až 33
Správu organizace musíte výslovně povolit při přihlášení. Pokud jste MCP připojili dříve jen pro čtení, připojte ho znovu a povolte správu. Rozsah odpovídá vaší aktuální roli:
- administrátor může používat až 30 nástrojů pro správu;
- vlastník může používat všech 33 nástrojů pro správu;
- partner, vedoucí týmu a běžný člen nemohou přes MCP organizaci měnit.
Každá změna nejdřív ukáže náhled. Odebrání, zrušení, ukončení, skrytí, archivace a revokace vyžadují dvě oddělená potvrzení. Pokud akce odešle nebo naplánuje e-mail, asistent před potvrzením vysvětlí, co se stane a proč, komu se zpráva odešle a kdy.
#Až pět nástrojů pro bezpečné provedení změny
| Nástroj | Co umí |
|---|---|
preview_customer_mutation | Ukáže přesnou změnu před provedením. Nic nezmění. |
confirm_customer_mutation | Zaznamená první potvrzení u změny, která něco odebírá, a vyžádá druhé. |
get_customer_mutation_status | Ukáže stav a výsledek jedné prováděné změny. |
list_customer_mutation_audit | Vypíše historii změn provedených přes MCP v organizaci. |
list_customer_communication_recipients | Ukáže aktuální příjemce kampaně před potvrzením odeslání nebo naplánování. |
Běžná změna probíhá jako náhled → potvrzení → provedení. Změna, která něco odebírá, probíhá jako náhled → první potvrzení → druhé potvrzení → provedení. Pokud se mezitím změnil cílový záznam nebo oprávnění, asistent musí připravit nový náhled.
U akce, která může poslat nebo naplánovat e-mail, musí asistent před potvrzením ukázat příjemce, důvod, čas odeslání a náhled zprávy. Pozvánky a kampaně používají připravené šablony Superpowered Platform.
#Nastavení organizace a funkce: 5 nástrojů
Pro administrátora a vlastníka.
| Nástroj | Co změní |
|---|---|
update_organization_context | Nahradí schválený firemní kontext v Markdownu. |
update_organization_space_label | Nastaví názvy položky Space pro podporované jazyky. |
update_organization_default_locale | Změní výchozí jazyk organizace. |
set_organization_ai_coach | Zapne nebo vypne AI Coach v organizaci. |
set_organization_prompt_external_actions | Zapne nebo vypne externí akce u organizačních promptů. |
#Týmy a členství: 7 nástrojů
| Nástroj | Co změní | Dostupnost |
|---|---|---|
create_team | Vytvoří tým; pokud už existuje tým se stejným názvem bez ohledu na velikost písmen, bezpečně ho znovu použije. | Admin, vlastník |
set_member_team | Nastaví členovi jeden tým nebo odebere jeho současné týmové přiřazení. | Admin, vlastník |
set_team_lead_teams | Nahradí přesný seznam týmů, které člen vede. | Admin, vlastník |
set_member_note | Nastaví interní poznámku o členovi viditelnou organizaci. | Admin, vlastník |
set_member_locale_override | Nastaví nebo zruší jazykovou výjimku člena. | Admin, vlastník |
update_member_role | Povýší člena na admina nebo sníží admina na člena. Nelze změnit vlastníka ani vlastní roli volajícího. | Pouze vlastník |
remove_organization_member | Odebere členství člověka v organizaci a jeho týmové vazby. | Pouze vlastník |
Dvě potvrzení se použijí při odebrání člena, odebrání nebo nahrazení stávajícího týmového přiřazení, odebrání vedeného týmu, zrušení jazykové výjimky a snížení role admina na člena.
#Příprava a správa kampaní: 6 nástrojů
Pro administrátora a vlastníka.
| Nástroj | Co změní |
|---|---|
create_campaign_draft | Vytvoří neaktivní koncept kampaně pro organizaci nebo tým. Nic neodešle ani nenaplánuje. |
update_campaign_draft | Upraví začátek nebo konec kampaně, dokud zůstává konceptem. |
update_campaign_end_date | Změní datum konce kampaně v podporovaném stavu. |
cancel_scheduled_campaign | Po dvou potvrzeních zruší naplánovanou kampaň. |
end_active_campaign | Po dvou potvrzeních ukončí aktivní kampaň. |
remove_campaign_reminder | Po dvou potvrzeních odebere jednu čekající připomínku. |
Aktivaci kampaně a přidání připomínky řeší nástroje uvedené níže.
#Export, Space a organizační prompty: 9 nástrojů
Pro administrátora a vlastníka.
| Nástroj | Co změní |
|---|---|
start_organization_export | Spustí ZIP export celé organizace bez e-mailového upozornění. Stav a hotový ZIP pak načtete přes MCP. |
create_organization_site | Vytvoří nepublikovanou stránku Space pro organizaci nebo tým a uloží první soukromou verzi obsahu. |
update_organization_site | Upraví metadata nebo obsah stránky jako novou verzi; předchozí verze zachová. |
publish_organization_site | Zveřejní aktuální verzi stránky oprávněným uživatelům. |
unpublish_organization_site | Po dvou potvrzeních stránku skryje, ale zachová její obsah a verze. |
archive_organization_site | Po dvou potvrzeních stránku archivuje a skryje, ale zachová její obsah a verze. |
create_organization_prompt | Vytvoří aktivní organizační prompt pro konkrétní jazyk a uloží první verzi. |
update_organization_prompt | Upraví prompt a zachová předchozí verzi. |
archive_organization_prompt | Po dvou potvrzeních prompt archivuje, ale zachová jeho verze. |
#Zrušení staršího MCP přístupu k organizaci: 1 nástroj
Pouze pro vlastníka.
| Nástroj | Co změní |
|---|---|
revoke_organization_mcp_key | Po dvou potvrzeních zneplatní jeden aktivní starší MCP klíč organizace. |
Pro nové připojení použijte OAuth postup z úvodu této stránky.
#Pozvánky a hromadný import: 4 nástroje
Pro administrátora a vlastníka.
| Nástroj | Co udělá |
|---|---|
get_organization_invite_link | Načte aktuální pozvánkový odkaz organizace. Nic nevytvoří ani nezmění. |
rotate_organization_invite_link | Vytvoří první odkaz po jednom potvrzení. Nahrazení existujícího odkazu vyžaduje dvě potvrzení a starý odkaz ihned přestane fungovat. |
invite_organization_member | Vytvoří pozvánku a odešle ji na zadaný e-mail. Před potvrzením asistent ukáže příjemce, důvod a náhled zprávy. Admin může zvát člena; admina může zvát pouze vlastník. |
bulk_import_members | Přidá více členů s volitelným týmem a jazykem. Před potvrzením asistent vysvětlí, zda kvůli aktuální kampani někdo dostane e-mail. Pokud ano, vyžádá dvě potvrzení. |
#Aktivace kampaně a připomínky: 2 nástroje
Pro administrátora a vlastníka.
| Nástroj | Co udělá |
|---|---|
activate_campaign | Po dvou potvrzeních aktivuje kampaň a naplánuje startovní e-mail i připomínky. Před potvrzením asistent ukáže příjemce, důvod, obsah a časy zpráv. |
add_campaign_reminder | Přidá připomínku do kampaně. U konceptu ji pouze uloží; u aktivní kampaně ji po dvou potvrzeních naplánuje k odeslání. |
U už naplánované kampaně nejdřív po dvou potvrzeních zrušte plánování a vraťte ji do konceptu. Potom lze připomínku přidat.
#Když připojení nefunguje
| Co vidíte | Co udělat |
|---|---|
Couldn't register with Superpowered Platform's sign-in service | Zkontrolujte přesnou adresu https://sp.aimee.coach/api/mcp. Vlastní OAuth Client ID nepřidávejte. Konektor odpojte, smažte a přidejte znovu. |
| Jen 9 nástrojů, bez Space | Připojte server znovu a na obrazovce souhlasu povolte čtení Space. |
| 11 nástrojů, ale žádné organizační nástroje | Zkontrolujte svou roli a souhlas s přístupem k organizacím. Běžný člen bez vedeného týmu zůstává u osobních nástrojů. |
| Jste vedoucí týmu, ale organizační nástroje chybí | Ověřte v platformě, že jste stále přiřazeni jako vedoucí konkrétního týmu, a spusťte nové OAuth přihlášení. |
| Organizační čtení funguje, ale nástroje pro změny chybí | Připojte MCP znovu, povolte správu organizace a ověřte, že jste stále administrátor nebo vlastník. |
| Asistent hlásí, že náhled změny zastaral | Mezitím se změnil cílový záznam nebo vaše oprávnění. Nechte vytvořit nový náhled a zkontrolujte ho znovu. |
| Náhled pozvánky nebo kampaně hlásí změnu publika | Nechte asistenta znovu načíst příjemce a vytvořit nový náhled. Staré potvrzení nepoužívejte, protože už neodpovídá lidem, kterých se akce týká. |
| Stahování Space nebo organizačního ZIPu skončí předčasně | Vyžádejte nový 120sekundový odkaz a nechte asistenta stáhnout celý soubor. Pokud stažená velikost nesouhlasí s uvedenou velikostí nebo HTML/ZIP nejde otevřít, zkuste nový odkaz. |
Connection issue po dřívějším připojení | Spusťte nové přihlášení a projděte OAuth souhlas. Pokud chyba zůstane, pošlete na support@aibility.cz referenci začínající ofid_. |
| Server je přidaný, ale asistent ho nepoužívá | Ověřte stav serveru v nastavení klienta nebo přes /mcp a požádejte asistenta přímo o zavolání get_my_profile. |