resend-mcp-server

Resend MCP サーバー

Resend 用の MCP サーバーです。Resend のトランザクションメール API に、MCP 互換クライアントから接続できます。

これは何ですか？

Resend のメール API に AI アシスタントやエージェントがフルアクセスできる、MCP（Model Context Protocol） サーバーです。自然言語で単一または一括のメール送信、送信ドメイン、API キー、オーディエンス、連絡先を管理できます。

Claude Desktop、Cursor、Windsurf、Cline、Continue、または MCP 互換クライアントで使い、メールの送信やインフラの管理、メールを使った自動化の構築ができます。

使う理由

• 組み込みツール 18 種類 — メール送信（単一・一括）、ドメイン、API キー、オーディエンス、連絡先をカバー
• 会話するだけでメールを送信 — 「[email protected] に登録のお礼メールを送って」と頼むだけで実行できます
• インフラを管理 — ドメインの作成・検証・削除、API キーの発行・失効、連絡先の管理ができます
• 一括送信 — 1 回の API 呼び出しで最大 100 通のメールを送信できます
• 連絡先の CRUD にフル対応 — オーディエンス全体で連絡先の作成、読み取り、更新、削除ができます
• レート制限を自動適用 — Resend の無料プランの上限である 10 req/s を遵守し、429 エラー時には再試行します
• あらゆる MCP クライアントで動作 — Claude Desktop、Cursor、Windsurf、Cline、Continue などに対応

クイックスタート

MCP クライアントの設定に追加します（例：claude_desktop_config.json）。

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp-server"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxxxxx"
      }
    }
  }
}

resend.com/api-keys で無料の API キーを取得してください。

使い方

AI アシスタントに、次のように頼んでみてください。

• 「[email protected] に、登録のお礼メールを送って」
• 「最近送ったメールを 5 件表示して」
• 「メール ID abc-123 はどうなった？」
• 「mail.acme.com の送信ドメインを新規作成して」
• 「ドメイン domain-xyz を検証して」
• 「'production-server' という名前の API キーを新しく発行して」
• 「[email protected] をオーディエンス audience-1 に追加して」

ツール

ツール	説明
send_email	トランザクションメールを送信します（HTML またはプレーンテキスト、Cc/Bcc/Reply-To 対応）
send_batch_email	1 回の API 呼び出しで最大 100 通のメールを送信します
list_emails	配信状況とともに最近送信したメールを一覧表示します
get_email	ID を指定して特定のメールの詳細を取得します
create_domain	新しい送信ドメインを追加します
list_domains	アカウント内のすべての送信ドメインを一覧表示します
verify_domain	ドメインの DNS 検証を開始します
delete_domain	送信ドメインを削除します
create_api_key	新しい API キーを作成します（フル、送信専用、またはドメイン限定）
list_api_keys	すべての API キーを一覧表示します（トークンは非表示）
delete_api_key	ID を指定して API キーを削除します
list_audiences	アカウント内のすべてのオーディエンスを一覧表示します
create_audience	連絡先を整理するための新しいオーディエンスを作成します
list_contacts	オーディエンス内の連絡先を一覧表示します
get_contact	ID を指定して特定の連絡先の詳細を取得します
create_contact	オーディエンスに新しい連絡先を追加します
update_contact	連絡先のメールアドレス、名前、または購読状況を更新します
delete_contact	オーディエンスから連絡先を削除します

活用例

トランザクションメールの自動化

「新規登録者全員にウェルカムメールを送信」——自然言語でオンボーディングのワークフロー、領収書、通知を自動化できます。メールのダッシュボードを切り替える必要はありません。

ドメイン管理

「送信ドメインとして mail.acme.com を追加して、検証してください」— Resend のダッシュボードにログインせず、AI アシスタントから DNS レコード、DKIM、SPF を管理できます。

連絡先とオーディエンスの管理

「[email protected] を VIP オーディエンスに追加してください」— スプレッドシートに触れることなく、連絡先リストを作成してセグメント化できます。連絡先とオーディエンスの完全な CRUD に対応しています。

一括キャンペーン

「このニュースレターを audience-1 のすべての連絡先に送信してください」— 1 回の呼び出しで最大 100 件のメールを一括送信できます。ニュースレター、製品のお知らせ、再エンゲージメントキャンペーンに最適です。

インフラストラクチャの監査

「すべての API キーとドメインを一覧表示してください」— Resend の設定を数秒で監査できます。有効なキー、検証済みのドメインを確認し、古いリソースを整理できます。

セキュリティ

• API キーが必要です — Resend API キーは環境変数を介して渡され、ログに記録されたり、ファイルに保存されたりすることはありません。
• ローカルファイルへのアクセスはありません — お使いのマシン上のファイルの読み取りや書き込みは行いません。
• シェルへのアクセスはありません — コマンドの実行やプロセスの起動は行いません。
• レート制限あり — Resend の無料プランの範囲内に収まるよう、リクエスト数を自動的に約 9 req/s に制限します。
• オープンソース — MIT ライセンスです。GitHub でコードを確認できます。

トラブルシューティング

レート制限エラー（429）

サーバーは 429 が発生すると、2 秒のバックオフを挟んで自動的に再試行します。無料プランでは 10 req/s が上限です。安全を期すため、サーバーは約 9 req/s に制限しています。このエラーが頻繁に発生する場合は、Resend のプランのアップグレードをご検討ください。

「Invalid API key」エラー

RESEND_API_KEY が re_ で始まっていることと、resend.com/api-keys で有効になっていることを確認してください。キーの作成後、反映まで最大 30 秒かかる場合があります。

サーバーが起動しない

Node.js 18 以降がインストールされていることを確認してください：node --version。npx を使用している場合は、npm が最新であることを確認してください：npm install -g npm@latest。

MCP クライアントが接続できない

設定ファイルのパスが正しいことを確認してください。Claude Desktop では、macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json を使用します。設定を変更した後は、クライアントを再起動してください。

メールが配信されない

配信状況は list_emails で確認してください。よくある原因は、DNS レコードの不足（verify_domain を実行してください）、無効なアドレスによるバウンス、ドメインが未検証であることです。Resend のダッシュボードでは、Webhook イベントの詳細を確認できます。

要件

• Node.js 18 以降
• Resend のアカウントと API キー（RESEND_API_KEY）

レート制限

Resend の無料プランの上限である 10 req/s を十分に下回るよう、サーバーはリクエスト数を自動的に約 9 回/秒に制限します。それでも 429 が発生した場合は、2 秒待って 1 回再試行します。

開発

git clone https://github.com/friendlygeorge/resend-mcp-server.git
cd resend-mcp-server
npm install
npm run build
RESEND_API_KEY=re_xxxx npm start

ライセンス

MIT