Sendgrid

🚀 送信Grid MCPサーバー

このプロジェクトは、送信Grid MCPサーバーを提供し、関連する操作を行うためのものです。APIキーの設定やテスト、ビルドなどの機能を備えています。

🚀 クイックスタート

このセクションでは、送信Grid MCPサーバーの基本的なセットアップと使用方法を説明します。

📦 インストール

以下のコマンドを実行して、リポジトリをクローンし、必要な依存関係をインストールします。

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

📚 ドキュメント

設定

1. あなたの送信Grid APIキーを取得します。

   • あなたの送信Gridアカウントにログインします。
   • 設定 > APIキーに移動します。
   • 新しいAPIキーを作成し、権限を全アクセスに設定します。
   • このAPIキーは生成後に再表示できないため、安全に保存してください。

2. これをVSCodeのCline MCP設定ファイル（例：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/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"
      ]
    }
  }
}

⚠️ 重要提示

データを変更するツール（メールの送信や連絡先の削除など）は、セキュリティ上の理由から、デフォルトで自動承認は無効になっています。

開発

テストの設定

テストは、正確な応答を確保するために実際のAPI呼び出しを使用します。テストを実行するには：

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

cp .env.example .env

2. .envを編集し、あなたの送信Grid APIキーを追加します。

SENDGRID_API_KEY=your-api-key-here

⚠️ 重要提示

.envファイルは、機密情報のコミットを防ぐためにgitによって無視されます。

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

npm test

ビルド

npm run build

重要事項

• リストにメールを送信する場合は、電子メール規制に準拠するために、suppression_group_idまたはcustom_unsubscribe_urlを提供する必要があります。
• 送信元の電子メールアドレスは、メールを送信する前に送信Gridで検証されている必要があります。
• すべてのテンプレートは動的テンプレートとして作成され、Handlebars構文（例：{{variable_name}}）をサポートしています。
• すべてのバッチメール操作には、より良いトラッキングと管理機能を提供するため、単一送信APIが使用されます。
• 送信Grid APIは「最終的な一貫性」を持っています - データの変更（連絡先の追加やリストの更新など）は、生成後すぐに表示されない場合があります。

📄 ライセンス

MIT

送信Gridのロゴの著作権はTwilioに帰属します。