Mailrith Email Marketing

Mailrith MCP サーバー

Mailrith の公式 MCP サーバーです。

このサーバーは、Mailrith で生成されたオペレーションスキーマを維持しながら、ホスト型および stdio トランスポートに安定版の @modelcontextprotocol/sdk パッケージを使用します。

ホスト型エージェントとの連携には、リモート MCP エンドポイント https://api.mailrith.com/mcp を使用してください。 stdio またはセルフホスト型 HTTP で利用する場合は、このリポジトリからローカルサーバーを実行してください。 Claude Desktop や、ユーザーが接続するその他のリモート MCP クライアントは、 Mailrith OAuth を通じて認証します。認証情報を安全に保存できるコードファーストのクライアントは、 ワークスペース API キーまたは OAuth アクセストークンを Authorization: Bearer <credential> として送信できます。

公式 MCP レジストリ

レジストリのメタデータを定義する server.json では、サーバーを com.mailrith/mailrith として識別しています。クライアントは、OAuth を通じて認証する 正規の Streamable HTTP エンドポイント https://api.mailrith.com/mcp を利用するか、 npm からローカルの stdio パッケージをインストールできます。ローカルへのインストールには、 MAILRITH_API_KEY にワークスペース API キーを設定する必要があります。

ホスト型サーバーは、汎用エージェント向けにデフォルトで Full Email Marketing Access を要求します。 この権限は、選択したワークスペースのすべての公開メールマーケティング操作を対象としますが、 請求、チーム、アカウントセキュリティ、認証情報の読み取り、内部管理は対象外です。 discovery_get_capabilities 接続チェックは、完全な公開権限カタログを要求することで、 Mailrith がすべての Work Profile を表示し、デフォルトで Full Email Marketing Access を選択できるようにします。 ユーザーは代わりに、Reporting、その他の目的に特化した Work Profile、またはカスタム権限を選択できます。 OAuth にはユーザーが承認した権限のみが保存され、各ツールの実行時に権限が再確認されます。

MAILRITH_API_KEY="<secret>" pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio

ローカルの stdio は、クライアントのシークレット環境から MAILRITH_API_KEY を読み取ります。 サーバーは、認証情報がプロセス一覧やシェル履歴に表示されないよう、コマンド引数で渡された認証情報を拒否します。 ローカルの stdio にはブラウザー経由の OAuth フローがないため、環境変数が設定されていない場合は、 明確なセットアップエラーを表示して停止します。

セルフホスト型 HTTP は、プロセス全体で共有される API キーを読み取りません。 各クライアントは、独自のワークスペース API キーまたは OAuth アクセストークンを Authorization ヘッダーで送信する必要があります。組み込みの HTTP リスナーが受け付けるのは 127.0.0.1 または localhost のみです。別のマシンからアクセスする必要がある場合は、 その前段に TLS リバースプロキシを配置してください。

デフォルトの submitted プロファイルでは、次のような目的に特化したツールを含む、 レビュー済みの固定カタログを公開します。

• subscribers_list
• broadcasts_create
• broadcasts_preflight
• broadcasts_schedule
• broadcasts_send
• sequences_update_status
• automations_update_status

すべての公開ツールには、人が読めるトップレベルのタイトルと annotations.title、対象を絞った説明、正確な入力・出力スキーマ、 明示的な安全性アノテーション、機械可読なオペレーション権限が備わっています。 リクエストボディの入力には、参照先の正確なスキーマに加えて JSON 型も直接公開されるため、 コネクターのレビューツールは、$ref の値を先に展開しなくても検証できます。 接続チェック以外のツールは、それぞれに必要な正確な OAuth 権限を公開します。 接続チェックは、OAuth ですべての Work Profile を選択できるように、完全な権限カタログを公開します。 その結果には、引き続き接続に付与された正確な権限が報告されます。 すべてのユーザーでカタログは同一であるため、クライアントはツールを確実にレビューして選択できます。 ワークスペースのロール、プラン、製品の準備状況、付与された権限は、ツールの実行時に適用されます。 匿名クライアントは、この静的カタログを初期化して一覧表示し、ChatGPT などのホストが OAuth の連携を開始できるようにします。匿名のツール呼び出しが Mailrith 製品 API に到達することはなく、代わりに標準準拠の WWW-Authenticate チャレンジとともに HTTP 401 を返します。より多くの権限が必要な認証済み呼び出しには、置き換え後の権限セット全体とともに HTTP 403 を返します。単一ツールの応答には、アカウントの連携や再接続の際に利用するクライアント向けに、MCP のツールレベルの OAuth チャレンジメタデータも含まれます。 匿名の HTTP リクエストで受け付ける JSON-RPC メッセージは 1 件です。認証済みリクエストでは、最大 25 件のメッセージをバッチ処理できます。これらの上限により、接続しているすべてのワークスペースで、検出とツールの応答が予測可能になります。

自動化の読み取りで、保存済みの Webhook ベアラートークンやカスタムヘッダーの値が返されることはありません。各値が設定されているかどうかだけが返されます。クライアントが自動化を読み取り、伏せ字にされた定義を更新時に送り返した場合、クライアントが明示的に置き換えるか削除しない限り、Mailrith は既存の値を保持します。Webhook の送信先を変更するには、新しい認証情報の値が必要です。これにより、古いシークレットが別のサービスに引き継がれるのを防ぎます。

このパッケージでは、次の 2 つの明示的な互換性プロファイルも保持されています。

• compact は、従来の検出およびルーティング用ツール 7 個を公開します。
• custom は、呼び出し元が選択した Work Profile、権限、読み取り専用フィルターに基づいて、用途を絞ったツールを生成して公開します。

これらのプロファイルは、ローカルクライアントまたは特定用途向けクライアントにのみ使用してください。ChatGPT、Codex、Claude、Cursor の公開パッケージでは、単一の /mcp エンドポイントに固定された submitted プロファイルを使用します。

公式ビルドとフォーク

公開版を変更したものは、パッケージ名、レジストリ名、プラグイン名、サービス名をそれぞれ別のものにし、非公式版であることを明記する必要があります。Mailrith の商標と非公式フォークに関するポリシーを参照してください。