# Lokální spuštění MCP serveru

> Spusťte open-source balíček @emailit/emailit-mcp přes stdio nebo lokální HTTP s API klíčem a nastavte pro něj Claude, Cursor a VS Code.

`@emailit/emailit-mcp` je open-source verze MCP serveru Emailitu. Běží na vašem počítači, s API Emailitu komunikuje přes váš API klíč a funguje s klienty, kteří podporují jen lokální servery (stdio). Většina lidí by měla použít spíš [hostovaný server](/cs/docs/mcp/); tato stránka vysvětluje, kdy má lokální balíček smysl a jak ho nastavit.

- **Balíček:** [`@emailit/emailit-mcp`](https://www.npmjs.com/package/@emailit/emailit-mcp) na npm
- **Zdrojový kód:** [github.com/emailit/emailit-mcp](https://github.com/emailit/emailit-mcp), licence MIT
- **Běhové prostředí:** Node.js 18 nebo novější

## Lokální, nebo hostovaný

| | Lokální balíček | Hostovaný server |
| --- | --- | --- |
| Kde běží | Na vašem počítači, spouští ho váš MCP klient | Na `https://api.emailit.com/mcp` |
| Přihlášení | Jen API klíč | OAuth nebo API klíč |
| Nástroje | Původní sada: e-maily, domény, API klíče, seznamy kontaktů, kontakty, šablony, blokované adresy a webhooky | 109, celé API v2 včetně kampaní, automatizací, formulářů, DMARC, ověřování a událostí |
| Workspace | Workspace API klíče | S OAuth více workspace na jedno připojení, vybírané pro každý požadavek |
| Role a oprávnění | Oprávnění API klíče | Vaše role v každém workspace a schválené oprávnění |
| Výchozí odesílatel a adresa pro odpověď | Lze nastavit | Není k dispozici; asistent předává `from` při každém odeslání |
| Aktualizace | Verzi, kterou spouštíte, máte pod kontrolou | Automatické |

Lokální balíček zvolte, když:

- váš klient podporuje jen servery přes stdio nebo neumí OAuth pro vzdálené servery,
- chcete, aby se ke každému odeslání použila výchozí adresa odesílatele a adresa pro odpověď, nebo
- chcete kód serveru číst, zafixovat jeho verzi nebo ho upravit.

## Než začnete

- [Node.js](https://nodejs.org) 18 nebo novější, aby byl k dispozici `npx`.
- [API klíč](/cs/docs/developers/api-keys/). Pokud asistent potřebuje jen odesílat, použijte klíč jen pro odesílání omezený na jednu doménu; ostatní nástroje potřebují klíč s plným přístupem.
- [Ověřená odesílací doména](/cs/docs/domains/add-a-domain/) pro adresu odesílatele.

## Nastavte klienta

Klient spouští server jako podproces a komunikuje s ním přes stdio. API klíč předejte v proměnné prostředí `EMAILIT_API_KEY`.

**Claude Code**

```bash
claude mcp add emailit \
  -e EMAILIT_API_KEY=secret_•••••••• \
  -e SENDER_EMAIL_ADDRESS=hello@acme.com \
  -- npx -y @emailit/emailit-mcp
```

**Claude Desktop**

  Otevřete **Settings > Developer > Edit Config**, přidejte server do `claude_desktop_config.json` a pak Claude Desktop restartujte:

```json title="claude_desktop_config.json"
{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_••••••••",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

**Cursor**

  Přidejte server do `~/.cursor/mcp.json`, nebo do `.cursor/mcp.json` v projektu:

```json title="~/.cursor/mcp.json"
{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "secret_••••••••",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

**VS Code**

  Přidejte server do `.vscode/mcp.json`. VS Code si o klíč řekne a bezpečně ho uloží:

```json title=".vscode/mcp.json"
{
  "inputs": [
    { "type": "promptString", "id": "emailit-api-key", "description": "Emailit API key", "password": true }
  ],
  "servers": {
    "emailit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "${input:emailit-api-key}",
        "SENDER_EMAIL_ADDRESS": "hello@acme.com"
      }
    }
  }
}
```

Vždy používejte celý název balíčku včetně scope: `@emailit/emailit-mcp`.

## Proměnné prostředí

| Proměnná | Povinné | Popis |
| --- | --- | --- |
| `EMAILIT_API_KEY` | Pro stdio | Váš API klíč Emailitu. V režimu HTTP posílají klienti místo toho vlastní klíč. |
| `SENDER_EMAIL_ADDRESS` | Ne | Výchozí adresa odesílatele na ověřené odesílací doméně. |
| `REPLY_TO_EMAIL_ADDRESSES` | Ne | Výchozí adresy pro odpověď oddělené čárkami. |
| `MCP_PORT` | Ne | Port pro režim HTTP. Výchozí hodnota je `3000`. |

Pokud odesílatele nenastavíte, server se při každém odeslání zeptá asistenta na adresu odesílatele.

## Přepínače příkazového řádku

Přepínače mají přednost před odpovídajícími proměnnými prostředí.

| Přepínač | Popis |
| --- | --- |
| `--key <key>` | API klíč pro režim stdio. |
| `--sender ` | Výchozí adresa odesílatele. |
| `--reply-to ` | Výchozí adresa pro odpověď. Pro více adres přepínač zopakujte. |
| `--http` | Místo stdio poskytuje Streamable HTTP. |
| `--port ` | Port pro `--http`. Výchozí hodnota je `3000` nebo `MCP_PORT`. |
| `-h`, `--help` | Vypíše nápovědu k použití. |

## Spusťte server přes HTTP

Pokud chcete jeden lokální server sdílet mezi několika klienty, spusťte ho v režimu HTTP:

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

Server naslouchá na `http://127.0.0.1:3000/mcp` a je dostupný jen z vašeho počítače. Každý klient se autentizuje vlastním API klíčem jako bearer tokenem:

```bash
claude mcp add emailit --transport http http://127.0.0.1:3000/mcp \
  --header "Authorization: Bearer $EMAILIT_API_KEY"
```

## Spusťte server ze zdrojového kódu

```bash
git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install
EMAILIT_API_KEY=secret_•••••••• node src/index.js
```

Pro režim HTTP přidejte k poslednímu příkazu `--http --port 3000`.

## Řešení problémů

| Problém | Řešení |
| --- | --- |
| `API key is required for stdio mode. Use --key or set EMAILIT_API_KEY.` | Přidejte `EMAILIT_API_KEY` do bloku `env` v konfiguraci klienta. |
| Klient nemůže spustit `npx` | Desktopové aplikace nevidí vždy `PATH` vašeho shellu. Jako `command` použijte úplnou cestu k `npx` (zjistíte ji příkazem `which npx`). |
| `Domain not verified` při odesílání | Použijte odesílatele na [ověřené doméně](/cs/docs/domains/verification/), nebo na takového odesílatele nastavte `SENDER_EMAIL_ADDRESS`. |
| Chyby oprávnění u nástrojů, které neodesílají | Klíč je jen pro odesílání. Pro domény, šablony, kontakty a další nástroje použijte klíč s plným přístupem. |
| Naplánovaný e-mail nejde zrušit | Naplánované e-maily lze zrušit nebo přeplánovat nejpozději 3 minuty před časem odeslání. |

## Související

  - [Přehled MCP serveru](/cs/docs/mcp/): Hostovaný vs. lokální server, oprávnění a zabezpečení.
  - [Reference nástrojů](/cs/docs/mcp/tools/): Všechny hostované nástroje a jejich argumenty.
  - [API klíče](/cs/docs/developers/api-keys/): Vytvořte klíč pro server.
  - [Další klienti](/cs/docs/mcp/other-clients/): Připojte editory k hostovanému serveru.

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