Stafio MCP v Claude a ChatGPT

Stafio MCP umožňuje AI asistentovi používat nástroje Stafia pod vaším účtem. Server běží vzdáleně; do telefonu se žádný MCP server neinstaluje.

Stav

Ověřeno v dokumentaci Anthropic a OpenAI, ve zdrojovém kódu a na serveru 20. 10. 2026. Připojení na konkrétním zákaznickém účtu ani v ChatGPT nebylo v rámci tohoto návodu otestováno.

Co je dostupné na mobilu

• Claude pro iOS a Android: vzdálené konektory jsou podporované. Připojení nejprve nastavte přes web pod stejným účtem.
• ChatGPT: dokumentace OpenAI popisuje vlastní MCP server jen pro ChatGPT na webu.

1. Adresa a způsob přihlášení

Adresa konektoru je stejná pro všechny zákazníky:

https://mcp.stafio.cz/

Endpoint Stafio MCP je kořenová cesta /. Nepřidávejte /mcp, /sse ani /api/agent. Server používá Streamable HTTP a nabízí dva způsoby přihlášení:

• OAuth (doporučeno): každý člověk se při připojení přihlásí svým uživatelským jménem a heslem do Stafia a asistent pracuje jen s jeho právy. Hodí se pro organizace v Claude Team a Enterprise i pro ChatGPT. Postup je v krocích 2 a 4.
• API klíč v hlavičce X-API-Key: pro jednotlivce a nástroje, které umějí poslat vlastní hlavičku (například Claude Code). Kdo klíč použije, pracuje s právy jeho uživatele. Postup je v kroku 3.

Připojit se může jen uživatel Stafia, ne pracovník ani klient. Klíč vložený do adresy (?api_key=…) server nepřijme a vyžádá si přihlášení.

2. Claude: přihlášení přes OAuth

Vlastní účet (Free, Pro, Max)

• Otevřete Claude na webu a přihlaste se účtem používaným v telefonu.
• V Customize → Connectors zvolte + → Add custom connector.
• Zadejte název Stafio a adresu https://mcp.stafio.cz/.
• U ověření zvolte Sign in when needed (nebo Sign in now) a jako OAuth klienta Use Claude's published identity (nebo Register automatically). Client ID a Client Secret nevyplňujte. Dokončete přidání tlačítkem Add.
• U konektoru klikněte na Connect. Otevře se stránka Připojení k účtu Stafio; zadejte své uživatelské jméno a heslo do Stafia a zvolte Povolit přístup. Zapomenuté heslo obnovíte na login.stafio.cz.
• V aplikaci Claude na telefonu otevřete nový chat. V nabídce + → Connectors zapněte Stafio a ověřte volání nástroje podle kroku 5.

Na tarifu Free lze přidat jen jeden vlastní konektor.

Claude Team a Enterprise

• Vlastní konektor přidává jen vlastník organizace (v Enterprise také role se správou knihoven organizace) v Organization settings → Connectors → Add → Custom → Web. Adresu a ověření vyplní stejně jako výše; API klíč nezadává.
• Každý člen pak konektor najde v Customize → Connectors se štítkem Custom, klikne na Connect a přihlásí se svým účtem Stafia. Asistent pak vidí a smí měnit jen to, co tento člověk ve Stafiu. Kdo účet ve Stafiu nemá, se nepřipojí.

Co připojení ve Stafiu založí

• Každé připojení založí uživateli API klíč AI konektor: <název asistenta>, například „AI konektor: Claude“. Uživatel ho vidí v Profil → API klíče, správce na detailu uživatele.
• Zakázáním nebo smazáním tohoto klíče připojení zrušíte, nejpozději do hodiny.
• Asistent si přihlášení obnovuje sám. Pokud konektor 90 dní nepoužije, je potřeba se znovu připojit tlačítkem Connect.

Postup a dostupnost vzdáleného připojení popisuje oficiální návod Claude, nastavení přihlášení a hlaviček návod k vlastním konektorům. Konektor musí být dostupný z cloudu Anthropic, nikoli jen z telefonu nebo přes firemní VPN.

3. Claude: API klíč v hlavičce

Tento způsob použijte, jen když nechcete nebo nemůžete použít OAuth.

• Ve Stafiu otevřete Profil → API klíče → Nový API klíč. Administrátor může klíč založit na detailu uživatele. Pro každého asistenta vytvořte samostatný klíč s jasným popisem.
• Zkopírujte hodnotu klíče, dokud je viditelná. AI pracuje s právy uživatele, kterému klíč patří; správce musí povolit potřebné operace a data.
• V Claude přidejte konektor jako v kroku 2, ale u ověření zvolte No sign-in. V části Request headers přidejte hlavičku x-api-key, jako hodnotu vložte API klíč a označte ji jako povinnou (Required).

Ověření ani hlavičky nelze u přidaného konektoru změnit; při výměně klíče konektor odeberte a přidejte znovu. Část Request headers je podle Anthropic zatím v betě a dostupná jen pro část organizací; pokud ji v dialogu nevidíte, použijte OAuth.

API klíč je tajný a v organizaci sdílený

Vkládejte ho pouze do nastavení důvěryhodného konektoru, ne do zprávy AI, tiketu nebo snímku obrazovky. Při úniku klíč ve Stafiu zakažte nebo smažte a vytvořte nový. V Claude Team a Enterprise se hodnota hlavičky ukládá jednou pro celý konektor: všichni členové pracují pod stejným klíčem, tedy s právy jednoho uživatele Stafia, a vidí totéž co on. Má-li každý vidět jen to, co smí ve Stafiu, použijte OAuth.

4. ChatGPT: přihlášení přes OAuth

Podle dokumentace OpenAI umí ChatGPT na webu u vlastního MCP serveru přihlášení přes OAuth. API klíč ani vlastní hlavičku zadat neumí, proto pro Stafio použijte jen OAuth.

• Otevřete chatgpt.com/plugins, zvolte + → Add custom MCP server a zadejte název Stafio.
• V části Connection zadejte jako Server URL adresu https://mcp.stafio.cz/.
• U Authentication zvolte OAuth; Client ID a Client Secret nevyplňujte.
• Potvrďte upozornění volbou I understand and want to continue a zvolte Create as a plugin.
• Plugin najdete mezi osobními pluginy; před použitím ho nainstalujte. Při prvním použití nástroje vás ChatGPT přesměruje na stránku Připojení k účtu Stafio, kde se přihlásíte svým účtem.

Ve firemním pracovním prostoru platí pravidla jeho správce a zveřejnit plugin pro celý pracovní prostor smí jen správce. Každý uživatel se pak přihlašuje sám.

Zdroje: vlastní MCP server v ChatGPT a ověřování MCP v ChatGPT.

5. Ověřte skutečný přístup

Zadejte například: „Použij Stafio a ukaž mi dostupný přehled směn na dnešek. Nic neměň.“ Ověřte, že asistent skutečně zavolal nástroj Stafia a výsledek odpovídá vašemu účtu. Pouhý seznam nástrojů nepotvrzuje přihlášení.

Nástroje Stafio MCP data nejen čtou: asistent umí založit nebo změnit osobu, smlouvu, směnu a uživatele, rezervovat, obsadit nebo uvolnit směnu, potvrdit rezervaci nebo z ní udělat náhradníka, ohodnotit spokojenost, schválit směnu i výkaz práce, poslat smlouvu k podpisu a poslat pracovníkovi SMS nebo e-mail. Každý zapisovací nástroj asistenta vede k tomu, aby akci nejdřív zopakoval a počkal na váš souhlas; přesto operace měnící data schvalujte až po kontrole jejich rozsahu a klíč dávejte jen účtu s právy, která má asistent skutečně mít.

Když připojení nefunguje

• Neplatné jméno nebo heslo — zadejte stejné údaje jako při přihlášení do Stafia. Zapomenuté heslo obnovíte na login.stafio.cz. Po 10 neúspěšných pokusech počkejte 15 minut.
• AI asistenta může připojit jen uživatel Stafia — pracovníci a klienti se připojit nemohou.
• Pro vaši instanci Stafia zatím připojení AI asistenta není zapnuté — přihlášení přes OAuth je zapnuté na instancích devel, quality, beta, gamma, ppm, student a blahovec. Pro ostatní se obraťte na podporu Stafia.
• Žádost o přihlášení vypršela — přihlašovací stránka platí 10 minut. Spusťte připojení v asistentovi znovu.
• Asistent žádá o nové připojení — klíč „AI konektor“ ve Stafiu byl zakázán nebo smazán, nebo se konektor 90 dní nepoužil. Připojte se znovu.
• Invalid API key — týká se klíče v hlavičce. Ověřte úplnost, platnost a povolení klíče ve Stafiu. Současná implementace jeho výměny prochází instance devel, quality, alpha, beta, gamma, blahovec, student, nat, hrportals a ppm. Klíče ostatních instancí musí řešit správce MCP.
• Invalid or malformed JWT / vypršel token — odpojte a znovu připojte konektor, aby vznikla nová relace. Token z klíče se váže na MCP relaci.
• Chybí oprávnění nebo data — správce ověří práva účtu ve Stafiu.
• Chyba po otevření URL v prohlížeči — kořen serveru očekává přihlášenou MCP relaci; prosté otevření v prohlížeči vrátí {"error":"unauthorized"}. Není to přihlašovací stránka. Provozní stav správce ověří na /health a /ready.
• Chybí konektor v mobilu — ověřte, že jste v aplikaci přihlášeni stejným účtem jako na webu a že je konektor v chatu zapnutý.

Související

• Stafio API pro napojení vlastního systému
• AI ve Stafiu — co umí vestavěný chat a návrhy odpovědí