Warm Inbox

Warm Inbox MCP サーバー

Warm Inbox 向けのホステッド型Model Context Protocolサーバーです。Warm Inbox は、メールのウォームアップと到達率を改善するサービスです。AI アシスタントやアプリ開発者（Cursor、Claude Code、Lovable、Bolt、Replit、v0、Windsurf、Base44 など）が、ウォームアップの状態やスパム率を確認し、安全なホステッドリンクを通じてメールボックスを接続し、1 日あたりの送信量を一時停止、再開、調整できます。

• エンドポイント： https://mcp.warminbox.org/mcp（Streamable HTTP、ステートレス）
• 認証： Authorization: Bearer wi_live_...、https://warminbox.org/public-api/keys.php から取得したご自身の Warm Inbox API キー
• サーバーカード： https://mcp.warminbox.org/.well-known/mcp/server-card.json
• MCP レジストリ名： org.warminbox/mcp
• プライバシー： https://warminbox.org/privacy-policy · 利用規約： https://warminbox.org/terms-of-service · サポート： https://warminbox.org/contact-us

安全性

• AI がメールボックスのパスワードを扱うことはありません。 新しいウォームアップは create_connect_link 経由でのみ作成されます。AI は 1 回限りの URL（有効期間 30 分）を表示し、SMTP/IMAP または Gmail の認証情報は、Warm Inbox のホステッドページで入力します。ツールのスキーマは厳格で、パスワードなどの不明なフィールドは拒否します。
• サーバーには何も保存されません。キー、セッション、データベース、リクエストログはありません。各リクエストの Bearer キーは Warm Inbox REST API に転送され、破棄されます。上流からの出力ではキーが伏せられます。
• 有効な形式のキーがないリクエストには、WWW-Authenticate: Bearer を付けて 401 を返します。
• Warm Inbox ダッシュボードで作成したキャンペーンは表示されますが、読み取り専用です。

ツール

ツール	REST 操作	入力
get_account	GET /me	なし
list_warmups	GET /warmups	なし
get_warmup	GET /warmups/{id}	id
get_warmup_health	GET /warmups/{id}/health	id
create_connect_link	POST /connect-links	type（smtp/gmail）、email、first_name、last_name、emails_per_day（整数 0～200）、response_rate（整数 0～100）。すべて必須
pause_warmup	POST /warmups/{id}/pause	id
resume_warmup	POST /warmups/{id}/resume	id
set_emails_per_day	PATCH /warmups/{id}	id、emails_per_day（整数 0～200）

成功時の JSON オブジェクトは、structuredContent およびシリアライズされたテキスト内で（キーの伏せ字化を除き）変更されずに返されます。これにより、リスト内の {data:[...]}、アカウント／プランのフィールド、ウォームアップの source/read_only フラグ、null 許容のヘルスメトリクス、{url,expires_at} 形式の接続リンクが保持されます。API の {error:{code,message,...}} エラーは、読みやすいステータス／コード／メッセージのテキストと構造化されたエラー詳細を含む isError:true に変換されます。ネットワーク、タイムアウト、無効な JSON によるエラーは、汎用ツールエラーになります。タイムアウトは 15 秒です。接続が失敗する前に書き込みが成功している可能性があるため、自動再試行は行いません。ダッシュボードのキャンペーンは読み取り専用で、書き込みは 404 または 403 を返します。一時停止、再開、送信量の変更は、元に戻せる非破壊的かつ冪等な操作です。接続リンクの作成は非冪等です。

任意のプロンプト setup_warmup は、アカウントの確認、機密情報ではないフィールドの収集、接続 URL の表示、ユーザーの入力待ち、ウォームアップの一覧表示、状態の確認をガイドします。

すべてのツールには、人が読める title と完全なアノテーション（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）があります。

クライアントの設定

エンドポイント https://mcp.warminbox.org/mcp とヘッダー Authorization: Bearer <your-own-wi_live_key> を使用します。キーは Warm Inbox API keys から取得してください。以下の例にはプレースホルダーのみが含まれています。認証情報は各アプリで非公開に設定し、設定済みの構成をコミットしたり、実際のキーをインストールリンクに埋め込んだりしないでください。

ドキュメント確認日：2026-10-31。UI のラベルやプランの提供状況は変わる場合があります。アプリ内で確認と記された項目は、現在アクセス可能な公式ドキュメントでは確認できませんでした。

Lovable

カスタム MCP チャットコネクターを追加し、Warm Inbox と名前を付けて、エンドポイントを入力し、ベアラートークン／API キー認証を選択します。トークンには wi_live_... キーを設定します。UI に生のヘッダーを入力する項目がある場合は、Authorization: Bearer ... を使用してください。「Use Warm Inbox to list my warm-ups.」と尋ねます。カスタム MCP はビルダーのコンテキストであり、生成されたアプリにランタイムのバックエンド統合を自動的にインストールするものではありません。公式のセットアップと認証方式。

Bolt.new

Connectors を開き、カスタム Connector を追加して、URL にエンドポイント、トランスポートに HTTP を設定します。API キー認証を選択し、送信ヘッダーが Authorization: Bearer ... となるようにキーを指定します（正確なフィールド／プレフィックスの動作については、アプリ内で確認してください）。Bolt の公式発表では、リモートカスタムコネクターと API キー／OAuth 認証情報が確認されています。この UI でベアラーヘッダーを送信できない場合は、OAuth が追加されるまで、この UI を通じてこのサーバーに接続できません。

Replit Agent

Integrations → MCP Servers → Add MCP server で、Warm Inbox と名前を付けてエンドポイントを入力します。Advanced settings で、Authorization に値 Bearer <your-own-wi_live_key> を追加し、Test & save を選択します。カスタムサーバーの公式ガイド。

Replit への公式追加リンクの形式：https://replit.com/integrations?mcp=<URL-encoded-base64-JSON>。ペイロード：

{"displayName":"Warm Inbox","baseUrl":"https://mcp.warminbox.org/mcp","headers":[{"key":"Authorization","value":"Bearer <your-own-wi_live_key>"}]}

公開用のインストールリンクではヘッダーを省略し、インストール後に利用者自身がキーを非公開で追加するよう案内してください。キーを含まないリンクをローカルで生成するには、次のコマンドを使用します：

const payload = { displayName: 'Warm Inbox', baseUrl: 'https://mcp.warminbox.org/mcp' };
console.log('https://replit.com/integrations?mcp=' + encodeURIComponent(Buffer.from(JSON.stringify(payload)).toString('base64')));

v0

MCP Connections（またはプロンプトフォームの MCP 項目）を開き、Warm Inbox とエンドポイントを追加します。カスタムヘッダーを設定できる場合は、Authorization のベアラーヘッダーを設定します（アプリ内で確認してください）。MCP 統合の公式ページでは、どちらの追加方法も確認されています。任意のベアラーヘッダーをサポートするかどうかは確認されていません。OAuth のみの接続画面では、現時点でこのサーバーを使用できません。

Windsurf

~/.codeium/windsurf/mcp_config.json に次の内容を設定します：

{"mcpServers":{"warminbox":{"serverUrl":"https://mcp.warminbox.org/mcp","headers":{"Authorization":"Bearer <your-own-wi_live_key>"}}}}

Cascade で MCP サーバーを再読み込みします。Windsurf は現在 Devin Desktop です。そちらでは、同じ url と headers のブロックを .devin/config.json または ~/.config/devin/config.json に追加します。

Cursor

.cursor/mcp.json に設定します（実際のキーには、非公開のユーザー設定を推奨します）：

{"mcpServers":{"warminbox":{"url":"https://mcp.warminbox.org/mcp","headers":{"Authorization":"Bearer <your-own-wi_live_key>"}}}}

MCP 設定でサーバーを有効にします。公式の設定方法。公式のインストール用ディープリンク：

cursor://anysphere.cursor-deeplink/mcp/install?name=warminbox&config=<URL-encoded-base64-JSON-config>

単一サーバー設定を使って公式ジェネレーターを使用するか、認証情報を含まないリンクを生成します：

const config = { url: 'https://mcp.warminbox.org/mcp' };
console.log('cursor://anysphere.cursor-deeplink/mcp/install?name=warminbox&config=' + encodeURIComponent(Buffer.from(JSON.stringify(config)).toString('base64')));

インストール後、Authorization を非公開で追加してください。ベアラーキーをディープリンクに含めて配布しないでください。

Claude Code

claude mcp add --transport http warminbox https://mcp.warminbox.org/mcp \
  --header 'Authorization: Bearer <your-own-wi_live_key>'

/mcp を使って接続を確認します。HTTP トランスポート／ヘッダーに関する公式ドキュメント。キーは非公開で入力してください。シェルの履歴やローカルのクライアント設定に入力した認証情報が保持される場合があります。

Claude.ai / Claude Desktop のカスタムコネクター

Settings → Connectors → Add custom connector → エンドポイント URL。リモートコネクターの公式ガイド。**制限事項：**一部のコネクター UI は OAuth または認証なしのみをサポートし、任意のベアラーヘッダーを入力できません。このサーバーは認証なしの接続を拒否し、OAuth も実装していないため、そのような UI から直接接続することはできません。ベアラーヘッダーの入力欄があるかどうかは、アプリ内で確認してください。当面は Claude Code を使用してください。キーを URL に含めないでください。

開発／セルフホスト

Node 20+。

npm ci
npm test               # mocked fetch, never calls production
npm run build
npm run typecheck:worker
npm start              # Node entry on :3100 (PORT, WARMINBOX_API_BASE env)
npx wrangler deploy    # or deploy src/worker.ts to Cloudflare Workers (wrangler.jsonc)

src/core/ には共有 API クライアント、ツール、サーバーカードが含まれています。src/node.ts（Express）と src/worker.ts（Workers）は、薄いエントリーポイントです。ecosystem.config.cjs は、リバースプロキシの背後で Node を実行する PM2 の設定例です。

ファイル一覧

server.json（MCP Registry）、.well-known/mcp/server-card.json（ライブカードのスナップショット）、glama.json（Glama の所有権）、.mcp.json / mcp.json / .cursor-plugin/plugin.json（Cursor プラグインと cursor.directory）。

ライセンス

MIT です。LICENSE を参照してください。