Co vidíte
Externí nástroj připojený k Ceum přes MCP — Claude Desktop, Cursor nebo vlastní klient — se nemůže ověřit. Volání, která dříve fungovala, začnou selhávat s chybami oprávnění.
Proč se to děje
Nejčastější důvody:
- Token byl odvolán. Někdo (možná dříve vy sami) odvolal token v sekci Integrace. Odvolané tokeny už nelze znovu použít — bude potřeba vytvořit nový.
- Token nebyl nikdy zkopírován. Při vytvoření tokenu se jeho úplná hodnota zobrazí pouze jednou. Pokud jste dialog zavřeli bez zkopírování, je hodnota nenávratně ztracena a nelze ji obnovit.
- Externí nástroj používá starý token. V Ceum byl vytvořen nový token, ale externí nástroj je stále nastaven na předchozí.
- Účet byl smazán. Pokud osoba, která token vytvořila, smazala svůj účet, zanikly s ním všechny její tokeny. Tokeny patří jedinému účtu.
- Externí nástroj je nesprávně nastaven. Míří na špatnou adresu nebo je pro vaše připojení nastaven chybně.
- Nástroj nemá oprávnění nebo je záznam mimo rozsah. Token má pouze ty nástroje, které jste mu udělili, a token s omezeným rozsahem je vázán na konkrétní klienty a/nebo projekty. Volání nástroje, který jste neudělili, nebo záznamu mimo rozsah tokenu je odmítnuto, i když je samotný token platný — v sekci Integrace a MCP můžete rozšířit jeho oprávnění nebo rozsah.
- Token s omezeným rozsahem nevidí vůbec nic. Rozsah vyžaduje, aby záznam odpovídal současně pravidlům pro klienty i projekty. Pokud jste omezili klienty na jednu množinu a projekty na jinou, které se nepřekrývají, žádný záznam nesplňuje obojí, takže se vše jeví jako prázdné nebo „mimo rozsah“. Nastavte jeden z rozměrů zpět na „Vše“ nebo zařiďte, aby se oba seznamy povolených překrývaly.
Jak to opravit
- Otevřete Integrace a najděte token v seznamu. Pokud chybí nebo je označen jako odvolaný, již není platný — vytvořte nový.
- Zkopírujte nový token z dialogu před jeho zavřením. Hodnotu nelze získat později.
- Aktualizujte konfiguraci externího nástroje novým tokenem a nástroj restartujte.
- Zkontrolujte čas posledního použití tokenu na stránce Integrace. Poté, co externí nástroj provede volání, by se měl tento čas aktualizovat — pokud se tak nestane, volání se k Ceum nedostává.
- Porovnejte Relace a události MCP s případnými úspěšnými voláními za poslední hodinu a srovnejte je s vlastním protokolem chyb vašeho nástroje, abyste zjistili, kde se připojení přerušuje.
Tipy a okrajové případy
- Názvy tokenů zůstávají i po odvolání. Starší záznamy v protokolu událostí MCP stále zobrazují název odvolaného tokenu; to je očekávané a neznamená to, že token stále funguje.
- Při podezření na únik token preventivně vyměňte. Nejprve vytvořte nový token, přepněte na něj svůj nástroj, ověřte, že změna projde, a teprve poté odvolejte starý token. Vyhnete se tak výpadku, kdy nefunguje ani jeden token.
- Volání pouze pro čtení se nezaznamenávají. Token může bez problémů fungovat pro čtení, i když protokol událostí MCP nic nezobrazuje — prázdný protokol tedy neznamená, že je token nefunkční.
- Vestavěné CLI je samostatné. Příkazová paleta CLI uvnitř Ceum používá vaše vlastní přihlášení, nikoli token MCP, takže nikdy neselže z důvodu „odvolaného tokenu“.
Na mobilu
V mobilní aplikaci není k dispozici — spravuje se z webové aplikace.