MCP server Emailitu

MCP server Emailitu propojuje AI asistenty s vaším účtem v Emailitu přes Model Context Protocol. Běžnou řečí požádejte o odeslání e-mailu, přidání a ověření domény, zjištění, proč se zpráva nedoručila, sestavení seznamu kontaktů nebo spuštění kampaně a asistent zavolá odpovídající nástroj Emailitu.

Server hostuje Emailit. Nic nemusíte instalovat ani vkládat API klíč: přihlásíte se do Emailitu v prohlížeči, vyberete workspace, které smí asistent používat, a schválíte přístup.

Připojte svůj AI nástroj

Do jakéhokoli jiného MCP klienta přidejte vzdálený server (Streamable HTTP) s URL https://api.emailit.com/mcp. Klienti, kteří podporují autorizaci MCP, najdou přihlášení automaticky přes výše uvedenou URL pro discovery, takže jim adresa serveru stačí.

Pluginy Emailit pro ChatGPT, Codex, Claude Code, Cursor a Grok přidávají k serveru dovednosti: návody, které asistenta naučí nastavovat domény, řešit doručitelnost, spouštět kampaně, ověřovat webhooky a vybrat SDK.

Co se stane při připojení

1. Přihlaste se. Váš AI nástroj otevře přihlašovací stránku Emailitu. Zadejte e-mail a heslo, a pokud používáte dvoufázové ověření, také kód z ověřovací aplikace.

2. Vyberte workspace. Zvolte All my workspaces, což zahrnuje i workspace, které vytvoříte nebo ke kterým se připojíte později, nebo Only these workspaces se zaškrtnutými workspace. Pokud jich povolíte víc, vyberte, ve kterém nástroj začne.

3. Povolte přístup. Zkontrolujte přístup, o který nástroj žádá (sending, nebo full), a vyberte Allow access.

Nástroj dostane přístupový token platný 15 minut a obnovovací token, díky kterému zůstane připojený, dokud není 60 dní neaktivní. Obnovovací tokeny se při každém použití vymění a opakované použití starého tokenu připojení odvolá. Každé připojení se zobrazí v Account›Connected apps.

Více workspace

Jedno připojení pokrývá všechny workspace, které jste povolili, takže můžete z jednoho chatu spravovat několik značek nebo klientských účtů. Uveďte workspace v požadavku:

„V Acme Client vypiš domény.“

Asistent předá workspace: "Acme Client" jen tomuto jednomu volání nástroje. Přijímá ID workspace nebo jeho přesný název a nemění výchozí workspace připojení, takže si dva chaty, které současně pracují v různých workspace, nepřekážejí.

• „Které workspace v Emailitu můžeš používat?“ vypíše povolené workspace a vaši roli v každém z nich.
• „Přepni na můj workspace Marketing“ změní výchozí workspace pro další požadavky, které workspace neuvádějí.
• Pokud chcete workspace přidat nebo odebrat, otevřete Account›Connected apps a zvolte Edit access. Změny platí od dalšího požadavku aplikace, bez nového připojení.
• Pokud workspace opustíte nebo vás z něj někdo odebere, ztratí k němu přístup i aplikace.

Nástroj pracuje s vaší rolí v každém workspace, stejně jako webové rozhraní: členové s rolí Member nemohou spravovat API klíče ani mazat domény. Viz Workspace a oprávnění.

Úrovně přístupu

Většina AI nástrojů žádá o obě oprávnění. Pokud připojení bez full zavolá nástroj, který ho potřebuje, nástroj vrátí chybu s výzvou, abyste se znovu připojili s plným přístupem. Klienti, kteří podporují dodatečnou autorizaci, jako je ChatGPT, znovu zobrazí schvalovací obrazovku.

Zkraťte seznam nástrojů

Někteří klienti omezují, kolik nástrojů načtou. Pokud chcete zpřístupnit méně nástrojů, přidejte tyto volby do URL serveru, nebo je pošlete jako hlavičky:

Například https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true dá asistentovi přístup jen ke čtení e-mailů a domén. Nástroje pro workspace jsou vždy zahrnuté. Úplný seznam najdete na stránce Sady nástrojů a režim jen pro čtení.

Použijte místo toho API klíč

Servery, skripty, úlohy v CI a agenti bez rozhraní nemohou k přihlášení otevřít prohlížeč. Vytvořte API klíč a pošlete ho jako bearer token:

{
  "mcpServers": {
    "emailit": {
      "url": "https://api.emailit.com/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

API klíč je vázaný na workspace, ve kterém byl vytvořen, a k jiným workspace se nedostane. Server navíc vypisuje jen nástroje, které oprávnění klíče povoluje. V desktopových a chatovacích aplikacích dávejte přednost OAuth, protože klíč uložený v konfiguračním souboru může uniknout.

Odpojte aplikaci

Otevřete Account›Connected apps. Stránka uvádí všechny AI nástroje a aplikace, které jste schválili, s workspace, které mohou používat, s úrovní přístupu a s časem připojení. Pokud chcete změnit workspace aplikace, zvolte Edit access, a pokud jí chcete přístup odebrat, zvolte Revoke access: její tokeny okamžitě přestanou fungovat. Viz Připojené aplikace.

Zabezpečení

• Označené nástroje. Každý nástroj nese anotace MCP (read-only, destructive, open-world), takže se klienti mohou zeptat, než spustí cokoli, co zapisuje, maže nebo komunikuje s vnějším světem.
• Vestavěné instrukce. Server asistentům říká, aby před odesláním skutečného e-mailu potvrdili příjemce, odesílatele a obsah, aby ID dohledávali, a ne hádali, a aby se před smazáním nebo zrušením čehokoli zeptali.
• Nedůvěryhodný obsah. Těla e-mailů, pole kontaktů a odpovědi z formulářů mohou obsahovat text, který napsali jiní lidé. Než schválíte odeslání nebo smazání, zkontrolujte, co asistent plánuje udělat.
• Kontroly sítě. URL webhooků se kontrolují, aby požadavky nemohly mířit do privátních sítí.
• Platí vaše role. Asistenti nikdy nemohou v žádném workspace udělat víc než vy.
• Klíče nepatří do kódu. Nikdy necommitujte API klíče; pravidlo pro Cursor v pluginu Emailit na to agenta upozorňuje.

Další kroky