SendRaven MCP Server認証済み注目

SendRaven MCP Server とは？

SendRaven MCP Server は、AI エージェント向けのメール基盤 SendRaven の公式 MCP サーバーです。エージェントは API キーに設定された制限の範囲内で、メールの送信、返信のスレッド表示での閲覧、キャンペーンや自動化の実行、承認の処理を行えます。

SendRaven の料金は送信メール数に応じて決まり、連絡先数では課金されません。MCP サーバー（@sendraven/mcp、MIT ライセンス、Common Ninja Ltd. 提供）は SendRaven の公開 REST API のプロキシです。独自のデータベースやプロバイダーの認証情報は持たず、呼び出し元のキーまたは OAuth の許可で届く範囲にだけアクセスします。ホスト型のリモートサーバーとして使うことも、npx でローカル実行することもできます。

SendRaven MCP Server の使い方

SendRaven アカウントが必要で、メールを送るには検証済みの送信ドメインも必要です。接続方法は 2 つあります。

リモートサーバー（OAuth）。 ホスト型エンドポイントは、初回利用時にブラウザでのサインインを求めます。

https://mcp.sendraven.ai/mcp

ローカルプロセス（API キー）。 SendRaven ダッシュボードの Developers で API キーを作成し、SENDRAVEN_API_KEY として渡します。ローカルパッケージは SENDRAVEN_API_URL（既定値 https://api.sendraven.ai）も読み込み、PORT を設定すると stdio ではなく Streamable HTTP で待ち受けます。

Claude Code

リモート（OAuth）：

claude mcp add --transport http sendraven https://mcp.sendraven.ai/mcp

ローカル（キー使用）：

claude mcp add sendraven -e SENDRAVEN_API_KEY=YOUR_SENDRAVEN_API_KEY -- npx -y @sendraven/mcp

Claude Desktop / claude.ai

URL に https://mcp.sendraven.ai/mcp を指定したカスタムコネクタを追加し、ブラウザでサインインします。Claude Desktop の JSON 設定では、代わりにローカルプロセスも使えます。

{
  "mcpServers": {
    "sendraven": {
      "command": "npx",
      "args": ["-y", "@sendraven/mcp"],
      "env": { "SENDRAVEN_API_KEY": "YOUR_SENDRAVEN_API_KEY" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "sendraven": {
      "url": "https://mcp.sendraven.ai/mcp"
    }
  }
}

無人で動くエージェント向けに、README では OAuth の代わりにキーでリモートサーバーへ接続する例も示されています。

{
  "mcpServers": {
    "sendraven": {
      "url": "https://mcp.sendraven.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_SENDRAVEN_API_KEY" }
    }
  }
}

VS Code

{
  "servers": {
    "sendraven": {
      "type": "http",
      "url": "https://mcp.sendraven.ai/mcp"
    }
  }
}

SendRaven MCP Server の主な機能

• キーごとのガードレール：1 日の送信上限、宛先の許可リスト、承認保留。キャンペーンを含め、すべてのツールがこの 3 つを守ります。
• 双方向のメール：返信はスレッドに入り、エージェントが読んで返信できます。
• キャンペーンはプレビューでき、件名・差出人名・送信時刻で A/B テストも可能です。
• イベント駆動の自動化、登録（エンロールメント）、トピック単位のメール配信設定。
• 冪等な送信。同じ idempotency_key で再試行すると、二重送信せず最初の結果を再生します。
• エラーには API 自身のメッセージ、HTTP ステータス、エラー種別が含まれ、エージェントは課金による停止と DNS の問題を区別できます。

SendRaven MCP Server のツール

README には、サーバーのレジストリから生成された 55 のツールが掲載されています。

• トランザクションメール： send_email、send_template_email、list_emails、get_email（イベントの全タイムライン。「なぜこのメールが届かないのか」を調べるためのツール）、cancel_scheduled_email、list_scheduled_emails。
• ドメインと到達率： add_sending_domain、verify_sending_domain、list_sending_domains、および配信停止リスト（list_suppressions、add_suppression、remove_suppression、suppress_many）。
• スレッド： list_threads、get_thread、reply_to_message、mark_thread_handled。
• キャンペーン： create_broadcast、preview_broadcast、send_broadcast、pick_broadcast_winner、resume_broadcast、get_email_metrics。
• 自動化： create_automation、update_automation、set_automation_status、enroll_in_automation、emit_event。
• 連絡先とオーディエンス： add_contact、import_contacts、find_contact、tag_contact、list_segments、count_segment。
• 承認とアカウント： list_pending_approvals、decide_approval、get_usage。

SendRaven MCP Server のユースケース

• サポートエージェント：「未対応のスレッドを確認し、顧客一人ひとりに返信して、対応済みにして。」
• 到達率の確認：「このアドレス宛てのパスワードリセットメールが届かないのはなぜ？」エージェントは get_email と list_suppressions を使います。
• ドメインの設定：「example.com を送信ドメインとして追加し、公開すべき DNS レコードを教えて。」
• キャンペーン：「ニュースレターのオーディエンス向けに一斉配信の下書きを作り、プレビューして、2 つの件名で A/B テストして。」
• 管理されたアウトリーチ：承認保留付きのキーをエージェントに渡し、すべての送信を人の確認待ちにします。

SendRaven MCP Server のトラブルシューティング

• send_email が pending_approval を返す： 失敗ではありません。キーに承認が必要なため、人が送信を許可する必要があります。再試行しないでください。
• HTTP 402 エラー： レート制限ではなく課金による停止です（plan_limit_reached、payment_method_required、billing_past_due、budget_exceeded）。get_usage を呼び出し、再試行を繰り返さないでください。
• 422 no_verified_identity： From のドメインに検証済みの送信ドメインがありません。追加して検証してください。再試行しても解決しません。
• decide_approval が 403 を返す： OAuth でサインインしたクライアント、そのメールを下書きしたキー、ガードレールのあるキーでは承認を決定できません。ダッシュボードを使ってください。
• idempotency_key_reused： 同じキーが異なる引数で送られたため、何も送信されていません。キーはまったく同じメッセージにだけ再利用してください。