# MCP server Emailitu

> Připojte ChatGPT, Claude, Cursor, Codex, Grok a další AI nástroje k Emailitu přes hostovaný MCP server s přihlášením přes OAuth a celým API v2 jako nástroji.

MCP server Emailitu propojuje AI asistenty s vaším účtem v Emailitu přes [Model Context Protocol](https://modelcontextprotocol.io). 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.

| | |
| --- | --- |
| **URL serveru** | `https://api.emailit.com/mcp` |
| **Transport** | Streamable HTTP (bezstavový, `POST`) |
| **Přihlášení** | OAuth 2.1 s PKCE, nebo API klíč jako bearer token |
| **Nástroje** | 109 pro celé API v2 |
| **Metadata (discovery)** | `https://api.emailit.com/.well-known/oauth-protected-resource/mcp` |

## Připojte svůj AI nástroj

| Klient | Jak se připojit | Návod |
| --- | --- | --- |
| ChatGPT | Plugin Emailit | [ChatGPT](/cs/docs/mcp/chatgpt/) |
| Claude (claude.ai, Desktop a mobil) | Konektor Emailit | [Claude](/cs/docs/mcp/claude/) |
| Claude Code | Plugin Emailit nebo `claude mcp add` | [Claude Code](/cs/docs/mcp/claude/#claude-code) |
| Cursor | Plugin Emailit nebo tlačítko **Přidat Emailit do Cursoru** | [Cursor](/cs/docs/mcp/cursor/) |
| Codex | Plugin Emailit nebo `codex mcp add` | [Codex](/cs/docs/mcp/codex/) |
| Grok | Konektor na grok.com, plugin pro Grok Build nebo xAI API | [Grok](/cs/docs/mcp/grok/) |
| VS Code, Windsurf, Zed a další | URL vzdáleného MCP serveru | [Další klienti](/cs/docs/mcp/other-clients/) |

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](/cs/docs/mcp/plugins-and-skills/) 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í](/cs/docs/mcp/workspaces-and-permissions/).

## Úrovně přístupu

| Oprávnění | Co nástroj může dělat |
| --- | --- |
| `sending` | Odesílat, plánovat, přeplánovat, rušit, znovu odesílat a přeposílat e-maily. Kontrolovat a přepínat workspace. |
| `full` | Vše v API v2: domény, DMARC reporty, šablony, API klíče, seznamy kontaktů, kontakty, blokované adresy, webhooky, kampaně, automatizace, formuláře, ověřování e-mailů, události a vytváření workspace. |

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:

| Volba | Dotaz | Hlavička | Příklad |
| --- | --- | --- | --- |
| Jen některé sady nástrojů | `?toolsets=` | `X-MCP-Toolsets` | `emails,domains,events` |
| Skrýt zápisové nástroje | `?read_only=true` | `X-MCP-Readonly` | `true` |

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í](/cs/docs/mcp/toolsets/).

## 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íč](/cs/docs/developers/api-keys/) a pošlete ho jako bearer token:

```json title="mcp.json"
{
  "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](/cs/docs/account/connected-apps/).

> **Pozor:** Odebráním serveru z AI nástroje se jeho přístup v Emailitu neodvolá. K tomu použijte **Connected apps**.

## 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

  - [Reference nástrojů](/cs/docs/mcp/tools/): Všechny nástroje s jejich druhem, oprávněním a argumenty.
  - [Pluginy a dovednosti](/cs/docs/mcp/plugins-and-skills/): Co pluginy Emailit přidávají pro jednotlivé klienty.
  - [Workspace a oprávnění](/cs/docs/mcp/workspaces-and-permissions/): Přístup k workspace, role, oprávnění a tokeny.
  - [Řešení problémů](/cs/docs/mcp/troubleshooting/): Opravte problémy s přihlášením, oprávněním, workspace a načítáním nástrojů.

---
Zdroj: https://emailit.com/cs/docs/mcp/