Co je Emailit MCP Server?

Emailit MCP Server je open-source server pro Model Context Protocol, který propojuje AI asistenty přímo s Emailitem.

Umožňuje vám odesílat e-maily, spravovat kontakty, domény, šablony a další funkce pomocí přirozeného jazyka — přímo z Claude, Cursor nebo jakéhokoli klienta kompatibilního s MCP.

• Balíček: @emailit/emailit-mcp
• Runtime: Node.js 18+
• Licence: MIT
• Repozitář: github.com/emailit/emailit-mcp

Požadavky

• Emailit účet
• API klíč
• Ověřená odesílací doména
• Node.js 18 nebo novější

Režimy přenosu

Server podporuje dva režimy přenosu:

Stdio (výchozí)

MCP klient spustí server jako podproces a komunikuje přes standardní vstup/výstup. API klíč se předává prostřednictvím proměnné prostředí nebo argumentu příkazové řádky. Toto je nejjednodušší možnost a funguje se všemi hlavními klienty.

HTTP (Streamable HTTP)

Pro vzdálené nebo webové integrace běží server jako HTTP server pomocí Streamable HTTP transportu. Klienti se autentizují pro každou relaci předáním svého API klíče jako Bearer tokenu v hlavičce Authorization. Endpoint je dostupný na /mcp.

Instalace a konfigurace

Claude Code (Stdio)

claude mcp add emailit \
  -e EMAILIT_API_KEY=váš_api_klíč \
  -- npx -y @emailit/emailit-mcp

Claude Code (HTTP)

Nejprve spusťte server:

npx -y @emailit/emailit-mcp --http --port 3000

Poté ho zaregistrujte:

claude mcp add emailit \
  --transport http http://127.0.0.1:3000/mcp \
  --header "Authorization: Bearer váš_api_klíč"

Cursor (Stdio)

Otevřete paletu příkazů a vyberte Cursor Settings → MCP → Add new global MCP server, poté vložte:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "váš_api_klíč"
      }
    }
  }
}

Cursor (HTTP)

Spusťte server, poté přidejte:

{
  "mcpServers": {
    "emailit": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer váš_api_klíč"
      }
    }
  }
}

Claude Desktop (Stdio)

Otevřete Claude Desktop nastavení → Developer tab → Edit Config, poté vložte:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "váš_api_klíč"
      }
    }
  }
}

Možnosti příkazové řádky

Proměnné prostředí

Tip: Pokud nezadáte e-mailovou adresu odesílatele, MCP server se na ni zeptá při každém odesílání e-mailu.

Dostupné nástroje

Server poskytuje 47 nástrojů v 8 kategoriích.

E-maily (10 nástrojů)

Domény (6 nástrojů)

API klíče (5 nástrojů)

Publikum (5 nástrojů)

Kontakty (5 nástrojů)

Šablony (6 nástrojů)

Potlačení (5 nástrojů)

Webhooky (5 nástrojů)

Příklady použití

Odeslání jednoduchého e-mailu

Zeptejte se svého AI asistenta:

“Pošli uvítací e-mail na john@example.com s předmětem ‘Vítejte!’”

AI zavolá send-email s:

{
  "from": "hello@mojadomena.cz",
  "to": "john@example.com",
  "subject": "Vítejte!",
  "html": "<h1>Vítejte!</h1><p>Děkujeme za registraci.</p>"
}

Odeslání se šablonou a proměnnými

“Pošli šablonu welcome-email na sarah@example.com s jejím jménem Sarah.”

{
  "from": "hello@mojadomena.cz",
  "to": "sarah@example.com",
  "template": "welcome-email",
  "variables": { "name": "Sarah" }
}

Naplánování e-mailu

“Naplánuj připomínkový e-mail na team@company.com na zítra v 9 ráno.”

{
  "from": "pripominky@mojadomena.cz",
  "to": "team@company.com",
  "subject": "Připomínka denního standupu",
  "text": "Nezapomeňte na standup v 9:30!",
  "scheduled_at": "zítra v 9 ráno"
}

Odeslání s přílohami

“Pošli e-mail na accounting@company.com s přiloženým PDF faktury.”

{
  "from": "fakturace@mojadomena.cz",
  "to": "accounting@company.com",
  "subject": "Měsíční faktura",
  "html": "<p>Fakturu najdete v příloze.</p>",
  "attachments": [
    {
      "filename": "faktura-2026-05.pdf",
      "url": "https://example.com/faktury/2026-05.pdf"
    }
  ]
}

Správa domén

“Přidej mou doménu mail.example.com a ukaž mi DNS záznamy.”

AI zavolá create-domain a zobrazí požadované DNS záznamy, které musíte nakonfigurovat u svého DNS poskytovatele.

“Ověř mou doménu.”

AI zavolá verify-domain pro kontrolu DNS propagace a ohlásí stav ověření.

Správa kontaktů

“Přidej Jane Smith (jane@example.com) do publika aud_abc123.”

{
  "email": "jane@example.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "audiences": ["aud_abc123"]
}

Správa šablon

“Vytvoř šablonu newsletteru s aliasem monthly-newsletter.”

{
  "name": "Měsíční newsletter",
  "alias": "monthly-newsletter",
  "subject": "Měsíční přehled {{month}}",
  "html": "<h1>Přehled za {{month}}</h1>..."
}

Správa potlačení

“Potlač bounced@example.com kvůli příliš mnoha tvrdým odrazům.”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "příliš mnoho tvrdých odrazů"
}

Nastavení webhooků

“Vytvoř webhook, který pošle události doručení a odrazů na můj endpoint.”

{
  "name": "Sledování doručení",
  "url": "https://mojeapp.cz/webhooks/email",
  "events": ["email.delivered", "email.bounced"]
}

Bezpečnostní poznámky

• API klíče by nikdy neměly být uloženy ve verzovacím systému.
• V stdio režimu je API klíč uložen v konfiguraci MCP klienta.
• V HTTP režimu klienti předávají API klíč pro každou relaci přes Bearer token.
• URL webhooků jsou před vytvořením validovány proti SSRF.
• Operace mazání vyzývají AI, aby si od vás nejprve vyžádalo potvrzení.

Řešení problémů

“API key required for stdio mode” Nastavte proměnnou prostředí EMAILIT_API_KEY nebo předejte --key.

Doména není ověřena Nakonfigurujte DNS záznamy z výstupu create-domain, poté zavolejte verify-domain.

E-mail odmítnut / neodesílá se Ujistěte se, že je doména ověřena a adresa odesílatele používá tuto doménu.

Naplánovaný e-mail nelze zrušit Musí být alespoň 3 minuty před naplánovaným časem.

Opakování selhává Pouze tvrdě neúspěšné, chybné, zadržené nebo potlačené e-maily lze opakovat.

Lokální vývoj

git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install

# Spuštění v stdio režimu
EMAILIT_API_KEY=váš_klíč node src/index.js

# Spuštění v HTTP režimu
node src/index.js --http --port 3000

Pro více podrobností navštivte GitHub repozitář.