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 a zdrojovém kódu 10. 9. 2026. Připojení na konkrétním zákaznickém účtu v mobilní aplikaci 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 pro iOS a Android: oficiální dokumentace popisuje vlastní MCP pro web. Podporu tohoto vlastního konektoru v nativní mobilní aplikaci nepotvrzuje; níže je postup pro webové ChatGPT. Samotné nastavení na webu není zárukou dostupnosti v mobilní aplikaci.

1. Připravte přístup ve Stafiu

• 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.
• Připravte adresu konektoru v tomto tvaru a zástupný text nahraďte svým klíčem:

https://mcp.stafio.cz/?api_key=<VAS_API_KLIC>

Endpoint Stafio MCP je kořenová cesta /. Nepřidávejte /mcp, /sse ani /api/agent. Server používá Streamable HTTP a v této verzi nemá OAuth. Pokud klient nabízí vlastní hlavičky, podporuje také X-API-Key; níže popsané webové formuláře využívají klíč v URL.

Adresa s klíčem je tajná

Vkládejte ji pouze do nastavení důvěryhodného konektoru, ne do zprávy AI, tiketu nebo snímku obrazovky. Může se uchovat v konfiguraci a provozních záznamech. Nesdílejte takto osobní konektor s celou organizací. Při úniku klíč ve Stafiu zakažte nebo smažte a vytvořte nový.

2. Claude: připojení a použití v telefonu

• 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 připravenou adresu s klíčem. OAuth Client ID a Client Secret nevyplňujte. Dokončete přidání.
• 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 4.

V Team a Enterprise musí konektor nejprve povolit vlastník organizace. Pokud formulář chybí nebo vyžaduje OAuth, předejte správci požadavek na podporovaný způsob připojení; údaje OAuth nelze nahradit API klíčem.

Postup a dostupnost vzdáleného připojení popisuje oficiální návod Claude. Konektor musí být dostupný z cloudu Anthropic, nikoli jen z telefonu nebo přes firemní VPN.

3. ChatGPT: nastavení přes web

• Otevřete ChatGPT na webu. Dostupnost vývojářského režimu závisí na účtu a pravidlech pracovního prostoru.
• V Settings → Security and login zapněte Developer mode.
• Otevřete Plugins, tlačítkem + vytvořte připojení a pojmenujte ho Stafio.
• Zadejte adresu s API klíčem. Pokud formulář nabízí způsob ověření, vyberte No Authentication: klient neprovádí OAuth, ale Stafio nadále ověřuje klíč v URL.
• Vytvořte připojení, zkontrolujte objevené nástroje a v novém chatu vyberte Stafio v nabídce nástrojů vývojářského režimu.

Pokud se Stafio v nativní aplikaci telefonu nenabízí, pokračujte ve webovém ChatGPT. Použití webu v telefonu závisí na dostupnosti tohoto rozhraní pro váš účet; tento návod neslibuje podporu nativní mobilní aplikace.

Zdroje: ChatGPT Developer mode a připojení MCP k ChatGPT.

4. 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í. Operace měnící data schvalujte až po kontrole jejich rozsahu.

Když připojení nefunguje

• Invalid API key — ověřte úplnost a platnost klíče. Současná implementace jeho výměny prochází jen instance devel, quality, alpha, beta, gamma 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á MCP relaci; prosté GET může vrátit „Invalid or missing session ID“. Není to přihlašovací stránka. Provozní stav správce ověří na /health a /ready.
• Chybí konektor v mobilu — ověřte účet a pracovní prostor; u ChatGPT použijte webový postup výše.

Související

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