MisarMail MCP Server について
MisarMail MCP Server は、AI アシスタントから MisarMail のメール、キャンペーン、連絡先、自動化、到達性機能を利用できるサービスです。MCP 対応クライアントでメール運用やレポートを扱うチーム向けです。
主な機能
- 01トランザクションメールの送信と管理
- 02メールキャンペーンの作成と予約
- 03連絡先と自動化の管理
- 04キャンペーンの A/B テスト
- 05分析と収益アトリビューションの確認
- 06ドメインとメール到達性の監査
活用シーン
- 01領収書などのトランザクションメール送信
- 02メールキャンペーンの準備と効果測定
- 03連絡先リストの整理とセグメント分け
- 04ドメイン認証やメール到達の問題調査
MCP 対応
MisarMail の操作を MCP ツール、プロンプト、読み取り専用リソースとして公開します。stdio と Streamable HTTP に対応し、操作にはブラウザログインまたは API キーが必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.misar.io/mail/mcpclaude mcp add --transport http misar-ai-misarmail https://api.misar.io/mail/mcp{"mcpServers":{"misar-ai-misarmail":{"type":"http","url":"https://api.misar.io/mail/mcp"}}}Cursor で開く{"servers":{"misar-ai-misarmail":{"type":"http","url":"https://api.misar.io/mail/mcp"}}}VS Code で開く{"mcpServers":{"misar-ai-misarmail":{"type":"http","url":"https://api.misar.io/mail/mcp"}}}{"mcpServers":{"misar-ai-misarmail":{"serverUrl":"https://api.misar.io/mail/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://api.misar.io/mail/mcp認証が必要ツール
55| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| cc | array | いいえ | CC 受信者(最大 50 件) |
| to | array | はい | 受信者リスト(1~100 件のアドレス) |
| bcc | array | いいえ | BCC 受信者(最大 50 件。他の受信者には表示されません) |
| from | object | はい | 送信者アドレス(認証済みの MisarMail アカウントと一致する必要があります) |
| from.name | string | いいえ | 受信者に表示される送信者名 |
| from.email | string | はい | 送信者のメールアドレス |
| html | string | いいえ | HTML 本文(最大 500KB、推奨) |
| tags | array | いいえ | トラッキング用タグ(最大 10 個、各 64 文字まで) |
| text | string | いいえ | プレーンテキスト本文(最大 500KB、HTML の代替として使用) |
| subject | string | はい | メールの件名(最大 998 文字) |
| alias_id | string | いいえ | 特定のエイリアス SMTP プール経由でルーティングします |
| metadata | object | いいえ | カスタムメタデータのキーと値のペア(最大 20 組) |
| reply_to | object | いいえ | 返信先アドレス |
| reply_to.name | string | いいえ | |
| reply_to.email | string | いいえ | |
| idempotency_key | string | いいえ | 重複送信を防ぐ一意のキー(最大 128 文字) |
詳細
MisarMail MCP サーバー
あらゆる AI アシスタントから、メールの送信、キャンペーンの実施、連絡先や自動化の管理、A/B テスト、配信到達性の監査を行えます。
55 個のツール · 8 個のプロンプト · 4 個のリソース · 8 個のエージェントスキル
Claude(Desktop、Code、Web)、Cursor、VS Code、Windsurf、Cline、 Zed、Gemini CLI、ChatGPT、その他すべての MCP 互換クライアントで利用できます。stdio または Streamable HTTP 経由で接続できます。
インストール
Smithery(推奨)
npx -y @smithery/cli install misar/misarmail-mcp --client claude
Claude Code
claude mcp add misarmail -- npx -y @misarmail/mcp@latest
手動(すべてのクライアント)
{
"mcpServers": {
"misarmail": {
"command": "npx",
"args": ["-y", "@misarmail/mcp@latest"],
"env": { "MISARMAIL_API_KEY": "msk_your_key_here" }
}
}
}
各クライアント向けの設定例は connectors/ にあります。
リモート(インストール不要)
{
"mcpServers": {
"misarmail": {
"type": "streamable-http",
"url": "https://api.misar.io/mail/mcp",
"headers": { "Authorization": "Bearer msk_your_key_here" }
}
}
}
認証
2 つの方法があります。1 つ目はコピー&ペーストが不要です。
- ブラウザログイン。 キーを指定せずにサーバーを起動し、
loginツールを実行します。 MisarMail の同意画面が開くので、要求された 権限を確認すると、キーがそのまま返され、~/.misarmail/config.jsonに保存されます。 - API キー。 https://mail.misar.io/developers で作成し、
MISARMAIL_API_KEYを設定します。
セルフホスト型インスタンスの場合は、MISARMAIL_BASE_URL を設定します。
ツール
| ツール | 説明 |
|---|---|
send_email | 認証済みの MisarMail アカウントからトランザクションメールを送信します。 |
list_emails | メールボックスのフォルダー内のメールを一覧表示します。件名と本文を対象とした全文検索も任意で実行できます。 |
get_email | ID を指定して単一のメールの全文を読み取ります。ヘッダー、本文、添付ファイルのメタデータを含みます。 |
reply_to_email | 既存のメールスレッドに返信します。 |
archive_email | メールをアーカイブフォルダーに移動します。 |
validate_email | 送信前にメールアドレスを検証します。構文、MX レコード、使い捨てドメイン、ロールアカウントの検出を行います。 |
list_campaigns | メールマーケティングキャンペーンを、ステータス、オーディエンスの規模、主要な指標とともに一覧表示します。 |
get_campaign | 1 件のキャンペーンの詳細を取得します。コンテンツ、オーディエンスセグメント、スケジュール、配信統計(送信、開封、クリック、バウンス、苦情)を含みます。 |
create_campaign | 新しいメールマーケティングキャンペーンを下書きとして作成します。 |
send_campaign | キャンペーンをすぐに送信するか、scheduled_at を指定して将来の日時に送信するようスケジュールします。 |
list_contacts | 連絡先を、購読ステータスやエンゲージメント指標とともに一覧表示します。 |
create_contact | 連絡先を 1 件追加します。 |
update_contact | メールアドレスで既存の連絡先を更新します。購読ステータスの変更も可能です。 |
import_contacts | 1 回の呼び出しで最大 5,000 件の連絡先を一括インポートします。 |
get_contact_score | 1 件の連絡先のエンゲージメントスコア、エンゲージメントティア、解約リスクを取得します。contact_id を省略すると、リスト内でエンゲージメントが最も低い連絡先を取得します。 |
list_templates | 保存済みメールテンプレートを変数プレースホルダーとともに一覧表示します。キャンペーンやトランザクションメールの送信に使用するテンプレートを選べます。 |
create_template | 再利用可能なメールテンプレートを作成します。 |
render_template | サンプル変数を使ってテンプレートをレンダリングし、生成された HTML と件名を返します。 |
list_automations | 自動化ワークフロー(ウェルカムシリーズ、再エンゲージメント、ドリップシーケンス)を、トリガーの種類や有効状態とともに一覧表示します。 |
get_automation | 1 件の自動化ワークフローの全詳細を取得します。トリガー、遅延時間を含む各ステップ、ステップごとの完了統計を含みます。 |
create_automation | トリガーを指定して自動化ワークフローを作成し、一時停止中の下書きとして保存します。 |
toggle_automation | 自動化を有効化または一時停止します。 |
list_ab_tests | A/B テストを、バリアントごとの結果や勝者が選定済みかどうかとともに一覧表示します。 |
create_ab_test | キャンペーンに A/B テストのバリアントを 1 つ作成します。 |
select_ab_test_winner | 勝者のバリアントを選定し、残りのオーディエンスに送信します。 |
get_analytics | アカウントまたは 1 件のキャンペーンについて、日/週/月単位でグループ化した配信・エンゲージメント分析(送信、配信、開封、クリック、バウンス、苦情)を取得します。 |
get_analytics_timeline | すべての送信手段(キャンペーン、受信トレイからの作成、API、MCP、SDK、GraphQL、自動化)について、送信、配信、開封、クリック、バウンス、苦情、返信、購読解除を日/週/月単位で取得します。 |
generate_report | 指定した期間の構造化された分析レポートを生成します。 |
get_revenue_attribution | メールに対する EC 売上のアトリビューションを行います。追跡対象のコンバージョンから、キャンペーン別・連絡先別の売上と平均注文額を取得します。 |
get_monetization_stats | ニュースレターの収益化統計(有料購読者、MRR、解約、期間中のスポンサー収益)を取得します。 |
get_deliverability_score | アカウントの配信スコア(0~100)と評価(A~F)、スコアを引き下げている要因を取得します。 |
run_deliverability_audit | 認証(SPF/DKIM/DMARC)、ドメインの評判、リストの衛生状態、コンテンツのシグナル、ブロックリストの状態を含む、配信に関する包括的な監査を実行します。 |
get_warmup_status | IP/ドメインのウォームアップ状況と、本日の残りの送信可能数を取得します。 |
check_dmarc | ドメインの SPF、DKIM、DMARC の DNS レコードをリアルタイムで確認し、公開すべき正確なレコードとともにアライメントの問題を報告します。 |
list_domains | 送信ドメインを、認証ステータスや DKIM/SPF/DMARC レコードとともに一覧表示します。 |
add_domain | 送信ドメインを追加し、公開する DNS レコードを返します。 |
verify_domain | ドメインの DNS レコードを再確認し、解決される場合は認証済みとしてマークします。 |
configure_inbound_domain | サブドメインの受信メールルーティングを設定し、返信が MisarMail の統合受信トレイに届くようにします。 |
list_forms | 登録フォームを、埋め込み状況やコンバージョン数とともに一覧表示します。 |
get_form | フィールド、埋め込みコード、リダイレクト動作を含む 1 件の登録フォームを取得します。 |
get_form_submissions | 登録フォームへの送信内容を、送信されたフィールド値やタイムスタンプとともに一覧表示します。 |
create_landing_page | ヒーローブロック(見出し、副見出し、CTA)を 1 つ備えたホスティング型ランディングページを作成します。 |
list_marketplace_items | MisarMail テンプレートマーケットプレイスで、すぐに使えるメールや自動化のテンプレートを閲覧します。 |
get_marketplace_item | プレビュー全体、作成者、インストール数を含むマーケットプレイスの掲載情報を 1 件取得します。 |
list_inbox_conversations | 統合受信トレイの会話(スレッド)を、ステータスや検出された意図とともに一覧表示します。 |
get_inbox_conversation_messages | 1 件の受信トレイ会話に含まれるすべてのメッセージを、古い順に送信者やタイムスタンプとともに取得します。 |
categorize_inbox_emails | 受信トレイのメールをまとめて AI で分類し、意図や優先度のラベルを付けます。 |
list_api_keys | アカウントの API キーを、スコープや最終使用時刻とともに一覧表示します。 |
generate_subject_lines | キャンペーンのトピックに応じた件名のバリエーションを AI で生成します。トーンやオーディエンスに合わせて調整することもできます。 |
list_integrations | 接続済みのサードパーティ統合と同期ステータスを一覧表示します。 |
get_integration | 1 件の統合について、設定、スコープ、最終同期結果を取得します。 |
toggle_integration | 統合を有効または無効にします。 |
list_sandbox_sends | サンドボックスモードで取得されたメールを一覧表示します。 |
clear_sandbox | 取得済みのサンドボックスメールをすべて削除します。 |
upgrade | 現在の MisarMail プラン、各クォータの残量、アップグレードで利用可能になる内容を、アップグレード用リンクとともに表示します。 |
プロンプト
クライアントがスラッシュコマンドとして公開する、再利用可能なワークフローです。
| プロンプト | 説明 |
|---|---|
compose_email | プロフェッショナルなメールを作成し、確認後にMisarMailで送信します。 |
campaign_performance_report | キャンペーンのパフォーマンスを分析し、優先順位を付けた改善案を作成します。 |
contact_import_guide | 同意とデータ衛生のチェックを行いながら、安全に連絡先をインポートして整理します。 |
automation_builder_guide | メール自動化ワークフローを段階的に設計、構築します。 |
deliverability_improvement_plan | 配信到達性を診断し、優先順位を付けた週間アクションプランを作成します。 |
ab_test_plan | キャンペーン向けに、統計的に有意義なA/Bテストを設計します。 |
list_hygiene_audit | 送信者の評価を損なっている連絡先を見つけて整理します。 |
weekly_email_report | 関係者に共有できる、週次のメールパフォーマンス概要を作成します。 |
リソース
ツール呼び出しを消費せずに、エージェントが読み取り専用のコンテキストとして添付できる情報です。
| URI | 説明 |
|---|---|
misarmail://account/domains | 送信ドメインと、その検証状況およびDNSレコードです。 |
misarmail://account/deliverability | 現在のアカウントの配信到達性スコア(0~100)、評価、およびその要因です。 |
misarmail://account/warmup | IP/ドメインのウォームアップ段階と、今日の残りの送信可能数です。これは一括送信で超えてはならない上限です。 |
misarmail://templates | キャンペーンや送信で再利用できる、宣言済み変数を含む保存済みテンプレートです。 |
エージェントスキル
skills/ に含まれています。タスクに合致する場合にエージェントが読み込むガイダンスです。
| スキル | 使用する場面 |
|---|---|
ab-test-campaign | MisarMailのキャンペーンで、件名、コンテンツ、送信者名、送信時刻のA/Bテストを設計して実施する場合に使用します。「A/Bテスト」「スプリットテスト」「どの件名のほうが効果的か」といった質問や、メールのバリエーションをテストする場合に使用します。 |
audit-deliverability | MisarMailのメールが迷惑メールに振り分けられたり、バウンスしたりする理由を診断し、優先順位を付けた修正項目の一覧を作成します。「メールが迷惑メールに入る」「配信されない」「開封率が低い」「ドメイン評価」、DMARC/SPF/DKIM、ブロックリストに関する質問に使用します。 |
build-email-automation | MisarMailの自動化ワークフロー(ウェルカムシリーズ、ドリップシーケンス、再エンゲージメント、オンボーディングなど)を設計、構築します。「自動化」「ドリップ」「ウェルカムシリーズ」「シーケンス」や、トリガーベースのメールに関する依頼に使用します。 |
clean-contact-list | MisarMailの連絡先リストを監査、整理します。バウンスした連絡先、苦情を寄せた連絡先、エンゲージメントのない連絡先が対象です。リストのデータ衛生、再エンゲージメント、配信抑制、「開封率が下がっている理由」に関する依頼に使用します。 |
email-performance-report | MisarMailのパフォーマンスレポート(開封数、クリック数、配信到達性、収益への貢献)を作成します。「メールの調子はどうか」、週次/月次レポート、キャンペーンのパフォーマンス分析に関する依頼に使用します。 |
run-email-campaign | MisarMailで一括メールキャンペーンを作成、確認、送信します。リスト、ニュースレター、セグメント、または多数の宛先への告知メールを送りたい場合に使用します。 |
send-transactional-email | MisarMailで単発メールまたはトランザクションメールを送信します。領収書、通知、ウェルカムメッセージ、個別の連絡などを含め、メールの送信、下書きと送信、返信を依頼された場合に使用します。 |
setup-sending-domain | SPF、DKIM、DMARC、受信ルーティングを含め、カスタム送信ドメインをMisarMailに追加して検証します。「独自ドメインから送信」、DNSの設定、ドメインの検証、受信メールに関する依頼に使用します。 |
安全性
破壊的で取り消せない操作にはdestructiveHintが付記されているため、
クライアントは実行前に確認を求めることができます。スキルでは、
メールの送信、コンテンツの公開、またはその他の方法で他者に表示される操作の前に、
エージェントが確認するよう指示しています。
検出(initialize、tools/list、prompts/list、resources/list)
には認証情報が不要なため、レジストリは認証情報なしでサーバーをインデックス化できます。
すべての操作には認証情報が必要です。
Links
- Website — https://www.misarmail.com
- App — https://mail.misar.io
- Documentation — https://docs.misar.io/mail/mcp
- Smithery — https://smithery.ai/server/misar/misarmail-mcp
- npm — https://www.npmjs.com/package/@misarmail/mcp
- Source — https://github.com/Misar-AI/misarmail-mcp
MIT © Misar.AI
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。