Brevo MCP

🚀 Brevo MCP Server

📧 公式SDKを使用したClaudeとSmithery用の完全なBrevo API統合

この包括的なMCPサーバーは、公式の@getbrevo/brevo Node.js SDKを使用して、ClaudeにBrevoのマーケティングオートメーションプラットフォームへの完全なアクセスを提供します。Brevoの主要な機能を網羅する8つの整理されたツールを備えています。

✨ 主な機能

• 🔧 公式Brevo SDK - 最大限の互換性を得るために@getbrevo/brevoで構築されています
• 📧 メール操作 - トランザクションメール、テンプレート、トラッキング、イベント
• 📱 SMSとWhatsApp - SMSの送信、キャンペーンの管理、WhatsAppの統合
• 👥 コンタクト管理 - コンタクト、リスト、属性、一括操作
• 🎯 キャンペーン管理 - メールとSMSのキャンペーン、スケジューリング、分析
• 💬 会話管理 - チャットと会話の管理
• 🔗 Webhook - イベント駆動型の自動化と通知
• 🛒 電子商取引 - 注文、商品、カテゴリの統合
• 🏢 アカウント管理 - 送信者、ドメイン、フォルダ、アカウント情報
• 🚀 Smithery互換 - Smitheryへのデプロイが可能です
• 🛡️ 型安全 - 完全なTypeScriptサポート

🚀 クイックスタート

オプション1: Smitheryを使用する（推奨）

1. Smitheryで設定する:

   brevo-mcp:
     apiKey: "your-brevo-api-key"           # 必須
     defaultSenderEmail: "your@domain.com" # 任意
     defaultSenderName: "Your Name"        # 任意
   

オプション2: ローカルインストール

1. インストールする:

   npm install
   npm run build
   

2. 環境変数を設定する:

   export BREVO_API_KEY="your-brevo-api-key"
   export BREVO_DEFAULT_SENDER_EMAIL="your@domain.com"
   export BREVO_DEFAULT_SENDER_NAME="Your Name"
   

3. サーバーを起動する:

   npm start
   

💻 使用例

基本的な使用法

1. contacts - コンタクト管理

一括機能を備えた完全なコンタクトデータベース操作です。

操作:

• get - メールアドレス/IDでコンタクトを取得する
• create - 新しいコンタクトを作成する
• update - コンタクト情報を更新する
• delete - コンタクトを削除する
• bulk_import - コンタクトを一括インポートする
• export - コンタクトをエクスポートする
• add_to_list / remove_from_list - リスト管理
• get_lists / create_list - コンタクトリストを管理する
• get_attributes / create_attribute / update_attribute - カスタム属性

例:

{
  "operation": "bulk_import",
  "contacts": [
    {
      "email": "user1@example.com",
      "attributes": {
        "FIRSTNAME": "John",
        "LASTNAME": "Doe"
      }
    }
  ]
}

2. email - トランザクションメール

メールを送信し、テンプレートを管理し、配信とイベントをトラッキングします。

操作:

• send - トランザクションメールを送信する
• send_template - テンプレートを使用して送信する
• get_events - メールイベントをトラッキングする
• get_templates - メールテンプレートを一覧表示する
• create_template / update_template / delete_template - テンプレート管理
• get_blocked_domains - ブロックされたドメインを確認する
• get_email_statistics - メール分析

例:

{
  "operation": "send",
  "to": [{"email": "recipient@example.com", "name": "John Doe"}],
  "subject": "Welcome to our service",
  "htmlContent": "<h1>Welcome!</h1><p>Thank you for joining us.</p>",
  "sender": {"email": "noreply@yourcompany.com", "name": "Your Company"}
}

3. campaigns - マーケティングキャンペーン

メールとSMSのマーケティングキャンペーンを作成および管理します。

操作:

• get_email_campaigns / create_email_campaign / update_email_campaign
• send_email_campaign / schedule_email_campaign / delete_email_campaign
• get_sms_campaigns / create_sms_campaign / update_sms_campaign
• send_sms_campaign / schedule_sms_campaign / delete_sms_campaign
• get_campaign_statistics - キャンペーン分析

例:

{
  "operation": "create_email_campaign",
  "campaignData": {
    "name": "Newsletter Campaign",
    "subject": "Monthly Newsletter",
    "htmlContent": "<h1>Newsletter</h1>",
    "recipients": {"listIds": [1, 2]}
  }
}

4. sms - SMS操作

トランザクションSMSを送信し、SMSキャンペーンを管理します。

操作:

• send - 単一のSMSを送信する
• send_batch - 複数の受信者に送信する
• get_events - SMSイベントをトラッキングする
• get_statistics - SMS分析

例:

{
  "operation": "send_batch",
  "recipients": ["+1234567890", "+0987654321"],
  "content": "Your order is ready for pickup!",
  "sender": "YourBrand"
}

5. conversations - チャット管理

顧客の会話とチャットインタラクションを処理します。

操作:

• get_conversations - 会話を一覧表示する
• get_conversation - 特定の会話を取得する
• get_messages - 会話メッセージを取得する
• send_message - メッセージを送信する
• update_conversation - 会話ステータスを更新する

6. webhooks - イベント自動化

リアルタイムのイベント通知用のWebhookを管理します。

操作:

• get_webhooks / create_webhook / update_webhook / delete_webhook
• get_webhook - 特定のWebhookを取得する

例:

{
  "operation": "create_webhook",
  "url": "https://your-app.com/brevo-webhook",
  "events": ["delivered", "opened", "clicked"],
  "description": "Email tracking webhook",
  "type": "transactional"
}

7. account - アカウント管理

アカウント設定、送信者、ドメイン、およびフォルダを管理します。

操作:

• get_account - アカウント情報
• get_senders / create_sender / update_sender / delete_sender
• get_domains / create_domain / validate_domain
• get_folders / create_folder / update_folder / delete_folder

8. ecommerce - 電子商取引統合

電子商取引のトラッキング用に注文、商品、およびカテゴリを管理します。

操作:

• get_orders / create_order / get_order / update_order
• get_products / create_product / update_product / delete_product
• get_categories / create_category / update_category / delete_category

例:

{
  "operation": "create_order",
  "orderData": {
    "id": "order-123",
    "email": "customer@example.com",
    "products": [
      {
        "id": "product-1",
        "name": "Widget",
        "price": 29.99,
        "quantity": 2
      }
    ],
    "total": 59.98
  }
}

📋 設定

環境変数

Smithery設定

version: 1
startCommand:
  type: stdio
  configSchema:
    type: object
    required: ['apiKey']
    properties:
      apiKey:
        type: string
        description: "認証用のBrevo APIキー（必須）"
      defaultSenderEmail:
        type: string
        description: "デフォルトの送信者メールアドレス"
      defaultSenderName:
        type: string
        description: "デフォルトの送信者名"
      debug:
        type: boolean
        description: "デバッグモードを有効にする"
        default: false

🔧 開発

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# サーバーを起動する
npm start

# サーバーをテストする
npm test

# Smitheryで実行する
npm run smithery

📊 一般的なユースケース

コンタクトの一括インポート

{
  "operation": "bulk_import",
  "contacts": [
    {
      "email": "user1@example.com",
      "attributes": {
        "FIRSTNAME": "John",
        "LASTNAME": "Doe",
        "COMPANY": "Acme Corp"
      }
    }
  ]
}

トラッキング付きのメールキャンペーン

{
  "operation": "create_email_campaign",
  "campaignData": {
    "name": "Product Launch",
    "subject": "Introducing Our New Product",
    "htmlContent": "<h1>New Product Launch</h1>",
    "recipients": {"listIds": [1]},
    "scheduler": {
      "sendAt": "2024-01-01T10:00:00Z"
    }
  }
}

電子商取引の注文トラッキング

{
  "operation": "create_order",
  "orderData": {
    "id": "order-456",
    "email": "customer@example.com",
    "products": [
      {"id": "prod-1", "name": "T-Shirt", "price": 25.00, "quantity": 1}
    ],
    "total": 25.00,
    "status": "pending"
  }
}

🔒 セキュリティ

• APIキーは環境変数を通じて安全に処理されます
• すべての通信は公式Brevo SDKを通じてHTTPSを使用します
• すべてのツールパラメータに入力検証があります
• エラーハンドリングにより情報漏洩が防止されます

📄 ライセンス

MITライセンス

🆘 サポート

• 問題報告: GitHubで報告してください
• Brevo APIドキュメント: https://developers.brevo.com/
• 公式SDK: https://github.com/getbrevo/brevo-node

信頼性と機能を最大限に発揮するために、公式Brevo Node.js SDKを使用して❤️ で構築されています