Návod
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; tato stránka vysvětluje, kdy má lokální balíček smysl a jak ho nastavit.
- Balíček:
@emailit/emailit-mcpna npm - Zdrojový kód: 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 18 nebo novější, aby byl k dispozici
npx. - API klíč. 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 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 mcp add emailit \
-e EMAILIT_API_KEY=secret_•••••••• \
-e SENDER_EMAIL_ADDRESS=hello@acme.com \
-- npx -y @emailit/emailit-mcpOtevřete Settings > Developer > Edit Config, přidejte server do claude_desktop_config.json a pak Claude Desktop restartujte:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Přidejte server do ~/.cursor/mcp.json, nebo do .cursor/mcp.json v projektu:
{
"mcpServers": {
"emailit": {
"command": "npx",
"args": ["-y", "@emailit/emailit-mcp"],
"env": {
"EMAILIT_API_KEY": "secret_••••••••",
"SENDER_EMAIL_ADDRESS": "hello@acme.com"
}
}
}
}Přidejte server do .vscode/mcp.json. VS Code si o klíč řekne a bezpečně ho uloží:
{
"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 <email> |
Výchozí adresa odesílatele. |
--reply-to <email> |
Výchozí adresa pro odpověď. Pro více adres přepínač zopakujte. |
--http |
Místo stdio poskytuje Streamable HTTP. |
--port <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:
npx -y @emailit/emailit-mcp --http --port 3000Server 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:
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
git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install
EMAILIT_API_KEY=secret_•••••••• node src/index.jsPro 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ě, 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í. |