resend-integration-skills

リンク

• Resend 公式: https://resend.com
• Resend API ドキュメント: https://resend.com/docs/api-reference
• Resend MCP サーバー: https://resend.com/docs/knowledge-base/mcp-server
• Resend MCP GitHub: https://github.com/resend/mcp-send-email
• MCP プロトコル仕様: https://modelcontextprotocol.io
• GitHub MCP レジストリ: https://github.com/mcp
• VS Code Insider のセットアップ: https://code.visualstudio.com/insiders

クイックスタート

1. 前提条件

• Node.js 20 以上（必須。MCP サーバーでは engines: { "node": ">=20" } が指定されています）
• Resend アカウント（https://resend.com で無料プランを利用できます）
• GitHub Copilot Pro または Agent モードを有効にした Cursor
• VS Code Insider（MCP を完全にサポートするために必要です）
• npm または pnpm パッケージマネージャー

2. Resend MCP サーバーのクローンとビルド

# Clone the Resend MCP server repository
git clone https://github.com/resend/mcp-send-email.git
cd mcp-send-email

# Install dependencies (npm or pnpm both supported)
npm install
# or if you prefer pnpm:
# pnpm install

# Build the project (TypeScript compilation + executable permissions)
npm run build

ビルド処理では、次のことが行われます。

1. TypeScript を JavaScript にコンパイルします
2. ビルドしたスクリプトに実行権限を設定します（Unix/macOS）
3. build/index.js に MCP サーバーの実行ファイルを作成します

3. Resend API キーの作成

1. https://resend.com/api-keys にアクセスします
2. 新しい API キーを作成します
3. キーをクリップボードにコピーします（設定時に必要です）

4. （任意）ドメインの確認

カスタムドメインからメールを送信するには、次の手順を実行します。

1. https://resend.com/domains にアクセスします
2. ドメインを追加して確認します
3. --sender フラグを使って MCP の設定を更新します（「設定」セクションを参照）

5. クライアント用に MCP を設定

GitHub Copilot のプランに応じて、セットアップ方法を選択します。

GitHub Copilot Coding Agent の場合（リポジトリレベルのセットアップ）：

チームでの共同作業に推奨される方法です。リポジトリ管理者がリポジトリレベルで MCP サーバーを設定します。

1. GitHub.com でリポジトリに移動します
2. Settings → Copilot → Coding agent に移動します
3. 次の JSON 設定を追加します。

{
  "mcpServers": {
    "resend": {
      "type": "local",
      "command": "node",
      "args": ["/absolute/path/to/mcp-send-email/build/index.js"],
      "env": {
        "RESEND_API_KEY": "COPILOT_MCP_RESEND_API_KEY"
      },
      "tools": ["*"]
    }
  }
}

4. Copilot の環境を設定します。

   • Settings → Environments に移動します
   • copilot という名前の新しい環境を作成します
   • シークレットを追加します。名前は COPILOT_MCP_RESEND_API_KEY、値には API キーを指定します

5. Save をクリックすると、Copilot が設定を検証します

VS Code のローカル開発の場合（開発者向けのセットアップ）：

ローカルで開発する場合や、VS Code の設定を使う場合は、次の手順を実行します。

1. プロジェクトのルートに .vscode/mcp.json を作成します。

{
  "servers": {
    "resend": {
      "type": "command",
      "command": "node",
      "args": ["/absolute/path/to/mcp-send-email/build/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxxxxxxx"
      }
    }
  }
}

2. build/index.js の絶対パスを取得します。
   • VS Code で build/index.js を右クリックし、Copy Path を選択します

Cursor Agent モードの場合：

Cursor の設定（Cmd+Shift+P →「Cursor Settings」）を開き、MCP 設定に追加します。

{
  "mcpServers": {
    "resend": {
      "type": "command",
      "command": "node /absolute/path/to/mcp-send-email/build/index.js --key=re_xxxxxxxxxxxxxx"
    }
  }
}

Claude Desktop の場合：

1. Claude Desktop の設定を開きます
2. Developer タブ → Edit Config に移動します
3. 設定を追加します。

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-send-email/build/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxxxxxxx",
        "SENDER_EMAIL_ADDRESS": "[email protected]",
        "REPLY_TO_EMAIL_ADDRESS": "[email protected]"
      }
    }
  }
}

6. email.md のパターンを使って接続をテスト

公式 Resend リポジトリには、email.md ファイルを使ったテストパターンが含まれています。

1. プロジェクトに email.md を作成します。

   to: [email protected]
   subject: Test from Resend MCP
   content: This is a test email.
   
   Hello! This is a test email sent via Resend MCP.
   
   # You can also test CC and BCC:
   # cc: [email protected]
   # bcc: [email protected]
   

2. Cursor の場合（Agent モード）：

   • email.md ファイルを開きます
   • すべてのテキストを選択します（Cmd+A / Ctrl+A）
   • Cmd+L / Ctrl+L を押します（またはコンテキストメニューを使います）
   • Cursor に「これをメールとして送信して」または「resend MCP を使ってこのメールを送信して」と指示します
   • Agent モードになっていることを確認します（チャットのドロップダウンで切り替えます）

3. Claude Desktop の場合：

   • email.md の内容をチャットに貼り付けます
   • Claude に「resend ツールを使ってこのメールを送信して」と依頼します

4. GitHub Copilot の場合：

   • email.md ファイルを開きます
   • チャットでファイルを参照し、「@email.md このメールを resend を使って送信して」と指示します

正しく設定されていれば、メールはすぐに送信され、確認メッセージが届きます。

主な概念

MCP の設定タイプ

GitHub Copilot で Resend MCP を設定する主な方法は 2 つあります。

1. GitHub Copilot コーディングエージェント（リポジトリレベル）

• GitHub リポジトリの設定で構成します（リポジトリの管理者権限が必要です）
• GitHub の Issue に取り組む Copilot タスクを割り当てる際に使用します
• Copilot が使用できるツールを指定する明示的な tools 配列が必要です
• API キーは GitHub Actions のシークレットとして保存します（COPILOT_MCP_ をプレフィックスとして付けます）
• 承認なしで自律的に実行されます（セキュリティ上の考慮事項が適用されます）

2. VS Code でのローカル開発

• .vscode/mcp.json で構成します（開発者のローカル環境で設定します）
• VS Code Insider でのローカル開発に使用します
• API キーは設定に直接記述するか、環境変数に保存します
• 個々の開発者やテストに適しています

Resend MCP サーバー

Resend MCP サーバーは、Resend のメール機能を LLM 向けのツールとして提供するローカルの Node.js アプリケーションです。Model Context Protocol を実装しており、AI エージェントが次のことを行えるようにします。

• 自然言語のコマンドでメールを送信する（プレーンテキストまたは HTML）
• メールを将来の日時に予約送信する
• 宛先を追加する（To、CC、BCC）
• 送信者情報を設定する（From、Reply-To）
• オーディエンスセグメントにメールを一斉送信する
• オーディエンスを管理する — 対象を絞った送信のために Resend のオーディエンスを一覧表示します
• HTML とプレーンテキストのメール本文に対応する

最近追加された機能（2026 年初頭時点）：

• マーケティングキャンペーン向けの一斉送信およびオーディエンス管理ツール
• Zod スキーマによるエラー処理と検証の改善

MCP の設定方法

Resend MCP サーバーを実行する方法は 3 つあります。

1. コマンドタイプ（VS Code/Cursor）：引数をインラインで指定して Node.js を直接実行します
2. Stdio タイプ（Claude Desktop）：環境変数を介してサーバーが I/O を処理します
3. HTTP タイプ（リモート／クラウド）：サーバーを HTTP エンドポイント経由で公開します

GitHub Copilot コーディングエージェント固有の設定

GitHub Copilot コーディングエージェント（リポジトリベースの設定）では、次の点に注意してください。

• 必須の tools 配列：Resend MCP サーバーのどのツールを Copilot が使用できるか指定する必要があります

  • "tools": ["send_email", "schedule_email", ...] を使用すると、指定したツールのみ許可できます
  • "tools": ["*"] を使用すると、すべてのツールを有効にできます
  • MCP サーバーのドキュメントに記載されている、用途に応じたツール名を使用してください

• 承認は不要です：設定が完了すると、Copilot は確認を求めずにこれらのツールを自律的に使用します

• セキュリティ上の考慮事項：Copilot は設定されたツールを介して Resend API に自動的にアクセスできるため、必要なツールのみを有効にしてください

• 環境変数の処理：API キーは COPILOT_MCP_ プレフィックスを付けた GitHub Actions のシークレットとして保存する必要があります

  • 設定では、値を含めず "COPILOT_MCP_RESEND_API_KEY" として参照してください
  • GitHub がシークレットの値を MCP サーバーに自動的に渡します

認証

Resend MCP サーバーには次の情報が必要です。

• RESEND_API_KEY（必須）：https://resend.com/api-keys で取得した Resend API キー
• SENDER_EMAIL_ADDRESS（任意）：検証済みドメインのメールアドレス。設定されていない場合は、AI が入力を求めます
• REPLY_TO_EMAIL_ADDRESS（任意）：Reply-To ヘッダーに設定するメールアドレス

検証済みドメイン

デフォルトでは、Resend はテスト用ドメイン [email protected] を使って、自分のアカウントのメールアドレス宛てに送信できます。ほかのアドレスに送信するには、次の手順に従ってください。

1. テストの場合：デフォルトの送信者 [email protected] を使用します（検証は不要です）
2. カスタムドメインの場合：https://resend.com/domains でドメインを検証します
3. 検証済みドメインの送信者メールアドレスを作成します
4. MCP の環境変数で設定します（SENDER_EMAIL_ADDRESS）

注：SENDER_EMAIL_ADDRESS を指定しない場合、メールを送信するたびに MCP サーバーが入力を求めます。

コード例

例 1：Copilot Chat でシンプルなメールを送信する

GitHub Copilot エージェントモードを有効にした VS Code Insider で：

@workspace I need to send a notification email to [email protected] about the project completion. Use the resend MCP tool to send "Project ABC is now live" as the email body.

例 2：カスタム設定で HTML メールを送信する

Send an HTML email to [email protected] with subject "Monthly Report" and body formatted as an HTML table showing Q1 metrics. Use Resend MCP to send it.

例 3：CC/BCC を含むメール

Send an email from [email protected] to [email protected] CC'ing [email protected] about account activation. Use Resend MCP.

例 4：メールの予約送信

Schedule an email to be sent tomorrow at 9 AM using Resend MCP, reminding the team about the standup meeting.

例 5：データ処理との連携

Read the CSV file users.csv, extract the top 10 active users with their emails, and send each a personalized thank you email using Resend MCP. Include their usage statistics in the email.

高度な機能

一斉メール

Resend アカウントのオーディエンスセグメントにメールを送信します：

Send a broadcast email to my 'premium_users' audience with subject 'New Feature Release' using Resend MCP

オーディエンス管理

オーディエンスを検索して操作します：

List all my audiences in Resend using the MCP tool

ベストプラクティス

GitHub Copilot コーディングエージェントのセキュリティ

重要：GitHub Copilot コーディングエージェント用に Resend MCP を設定する場合：

1. ツールの許可リスト - Copilot が必要とする特定のツールのみを有効にします：

   "tools": ["send_email", "schedule_email"]
   

   "*" を指定してすべてのツールを有効にするのではなく

2. シークレット管理 - API キーをバージョン管理にコミットしないでください

   • API キーは GitHub Actions のシークレットとして保存します（Settings → Environments）
   • シークレット名は COPILOT_MCP_ で始める必要があります
   • 設定ではシークレット名を参照します

3. API キーのスコープ設定 - 利用可能であれば、制限付きの Resend API キーの使用を検討します

4. Copilot の操作を確認 - Copilot が作成したプルリクエストを確認し、メールが適切に送信されることを確かめます

5. 環境の分離 - copilot 環境を使用して、メール送信機能にアクセスできるリポジトリやワークフローを管理します

設定管理

1. 開発には .env.local を使用します：

   # .env.local (not committed)
   RESEND_API_KEY=re_test_xxx
   [email protected]
   

2. 環境ごとに設定を分けます：

   • 開発：テスト用 API キー、受信者を制限
   • 本番：完全な API キー、すべての受信者を許可

3. 必須の環境変数を README.md に記載します：

   ## Environment Variables
   - RESEND_API_KEY: Resend API key (required)
   - SENDER_EMAIL_ADDRESS: Verified sender email (optional)
   - REPLY_TO_EMAIL_ADDRESS: Reply-to email (optional)
   

メールの内容

1. マーケティングメールには必ず配信停止リンクを含めます
2. 複数のメールクライアント（Gmail、Outlook、Apple Mail）でメールをテストします
3. モバイル端末に対応するレスポンシブなテンプレートを作成します
4. メールの目的が伝わる明確な件名を付けます
5. アクセシビリティのため、HTML に加えてプレーンテキスト版を用意します

AI エージェントの使用

1. メールの送信対象についてのコンテキストを伝えます
2. 初期設定で送信者情報を指定します
3. AI が生成したメールの内容を、送信前に確認します
4. 複数の手順が必要な複雑なワークフローにはエージェントモードを使用します
5. 他の人に送信する前に、まず自分のメールアドレス宛てにテストします

トラブルシューティング

問題：「Node のバージョンが古すぎます」または「Node 20+ が必要です」

解決策：Node.js のバージョンを確認して更新します

node --version  # Should be v20.0.0 or higher

• https://nodejs.org から Node.js 20+ をインストールします（LTS バージョンを推奨）
• macOS：brew install node@20（Homebrew を使用している場合）
• Windows：https://nodejs.org からダウンロードするか、nvm-windows を使用します
• Linux：nvm install 20 またはパッケージマネージャーを使用します
• 確認：node --version で v20.x.x 以降が表示されることを確認します
• インストール後、ターミナル／IDE を再起動します

問題：「コマンドが見つかりません：node」

解決策：Node.js がインストールされていないか、PATH に設定されていません

• https://nodejs.org から Node.js をインストールします（バージョン 20+ が必要です）
• インストールを確認します：node --version
• インストール後、ターミナル／IDE を再起動します

問題：「RESEND_API_KEY が必要です」

解決策：API キーが指定されていないか、無効です

• https://resend.com/api-keys で新しいキーを生成します
• キーが re_ で始まることを確認します
• MCP の設定で環境変数名が正しいことを確認します
• キーに余分な空白がないことを確認します

問題：「メールが配信されない／401 Unauthorized」

解決策：認証またはドメイン認証の問題です

• API キーが正しく、有効であることを確認します
• https://resend.com/domains でドメインが認証済みであることを確認します
• 送信者のメールアドレスが認証済みドメインと一致することを確認します
• Resend のダッシュボードでレート制限や配信エラーを確認します

問題：「npm run build の実行中にビルドコマンドが失敗する」

解決策：依存関係または TypeScript のコンパイルエラーです

# Clear and reinstall dependencies
rm -rf node_modules package-lock.json
npm install
npm run build

よくあるビルドエラー：

• TypeScript のコンパイルエラー：すべての依存関係がインストールされていることを確認します
• Unix／macOS でアクセスが拒否される：ビルドスクリプトには chmod +x が含まれています。別のディレクトリから実行してみてください
• モジュールが見つからない：node_modules を削除して、新たにインストールし直します

問題：「MCP サーバーが IDE のツール一覧に表示されない」

解決策：設定またはサーバーの起動に関する問題です

GitHub Copilot：

1. .vscode/mcp.json がプロジェクトのルートにあることを確認します（ネストされた場所ではありません）
2. build/index.js への絶対パスが正しいことを確認します
3. VS Code のウィンドウを再読み込みします（macOS では Cmd+R、Windows では Ctrl+R）
4. エージェントモードが有効になっていることを確認します（チャットで切り替えます）

Cursor：

1. Cursor の設定を開きます（Cmd+Shift+P → "Cursor Settings"）
2. MCP タブに移動します
3. 設定の構文が有効な JSON であることを確認します
4. 絶対パスが存在し、読み取り可能であることを確認します
5. Cursor アプリケーションを再起動します

Claude Desktop：

1. Claude を完全に終了します
2. claude_desktop_config.json の構文を確認します
3. build/index.js ファイルが存在することを確認します
4. Claude Desktop を再度開きます
5. Developer タブで resend ツールを確認します

問題：「メールの送信はできるが、AI が Resend MCP の使用を提案しない」

解決策：エージェントのモデルまたはモードに関する問題です

• Claude Sonnet 4 または GPT-4.1 に切り替えます（ツールの理解に優れています）
• エージェントモードを明示的に有効にします
• 「resend MCP ツールを使って送信して…」のように、明示的に指定します
• MCP サーバーが実行中であることを確認します（コンソール出力を確認します）

問題：「'invalid sender' エラーが発生する」

解決策：送信者のメールアドレスが検証されていません

1. https://resend.com/domains にアクセスします
2. カスタムドメインを使用している場合は、そのドメインを検証します
3. テストにはデフォルトの [email protected] を使用します
4. MCP 設定の SENDER_EMAIL_ADDRESS を更新します
5. MCP サーバーを再起動します

高度な設定

HTTP トランスポートを使用したカスタム MCP サーバー

チームで共有する環境やクラウドベースのセットアップの場合：

{
  "servers": {
    "resend": {
      "type": "http",
      "url": "https://your-mcp-server.example.com/mcp"
    }
  }
}

HTTP サーバーから Resend API にリクエストを転送する必要があります。

環境ごとの設定

環境ごとに異なる .mcp.json ファイルを使用します：

# Development
cp .mcp.dev.json .vscode/mcp.json

# Production
cp .mcp.prod.json .vscode/mcp.json

Claude Desktop と GitHub Copilot の統合

両方を同時に設定できます：

Claude Desktop の設定：

{
  "mcpServers": {
    "resend": {
      "command": "node",
      "args": ["/path/to/mcp-send-email/build/index.js"],
      "env": {
        "RESEND_API_KEY": "re_xxxxx"
      }
    }
  }
}

VS Code の .vscode/mcp.json：

{
  "servers": {
    "resend": {
      "type": "command",
      "command": "node /path/to/mcp-send-email/build/index.js",
      "env": {
        "RESEND_API_KEY": "re_xxxxx"
      }
    }
  }
}

どちらも同じローカル MCP サーバーのインスタンスを使用します。

ワークフローの例

トランザクションメールのワークフロー

1. セットアップフェーズ：本番環境の API キーを使用して MCP サーバーをデプロイします
2. 自動化フェーズ：Claude Desktop または Copilot で設定します
3. 統合フェーズ：AI エージェントを介してアプリケーションロジックで使用します

   When order is confirmed, send confirmation email with order details using Resend MCP
   

4. 監視フェーズ：Resend ダッシュボードで配信状況を確認します

マーケティングキャンペーンのワークフロー

1. メールテンプレートと宛先リストを準備します
2. AI エージェントを使ってパーソナライズされたコンテンツを生成します
3. 送信前に生成されたメールを確認します
4. Resend MCP を介して一括送信します
5. 開封率とエンゲージメントを監視します

通知のワークフロー

1. 通知サービス用に Resend MCP を設定します
2. 通知の種類ごとにメールテンプレートを作成します
3. AI エージェントを使って通知をメール形式に整えます
4. Resend MCP を介して登録者に送信します
5. 配信状況を追跡し、バウンスに対応します

リソース

• Resend のドキュメント
• MCP プロトコルのドキュメント
• GitHub MCP レジストリ
• VS Code Insider 開発者向けドキュメント
• Cursor のドキュメント
• Claude Desktop の設定