@nitrosend/mcp

Опциональный stdio-мост для Nitrosend. Большинство клиентов должны подключаться напрямую к удалённому MCP-серверу Nitrosend по адресу https://api.nitrosend.com/mcp; этот пакет предназначен для клиентов с поддержкой только stdio и локальной разработки.

Все планы, включая бесплатные, дают полный доступ к общедоступной поверхности Nitrosend MCP/API/CLI. Лимиты по тарифам всё ещё применяются к объему отправки, количеству мест, разрешениям на действия ИИ и платным дополнениям. Бесплатный план включает 8 000 бесплатных писем на старте, затем 500 бесплатных писем каждый месяц.

Для Claude Desktop, Claude.ai и Claude Cowork используйте удалённый MCP connector UI. Не устанавливайте @nitrosend/cli или этот stdio bridge для стандартной настройки коннектора Claude.

Управляйте контактами, составляйте письма, создавайте автоматизированные потоки и запускайте кампании через естественный язык.

Для медиа-изображений, используемых в шаблонах или кампаниях, MCP должна координировать загрузку, а не переносить большие байты. Небольшие изображения, прикрепляемые к чату, можно использовать через nitro_ingest с kind=image и image_data; публичные изображения можно использовать image_url, когда требуется постоянство Nitro; более крупные локальные файлы следует загрузить через nitro_ingest(upload: {kind: "image", filename, content_type, byte_size, checksum}), отправлять байты в direct_upload.url через PUT, затем передать возвращённый signed_id в nitro_ingest.

Настройка клиентом

У большинства клиентов поддерживается OAuth — вход через ваш браузер, API-ключи не требуются.

Claude Code

claude mcp add --transport http nitrosend https://api.nitrosend.com/mcp

Или добавьте в .mcp.json:

{
  "mcpServers": {
    "nitrosend": {
      "type": "http",
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

OAuth-подключение выполняется автоматически при первом использовании.

Claude Desktop

Перейдите в Settings → Connections → Add Custom Connector и введите:

https://api.nitrosend.com/mcp

Claude.ai (web + mobile)

Перейдите в Settings → Connectors → Add custom connector и введите:

https://api.nitrosend.com/mcp

Cursor

Добавьте в .cursor/mcp.json:

{
  "mcpServers": {
    "nitrosend": {
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

Cursor обрабатывает Nitrosend как прямой удалённый MCP-сервер. При первом использовании запрашивает OAuth-подключение.

VS Code (Copilot)

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "nitrosend": {
      "type": "http",
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

VS Code автоматически использует OAuth через встроенный поток аутентификации MCP.

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "nitrosend": {
      "serverUrl": "https://api.nitrosend.com/mcp"
    }
  }
}

Windsurf поддерживает OAuth на уровне HTTP-серверов — войдите через ваш браузер при первом использовании.

Codex CLI

codex mcp add nitrosend --url https://api.nitrosend.com/mcp
codex mcp login nitrosend

Или добавьте в ~/.codex/config.toml:

[mcp_servers.nitrosend]
url = "https://api.nitrosend.com/mcp"

Затем выполните codex mcp login nitrosend для аутентификации через OAuth.

Zed

Добавьте в настройки Zed:

{
  "context_servers": {
    "nitrosend": {
      "url": "https://api.nitrosend.com/mcp"
    }
  }
}

Любой другой MCP-клиент

Если ваш клиент поддерживает транспорт HTTP/SSE, укажите:

https://api.nitrosend.com/mcp

Если ваш клиент поддерживает только stdio, используйте этот bridge-пакет с API key:

{
  "command": "npx",
  "args": ["-y", "@nitrosend/mcp"],
  "env": {
    "NITROSEND_API_KEY": "nskey_live_..."
  }
}

Получите API-ключ в разделе Бренд → API-ключи в панели управления Nitrosend.

Что вы можете делать

После подключения ваш агент сможет:

Читать — запрашивать контакты, сегменты, потоки, кампании и состояние учётной записи
Составлять — создавать письма с разделами, строить многошаговые потоки, настраивать кампании
Управлять — импортировать контакты, создавать сегменты, управлять списками и тегами
Доставлять — просматривать письма, запускать проверки на спам, отправлять тесты, утверждать и планировать кампании
Инсайты — просматривать метрики открытий/кликов/отписок и тенденции

Контекст учётной записи и бренда

Для OAuth-подключений Nitrosend хранит как текущий аккаунт, так и текущий бренд для каждого пользователя и OAuth-приложения. Попросите агента вызвать nitro_get_status сначала: ответ содержит current_account и available_accounts наряду с current_brand и available_brands.

Если задача относится к другому аккаунту, чем тот, что отображён, вызовите nitro_select_account с целевым account_id. Переключение вступает в силу при следующем вызове инструмента. Затем вызовите nitro_select_brand, чтобы выбрать бренд внутри этого аккаунта. Выбранный бренд сохраняется на протяжении сессии и обновлений токена до повторного переключения.

nitro_select_account и nitro_select_brand изменяют только активный MCP контекст. nitro_set_brand_kit редактирует Brand Kit для текущего бренда, такие как цвета, логотип, данные отправителя и голос.

Соединение по API key привязано к аккаунту и бренду API key и не может переключаться с помощью nitro_select_account или nitro_select_brand. Для развёртываний stdio-моста, которым обязательно нужен одном бренд, задайте NITROSEND_BRAND_SID; мост будет отправлять X-Brand-SID только при наличии этой переменной.

Переменные окружения

Переменная	Описание
NITROSEND_API_KEY	API key (nskey_live_...) — для stdio-транспорта
NITROSEND_BEARER_TOKEN	OAuth Bearer-токен — альтернатива API key
NITROSEND_BRAND_SID	Необязательный фиксированный бренд-override для stdio bridge. Отправляет X-Brand-SID только если задан.
NITROSEND_API_URL	Переопределение конечной точки API (по умолчанию: https://api.nitrosend.com/mcp)

Требования

Node.js 18+

Лицензия

MIT