Řešení problémů
Řešení problémů s MCP
Opravte časté problémy s MCP serverem Emailitu, od přihlášení a chybějícího oprávnění po špatný workspace, nástroje jen pro roli Admin a klienty, kteří načítají příliš mnoho nástrojů.
Začněte tím, že se asistenta zeptáte: „Který workspace v Emailitu mám připojený?“ Asistent zavolá get-current-workspace a řekne vám workspace, vaši roli a udělený přístup, což vysvětlí většinu níže popsaných problémů.
Přihlašovací stránka hlásí, že klient je neznámý
Registrace klienta je zastaralá. Odeberte server Emailit ze svého AI nástroje a přidejte ho znovu, aby se zaregistroval nový klient.
Nástroj hlásí, že potřebuje plný přístup
Připojení bylo schváleno jen s oprávněním sending. Klienti, kteří podporují dodatečnou autorizaci, jako je ChatGPT, znovu zobrazí schvalovací obrazovku: schvalte přístup full. U ostatních klientů zrušte připojení v AccountConnected apps, připojte se znovu a schvalte plný přístup. S API klíčem použijte klíč s plným přístupem.
Změny se dějí ve špatném workspace
Uveďte workspace v požadavku, například „Ve workspace Marketing vypiš domény“, nebo asistenta požádejte o přepnutí: „Přepni na můj workspace Marketing“. API klíče vždy pracují ve workspace, ke kterému patří.
Chybí workspace
Připojení pokrývá jen workspace, které jste povolili. Otevřete AccountConnected apps, zvolte Edit access a workspace přidejte, nebo zvolte All workspaces. Pokud vás z workspace odebrali, požádejte administrátora, aby vás znovu pozval.
Nástroj hlásí, že potřebuje roli Admin
Chyba admin_role_required znamená, že v daném workspace máte roli Member a nástroj spravuje API klíče nebo maže doménu. Požádejte administrátora workspace, aby akci provedl, nebo aby vám změnil roli.
Klient ukazuje příliš mnoho nástrojů nebo je nedokáže načíst
Někteří klienti omezují počet nástrojů. Načtěte jen to, co potřebujete, pomocí ?toolsets= v URL serveru nebo hlavičky X-MCP-Toolsets, například https://api.emailit.com/mcp?toolsets=emails,domains. Viz Sady nástrojů a režim jen pro čtení.
E-mail se odmítne
Odesílatel musí používat ověřenou odesílací doménu. Požádejte asistenta, aby doménu zkontroloval nástrojem get-domain, publikoval chybějící záznamy a spustil verify-domain. Dokud váš workspace nemá produkční přístup, můžete odesílat jen na e-mailové adresy účtů členů workspace.
Opakované odeslání selže
Znovu odeslat lze jen nedoručené, neúspěšné, zablokované nebo zadržené e-maily, a to do 30 dní a jen dokud je jejich obsah uložený. Viz Opakované odeslání a přeposlání e-mailů.
Klient ukazuje „Method not allowed“
Server je bezstavový a přijímá jen požadavky POST. Aktualizujte klienta na verzi, která podporuje transport Streamable HTTP, nebo použijte lokální server přes stdio.
Klient vás stále žádá o přihlášení
Obnovovací token vypršel po 60 dnech bez použití, byl použit opakovaně, nebo bylo připojení odvoláno. Přihlaste se v klientovi znovu. Pokud se to opakuje, zajistěte, aby připojení v jednu chvíli používala jen jedna kopie klienta.
Stále si nevíte rady?
Zeptejte se na Discordu nebo napište na support@emailit.com a uveďte název klienta, nástroj, který selhal, a text chyby.