Omnisend MCPサーバー
TypeScript で記述された、Omnisend API V5 と統合する Model Context Protocol (MCP) サーバー。
バージョン: 2.2.0
特徴
- 連絡先管理（リスト、作成、取得、更新）
- 製品管理（リスト、作成、取得、置換、削除）
- イベントトラッキング
- 製品カテゴリー管理
- 次の/前の URL と制限/オフセット情報を使用したカーソルベースのページネーションのサポート
バージョン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レスポンスとリクエストに適切な型宣言を追加しました
- 型付き例外によるエラー処理の改善
- 強化されたコード構成と保守性
インストール
建物
TypeScript コードをコンパイルするには:
開発モードで実行
自動リロードを使用した開発の場合:
構成
Omnisend API キーを使用してルート ディレクトリに.envファイルを作成します。
OMNISEND_API_KEY=your_api_key_here
OMNISEND_API_URL=https://api.omnisend.com/v5
使用法
MCP サーバーを起動するには:
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.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 });
APIドキュメント
Omnisend API の詳細については、公式ドキュメントを参照してください。
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。