FreeCustom.Email MCP — AI Email + OTP Automation for Agents

FreeCustom.Email MCP サーバー

FreeCustom.Email API の公式 Model Context Protocol (MCP) サーバーです。

このサーバーは、AI エージェント（Claude、Cursor、Windsurf、Kilo Code など）向けに特別に設計された、究極の 一時メール API および 一時メール自動化機能を提供します。メールを待って OTP を抽出するための複雑なポーリングロジックを構築する代わりに、AI エージェントは単一のツール呼び出しで受信トレイを作成し、メールを待ち、認証コードを抽出できるようになります。

AI エージェント向けの究極の一時メール

従来の一時メール API プロバイダー（Mailinator、Maildrop、1secmail、Guerrilla Mail など）は、人間による利用や基本的な REST ポーリングを想定して構築されています。高度な AI ワークフローに必要なコンテキストや連携が不足しています。

FreeCustom.Email が AI に適している理由：

機能	従来の一時メール API	FreeCustom.Email MCP
エージェントインターフェース	手動の HTTP REST リクエスト	ネイティブ MCP（Model Context Protocol）ツール
メールを待つ	絶え間ないポーリング（レート制限に達する）	ロングポーリングと Pub/Sub（追加リクエストゼロ）
操作効率	OTP の取得に 3～5 回の操作	1 回のツール呼び出し（create_and_wait_for_otp）
データ解析	AI が煩雑な HTML／テキストを解析する必要がある	サーバーが 4～6 桁の OTP を自動抽出

一時メールのテスト、自動 QA、自律型 AI エージェントのサインアップなど、どのような用途でも、この MCP サーバーが裏側で複雑な処理を担います。

前提条件

この MCP サーバーを使用するには、FreeCustom.Email の Growth または Enterprise プランが必要です。これはプレミアムな AI 自動化機能です。

FreeCustom.Email のダッシュボードで確認できる API キーが必要です。

ウェブベースの AI ツールで MCP を使いたいですか？ Claude Web、OpenAI Playground、Replit Agent、その他のクラウド AI プラットフォームで利用できる公開 MCP エンドポイント https://mcp.freecustom.email/mcp をホストしています。ローカルへのインストールは不要です。Authorization: Bearer ヘッダーで API キーを渡すか、OAuth を使用してください。

インストールと設定

Claude Desktop（ローカル Stdio）の場合

1. お使いの OS に応じて Claude Desktop の設定ファイルを開きます。

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json

2. 次の内容を設定に追加します。

{
  "mcpServers": {
    "fce-mcp": {
      "command": "npx",
      "args": ["-y", "fce-mcp-server"],
      "env": {
        "FCE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Web Chat（claude.ai）の場合

Claude のウェブインターフェースには リモート MCP サーバー URL が必要です。OAuth を使用して Claude Web から直接利用できる、ホスト型 MCP エンドポイント https://mcp.freecustom.email/mcp を提供しています。

1. Claude Web（またはモバイル版 Claude アプリ）を開きます。
2. Settings > Integrations > Add Custom Connector に移動します。
3. 詳細を入力します。
   • Name： FreeCustom.Email MCP
   • Remote MCP Server URL： https://mcp.freecustom.email/mcp
4. Advanced settings で、API キーを OAuth Client ID として追加します（または FreeCustom.Email の API キーを貼り付けます）。
5. Connect をクリックします。

Cursor の場合

1. Cursor の設定を開きます。
2. Features > MCP Servers に移動します。
3. Add New MCP Server をクリックします。
4. Type を command に設定します。
5. 名前を fce-mcp にします。
6. Command：npx -y fce-mcp-server
7. システム環境変数で FCE_API_KEY が設定されていることを確認します。

Windsurf／Windsurf Editor の場合

{
  "mcpServers": {
    "fce-mcp": {
      "command": "npx",
      "args": ["-y", "fce-mcp-server"],
      "env": {
        "FCE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Kilo CLI と Kilo Code の場合

{
  "mcp": {
    "fce-mcp": {
      "type": "local",
      "command": ["npx", "-y", "fce-mcp-server"],
      "environment": {
        "FCE_API_KEY": "your_api_key_here"
      },
      "enabled": true
    }
  }
}

Web ベースの AI プラットフォーム向け

多くの AI プラットフォームでは HTTP エンドポイントが必要です。ホスト型 MCP エンドポイントを使用してください。

プラットフォーム	設定方法
Claude.ai (Web)	Settings → Integrations → Add Custom Connector → URL: https://mcp.freecustom.email/mcp
OpenAI Playground	カスタムの「OpenAI Agents」を使用し、MCP URL に当サービスの URL を設定します
Replit Agent	URL: https://mcp.freecustom.email/mcp と Bearer トークン認証を使用して MCP サーバーを追加します
Agentops / LangChain	MCP クライアントに当サービスの URL を設定し、Authorization: Bearer <YOUR_API_KEY> を渡します

利用可能なツール

接続すると、AI エージェントは以下のツールを利用できるようになります。

メール操作

create_and_wait_for_otp (🔥 GOLD FEATURE)

ランダムな受信トレイを生成し、OTP が届くまで接続を開いたままにします。

• domain（任意）：使用するドメイン（デフォルトは ditube.info）
• timeout（任意）：最大待機時間（秒）（10～60、デフォルトは45）

get_latest_email

指定した受信トレイの最新メールを取得します。

• inbox（必須）：完全なメールアドレス（例：[email protected]）

extract_otp

最新の4～6桁のコードまたは確認リンクを直接取得します。

• inbox（必須）：受信トレイの完全なメールアドレス

watch_email

既存の受信トレイに新しいメールが届くまでロングポーリングで待機します。

• inbox（必須）：監視する受信トレイの完全なメールアドレス
• timeout（任意）：最大待機時間（秒）（10～60、デフォルトは30）
• since（任意）：これより新しいメッセージを待つためのメッセージ ID

get_messages

受信トレイから複数のメッセージを取得します。

• inbox（必須）：完全なメールアドレス
• limit（任意）：メッセージ数（1～100、デフォルトは10）
• unread_only（任意）：未読メッセージのみを取得します

delete_email

受信トレイから特定のメールを削除します。

• inbox（必須）：完全なメールアドレス
• `message_id（必須）：削除するメッセージ ID

受信トレイの管理

list_inboxes

API キーのアカウントが所有するすべての受信トレイを一覧表示します。（引数なし）

カスタムドメインの管理

list_custom_domains

アカウントに関連付けられているすべてのカスタムドメインを一覧表示します。（引数なし）

add_custom_domain

アカウントに新しいカスタムドメインを追加します。

• domain（必須）：カスタムドメイン（例：mail.yourdomain.com）

verify_custom_domain

カスタムドメインの DNS 検証を開始します。

• domain（必須）：検証するカスタムドメイン

delete_custom_domain

アカウントからカスタムドメインを削除します。

• domain（必須）：削除するカスタムドメイン

プラン要件

MCP の利用には Growth または Enterprise プランが必要です。

• Growth：毎分60 ops、同時セッション5件
• Enterprise：毎分200 ops、同時セッション10件

トラブルシューティング

「利用可能なツールがありません」 AI エージェントがツールを利用できないと表示する場合、MCP サーバーの読み込みに失敗しています。

• **アプリを再起動する：**デスクトップエージェントは起動時にのみ設定を読み込みます。完全に終了してから、再度開いてください。
• **ログを確認する：**macOS の Claude の場合：tail -n 50 ~/Library/Logs/Claude/mcp*.log

「Claude Web (claude.ai) を使用している場合」 OAuth／トークンエラーが発生する場合：

• リモート MCP サーバー URL：https://mcp.freecustom.email/mcp（/sse ではありません）を使用してください
• API キーが有効で、Growth／Enterprise プランを利用していることを確認してください

「npx: command not found」 GUI アプリでは $PATH が引き継がれないことがあります。絶対パスを使用してください。

{
  "mcpServers": {
    "fce-mcp": {
      "command": "/usr/local/bin/node", 
      "args": ["/absolute/path/to/fce-mcp-server/build/index.js"],
      "env": { "FCE_API_KEY": "your_api_key_here" }
    }
  }
}

ライセンス

MIT