Знайомтеся з MCP-сервером Emailit

Ми випускаємо Emailit MCP Server — сервер з відкритим кодом для Model Context Protocol, який надає ШІ-асистентам на кшталт Claude, Cursor та іншим MCP-сумісним клієнтам повний доступ до платформи Emailit. Надсилайте листи, керуйте контактами, налаштовуйте домени, створюйте шаблони — все це через природну мову.

Що це відкриває

Замість перемикання між вашим ШІ-асистентом і панеллю Emailit, тепер ви можете робити все з одного діалогу:

• “Надішли вітальний лист на sarah@example.com, використовуючи шаблон для нових користувачів” — ШІ обере потрібний шаблон, заповнить змінні та надішле лист.
• “Покажи всі листи, що повернулися цього тижня” — переглядайте листи, не виходячи з редактора.
• “Додай mail.example.com як домен для відправки та покажи DNS-записи” — створить домен і надасть точні записи для налаштування.
• “Запланируй нагадування команді на завтра о 9 ранку” — сервер розуміє природну мову планування на кшталт “завтра о 9 ранку” або “наступного понеділка о 14:00”.

MCP Server надає 47 інструментів у 8 категоріях: листи, домени, API-ключі, аудиторії, контакти, шаблони, блокування та вебхуки. Покриває весь Emailit API.

Як це працює

Model Context Protocol — це відкритий стандарт, який дозволяє ШІ-асистентам підключатися до зовнішніх сервісів через структурований інтерфейс інструментів. Emailit MCP Server реалізує цей протокол, тому будь-який сумісний клієнт може автоматично виявляти та викликати операції Emailit.

Є два способи підключення:

1. Stdio — Клієнт запускає сервер як підпроцес і спілкується через stdin/stdout. Це найпростіше налаштування, працює з Claude Code, Cursor та Claude Desktop.
2. HTTP — Сервер працює як окремий HTTP-сервіс з транспортом Streamable HTTP. Корисно для віддалених налаштувань, спільних середовищ або веб-клієнтів.

Початок роботи

Все, що потрібно — це обліковий запис Emailit, API-ключ та Node.js 18+.

Claude Code

claude mcp add emailit -e EMAILIT_API_KEY=ваш_api_ключ -- npx -y @emailit/emailit-mcp

Cursor

Відкрийте Налаштування Cursor → MCP → Додати новий глобальний MCP-сервер і вставте:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "ваш_api_ключ"
      }
    }
  }
}

Claude Desktop

Відкрийте Налаштування → Розробник → Редагувати конфігурацію і вставте той самий JSON-блок.

Це все. Після підключення ШІ автоматично виявить всі 47 інструментів, і ви зможете одразу їх використовувати.

Приклади

Ось кілька речей, які можна робити одразу:

Надсилання листів із шаблонами та змінними

“Надішли шаблон welcome-email на john@example.com з ім’ям John”

ШІ знаходить шаблон за псевдонімом, підставляє змінну {{name}} і надсилає:

{
  "template": "welcome-email",
  "to": "john@example.com",
  "variables": { "name": "John" }
}

Прикріплення файлів за URL

“Надішли місячний рахунок на accounting@company.com з PDF з нашого S3-сховища”

{
  "to": "accounting@company.com",
  "subject": "Місячний рахунок",
  "attachments": [
    {
      "filename": "invoice-2026-05.pdf",
      "url": "https://mybucket.s3.amazonaws.com/invoices/2026-05.pdf"
    }
  ]
}

Керування всією інфраструктурою відправки

“Створи нову аудиторію ‘Бета-користувачі’, додай туди jane@example.com, потім створи вебхук для отримання подій доставки”

ШІ об’єднує кілька інструментів — create-audience, create-contact та create-webhook — в одному діалозі.

Блокування та розблокування адрес

“Заблокуй bounced@example.com через забагато жорстких відмов, встанови термін дії 30 днів”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "забагато жорстких відмов",
  "keep_until": "2026-06-18T00:00:00Z"
}

Поради

• Встановіть відправника за замовчуванням. Передайте --sender ви@вашдомен.com або встановіть змінну середовища SENDER_EMAIL_ADDRESS, щоб ШІ не запитував адресу відправника щоразу.
• Використовуйте шаблони для повторюваних листів. Створюйте шаблони з {{змінними}} і посилайтеся на них за псевдонімом — це швидше та послідовніше, ніж писати HTML у чаті.
• Природне планування працює. Можна казати “завтра о 9 ранку”, “наступної п’ятниці опівдні” або передавати ISO 8601 timestamp — сервер обробляє обидва варіанти.
• Небезпечні операції захищені. Інструменти видалення просять ШІ підтвердити дію перед виконанням, тому ви не видалите домен чи контакт випадково.
• HTTP-режим для спільного використання. Якщо кілька учасників команди або сервісів потребують доступу, запустіть сервер у HTTP-режимі — кожен клієнт автентифікується своїм API-ключем через Bearer token.

Відкритий код

Emailit MCP Server має ліцензію MIT і доступний на GitHub. Це чистий JavaScript (ESM) без етапу збірки, залежить лише від чотирьох пакетів: @modelcontextprotocol/sdk, fastify, minimist та zod.

Внески та відгуки вітаються — створюйте issue або надсилайте PR.

Повна документація

Ми опублікували повний посібник з налаштування та довідник:

• Посібник Emailit MCP Server — Встановлення, конфігурація, всі 47 інструментів, приклади використання та усунення проблем

Почніть зараз

Встановіть MCP-сервер однією командою:

npx -y @emailit/emailit-mcp

Прочитайте повний посібник або перегляньте GitHub-репозиторій, щоб почати роботу.