Sendgrid MCP Server

🚀 送信グリッドMCPサーバー

SendGrid MCPサーバーを使用すると、メールマーケティング操作を自動化して管理できます。これには、連絡先管理、テンプレート作成、統計分析などが含まれます。

Clineとの統合により、VSCode内から直接これらの機能を呼び出すことができ、作業フローをより効率的かつ便利にすることができます。以下に、詳細なインストールと設定ガイドを示します。

🚀 クイックスタート

このセクションでは、SendGrid MCPサーバーのインストールと設定の手順を説明します。

📦 インストール

1. リポジトリをクローンします：

   git clone https://github.com/Garoth/sendgrid-mcp.git
   cd sendgrid-mcp
   npm install
   

2. 環境変数を設定します：

   • SendGrid APIキーを取得します：
     • SendGridアカウントにログインします。
     • 設定 > APIキーに移動します。
     • 完全な権限を持つ新しいAPIキーを作成します。
     • それを.envファイルに安全に保存します：

       SENDGRID_API_KEY=your-api-key-here
       

3. Cline MCP設定を構成します（VSCodeのグローバルストレージパス下のcline_mcp_settings.json）：

   {
     "mcpServers": {
       "sendgrid": {
         "command": "node",
         "args": ["/path/to/sendgrid-mcp/build/index.js"],
         "env": {
           "SENDGRID_API_KEY": "your-api-key-here"
         },
         "disabled": false,
         "autoApprove": [
           "list_contacts",
           "list_contact_lists",
           "list_templates",
           "list_single_sends",
           "get_single_send",
           "list_verified_senders",
           "list_suppression_groups",
           "get_stats",
           "validate_email"
         ]
       }
     }
   }
   

✨ 主な機能

連絡先管理

• list_contacts：すべての連絡先を取得します。
• add_contact：単一または複数の連絡先を追加します。
• delete_contact：指定された連絡先を削除します。

テンプレート管理（動的テンプレートのみサポート）

• create_template：新しいテンプレートを作成します。
• list_templates：すべてのテンプレートをリストします。
• get_template：特定のテンプレートの詳細情報を取得します。
• delete_template：指定されたテンプレートを削除します。

統計と分析

• get_stats：送信統計情報を取得します。
• validate_email：電子メールアドレスの有効性を検証します。

アカウント設定

• list_verified_senders：すべての検証済み送信者をリストします。
• list_suppression_groups：すべての購読解除グループをリストします。

🔧 開発

テスト環境の設定

1. サンプル環境ファイルをコピーします：

   cp .env.example .env
   

2. .envファイルにSendGrid APIキーを追加します：

   SENDGRID_API_KEY=your-api-key-here
   

3. テストを実行します：

   npm test
   

プロジェクトをビルドする

npm run build

⚠️ 重要提示

• メールをリストに送信する際には、規制要件を満たすためにsuppression_group_idまたはcustom_unsubscribe_urlを提供する必要があります。
• 送信者アドレスは、SendGridで検証されてから使用する必要があります。
• すべてのテンプレートは動的テンプレート形式で、Handlebars構文（例：{{variable_name}}）をサポートしています。
• すべてのバルク送信操作はSingle Sends APIを使用して処理することで、より良いトラッキングと管理機能を得ることができます。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。

SendGridのロゴはTwilioが所有しています。