Omnisend MCPサーバー

TypeScript で記述された、Omnisend API V5 と統合する Model Context Protocol (MCP) サーバー。

バージョン: 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 の安定性の向上
接続のハングを防ぐためにリクエストタイムアウト設定を追加しました
MCP Inspector の SSE 接続の問題を修正しました
MCPクライアントと互換性があるようにコンソール出力を最適化しました
MCP レスポンスにカーソルベースのページネーションコンテキストを追加しました (次/前の URL、制限/オフセット)

バージョン2.0.0の変更点

コードベース全体をTypeScriptに移行しました
最新の仕様に従って更新されたMCPリソース構造
すべてのAPIレスポンスとリクエストに適切な型宣言を追加しました
型付き例外によるエラー処理の改善
強化されたコード構成と保守性

インストール

npm install

建物

TypeScript コードをコンパイルするには:

npm run build

開発モードで実行

自動リロードを使用した開発の場合:

npm run dev

構成

Omnisend API キーを使用してルートディレクトリに.envファイルを作成します。

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

使用法

MCP サーバーを起動するには:

npm start

MCPサーバーとのやり取り

MCPサーバーは、モデルコンテキストプロトコル（MCP）を理解するクライアントで使用するように設計されています。MCPサーバーとのやり取りは以下のとおりです。

VSコード統合

VS Code で使用するために、 .vscode/mcp.jsonに構成ファイルが提供されています。適切な MCP 拡張機能を持つ VS Code は、このサーバーと通信できます。

AIアシスタント

MCP をサポートする Claude などの AI アシスタントは、このサーバーと通信して 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実際の Omnisend API キーに置き換えてください。
設定ファイルを保存し、Claude Desktop を再起動します。
再起動後、入力ボックスの右下隅にハンマーのアイコンが表示されます。
利用可能な Omnisend ツールを表示するには、ハンマーアイコンをクリックします。
これで、Claude に次のような操作の実行を依頼できるようになりました。
- 「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 });