Сервер MCP Omnisend

Сервер Model Context Protocol (MCP), интегрируемый с Omnisend API V5, написанный на TypeScript.

Версия: 2.2.0

Функции

Управление контактами (список, создание, получение, обновление)
Управление продуктами (список, создание, получение, замена, удаление)
Отслеживание событий
Управление категориями продуктов
Поддержка постраничной навигации на основе курсора со следующими/предыдущими URL-адресами и информацией об ограничениях/смещениях

Related MCP server: MCP Personal Assistant Agent

Изменения в версии 2.2.0

Реорганизованная кодовая база с приданием ей более модульной структуры
Реализованы доменно-зависимые модули (контакты, продукты, категории, события)
Организованный код в логические каталоги (/types, /filters, /api-resources, /resources, /tools)
Сделал версию сервера динамической в инструменте ping
Добавлена улучшенная обработка ошибок в запросах API.
Улучшена поддержка кода с помощью экспорта стволов
Удален избыточный и дублирующийся код

Изменения в версии 2.1.0

Обновлено до @modelcontextprotocol/sdk v1.11.0
Улучшенная обработка ошибок во всем приложении
Повышенная стабильность API с улучшенными сообщениями об ошибках
Добавлена настройка времени ожидания запроса для предотвращения зависания соединений.
Исправлены проблемы с подключением SSE к MCP Inspector.
Оптимизирован вывод консоли для совместимости с клиентами MCP
Добавлен контекст пагинации на основе курсора в ответах MCP (следующие/предыдущие URL, ограничение/смещение)

Изменения в версии 2.0.0

Перенесена вся кодовая база на TypeScript
Обновленная структура ресурсов MCP в соответствии с последней спецификацией
Добавлены правильные объявления типов для всех ответов и запросов API.
Улучшенная обработка ошибок с типизированными исключениями
Улучшенная организация кода и удобство его обслуживания

Установка

npm install

Здание

Для компиляции кода TypeScript:

npm run build

Работа в режиме разработки

Для разработки с автоперезагрузкой:

npm run dev

Конфигурация

Создайте файл .env в корневом каталоге с вашим ключом API Omnisend:

OMNISEND_API_KEY=your_api_key_here OMNISEND_API_URL=https://api.omnisend.com/v5

Использование

Чтобы запустить сервер MCP:

npm start

Взаимодействие с сервером MCP

Сервер MCP предназначен для использования с клиентами, которые понимают Model Context Protocol. Вот способы взаимодействия с ним:

Интеграция VS-кода

Для использования с VS Code предоставляется файл конфигурации в .vscode/mcp.json . VS Code с соответствующим расширением MCP может взаимодействовать с этим сервером.

Помощники ИИ

Помощники на основе искусственного интеллекта, такие как Claude, которые поддерживают MCP, могут взаимодействовать с этим сервером для доступа к данным Omnisend и выполнения операций.

Использование с Claude Desktop

Чтобы использовать этот MCP-сервер с Claude Desktop:

Загрузите и установите Claude Desktop с официального сайта .
Убедитесь, что в вашей системе установлен Node.js. Вы можете проверить это, запустив:
node --version
Если Node.js не установлен, загрузите его с nodejs.org .
Откройте меню Claude на вашем компьютере и выберите «Настройки...».
Нажмите «Разработчик» в левой панели панели настроек, а затем нажмите «Изменить конфигурацию».
Это откроет ваш файл конфигурации Claude Desktop. Замените содержимое файла или добавьте следующую конфигурацию:
{ "mcpServers": { "omnisend": { "command": "node", "args": [ "/path/to/dist/index.js" ], "env": { "OMNISEND_API_KEY": "your_api_key_here" } } } }
Обязательно замените your_api_key_here на ваш фактический ключ API Omnisend.
Сохраните файл конфигурации и перезапустите Claude Desktop.
После перезапуска вы увидите значок молотка в правом нижнем углу поля ввода.
Нажмите на значок молотка, чтобы увидеть доступные инструменты Omnisend.
Теперь вы можете попросить Клода выполнить такие операции, как:
- «Список моих последних контактов в Omnisend»
- «Создать новый продукт в моем каталоге Omnisend»
- «Отправить событие клиента в Omnisend»

Пользовательские клиенты MCP

Вы можете разрабатывать собственные клиенты, используя библиотеку @modelcontextprotocol/sdk :

import { McpClient } from '@modelcontextprotocol/sdk/client/mcp'; import { ProcessClientTransport } from '@modelcontextprotocol/sdk/client/process'; const transport = new ProcessClientTransport(serverProcess); const client = new McpClient(transport); // Connect to the server await client.connect(); // Execute tools const result = await client.executeTool("listContacts", { limit: 10 });

API-документация

Более подробную информацию об API Omnisend можно найти в официальной документации .

Лицензия

Данный проект лицензирован в соответствии с лицензией Apache License 2.0 — подробности см. в файле LICENSE .

Omnisend MCP Server