Přejít na obsah
Dokumentace

Ř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ů.

Aktualizováno 2. 10. 2026

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.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.