Claude a AI asistenti (MCP)

Frontmail provozuje vzdálený server Model Context Protocol. Připojte ho ke Claudovi (claude.ai, aplikace Claude, Cowork nebo Claude Code) a ptejte se třeba „Kolik e-mailů minulý týden odeslal kontaktní formulář?“ nebo „Vytvoř německou verzi šablony potvrzení objednávky“. Asistent prochází stejnými kontrolami oprávnění jako dashboard.

Připojení Clauda

1. V dashboardu otevřete Nastavení → AI asistenti a zkopírujte URL konektoru (https://mcp.frontmail.dev/mcp).
2. V Claudovi otevřete Nastavení → Konektory → Přidat vlastní konektor, vložte URL a klikněte na Připojit.
3. Otevře se souhlasová obrazovka Frontmailu. Vyberte organizace, se kterými smí asistent pracovat, a oprávnění (níže) a klikněte na Povolit přístup. Vrátíte se do Clauda.

Pro Claude Code: claude mcp add --transport http frontmail https://mcp.frontmail.dev/mcp a potom se přihlaste příkazem /mcp.

Oprávnění

Oprávnění	Co asistent může
Čtení šablon	seznam a obsah šablon, verze, rozdíly, jazykové varianty, ukázky integrace, náhledy, seznam e-mailových služeb (jen název a typ)
Tvorba a úprava šablon	vytváření, úpravy, návrat k verzím a mazání šablon a jazykových variant, strojový překlad klíčem vaší organizace
Statistiky	souhrn, vývoj v čase, čerpání kreditů, rozpad podle šablon nebo služeb
Zobrazení týmu	členové a čekající pozvánky
Správa týmu	pozvánky, změny rolí, odebírání členů
Statistiky celého Frontmailu	jen superadmini – viz níže

Každé volání musí projít oběma kontrolami:

• oprávněními, která jste připojení udělili, a jen pro vybrané organizace,
• vaší rolí v organizaci, přesně jako v dashboardu (Týmy a role). Čtenář, který udělí „Tvorba a úprava šablon“, šablony stejně upravovat nemůže; admin stále nemůže přidělit roli pro fakturaci. Změna role, odebrání z organizace nebo pozastavení platí hned od dalšího volání.

Konektor nikdy nezpřístupní fakturaci, klíče, nastavení zabezpečení, přístupové údaje služeb, historii zpráv ani kontakty (údaje příjemců), testovací odeslání, exporty ani smazání organizace. Změny provedené přes konektor se zapisují do auditního logu s via: mcp a názvem asistenta.

Statistiky pro superadminy

Tým Frontmailu může udělit Statistiky celého Frontmailu (využití a tržby napříč organizacemi, vyhledání a detail organizace, stav fronty odesílání, náklady na infrastrukturu). Jde jen o čtení a nabídne se jen, když:

• účet je superadmin se zapnutým dvoufázovým ověřením a
• přihlásili jste se během poslední hodiny (jinak vás souhlasová obrazovka požádá o nové přihlášení).

Náklady na infrastrukturu (v USD) spojují dva zdroje – zeptejte se třeba „Kolik nás tento měsíc stojí infrastruktura a co to táhne nahoru?“:

• AWS z Cost Exploreru (celý AWS účet): měsíc k dnešku, prognóza do konce měsíce, předchozí měsíc, rozpad podle služeb AWS a podle stage, denní náklady, rozpočet stage. Rozpad podle stage vyžaduje aktivovaný cost allocation tag sst:stage v AWS Billing → Cost allocation tags.
• Google Cloud (analytika v BigQuery) z exportu Cloud Billingu: podle služeb, projektů a dnů, po odečtení kreditů (free tier), s částkami i v měně fakturačního účtu. Export zapněte jednou: Cloud console → Billing → Billing export → BigQuery export → Standard usage cost, projekt frontmail-prod, dataset billing_export (vytvoří ho nasazení). Obsahuje data ode dne zapnutí.

Spolu s počtem e-mailů odeslaných v daném měsíci přehled ukáže cenu za 1 000 e-mailů. Cloudflare zahrnutý není. Data se zpožďují až o den a přehled se ukládá do mezipaměti na 6 hodin (každý dotaz na Cost Explorer stojí 0,01 USD).

Oprávnění vyprší 24 hodin po udělení; pro obnovení se připojte znovu. Odebrání příznaku superadmina ho ukončí okamžitě.

Odpojení

Nastavení → AI asistenti ukazuje všechny připojené asistenty s jejich oprávněními, organizacemi a posledním použitím. Odpojit přístup okamžitě zruší – přestanou platit všechny tokeny daného připojení. Smazání účtu odstraní všechna připojení.

Podrobnosti zabezpečení

• OAuth 2.1 s PKCE (S256) a dynamickou registrací klientů. Přijímají se jen návratové adresy Clauda (claude.ai, claude.com) a lokální adresy (localhost pro Claude Code a MCP Inspector), takže podvržená aplikace vaše povolení nezíská. Souhlasová obrazovka ukazuje, kam se vrátíte – pokračujte, jen pokud jste připojení právě spustili ze svého asistenta.
• Přístupové tokeny platí 1 hodinu; obnovovací tokeny se při každém použití mění a opakované použití starého tokenu připojení zruší. Připojení vyprší po 180 dnech.
• Tokeny se ukládají jen jako hashe. Samotný souhlas probíhá na app.frontmail.dev s vaším běžným přihlášením (včetně 2FA); MCP server vaši session nikdy nevidí.