MCP Server
MCP Server for email checker. Integrate email verification with Claude, Cursor, and AI assistants.
Model Context Protocol(MCP)はAnthropicによるオープンプロトコルで、AIモデルが外部ツールやデータソースと安全にやり取りできるようにします。MCPを通じて、Claudeに自然言語でメールを直接検証させることができます。
MCPとは?
MCPによりAIモデルは以下が可能になります:
- 外部ツールとAPIの呼び出し
- ローカルファイルとデータへのアクセス
- 特定のタスクの実行
EmailVerifyの場合: ユーザーはAPIを手動で呼び出すことなく、自然言語でメールを検証できます。
対応クライアント
| クライアント | ステータス | 説明 |
|---|---|---|
| Claude Desktop | 対応 | Mac/Windowsデスクトップアプリケーション |
| Claude Code | 対応 | CLIプログラミングアシスタント |
| Cursor | 対応 | AIコードエディタ |
| Zed | 対応 | 高性能コードエディタ |
| Cline (VS Code) | 対応 | VS Code AI拡張機能 |
| Continue | 対応 | オープンソースAIアシスタント |
クイックセットアップ
ステップ1: APIキーの取得
EmailVerifyダッシュボードでAPIキーを作成します。
ステップ2: Claude Desktopの設定
設定ファイルを編集:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"emailverify": {
"command": "npx",
"args": ["-y", "@emailverify/mcp-server"],
"env": {
"EMAILVERIFY_API_KEY": "your-api-key-here"
}
}
}
}ステップ3: Claude Desktopを再起動
再起動後、こう言うだけです:
"john@company.comが有効なメールか確認して"
Claude Codeのセットアップ
Claude Codeの場合、設定にMCPサーバーを追加:
claude mcp add emailverify -- npx -y @emailverify/mcp-serverまたは~/.claude/claude_code_config.jsonに追加:
{
"mcpServers": {
"emailverify": {
"command": "npx",
"args": ["-y", "@emailverify/mcp-server"],
"env": {
"EMAILVERIFY_API_KEY": "your-api-key-here"
}
}
}
}Cursorのセットアップ
Cursorで、Settings > MCPに移動し追加:
{
"emailverify": {
"command": "npx",
"args": ["-y", "@emailverify/mcp-server"],
"env": {
"EMAILVERIFY_API_KEY": "your-api-key-here"
}
}
}利用可能なツール
verify_email
単一のメールアドレスを検証します。
パラメータ:
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| string | はい | 検証するメールアドレス |
戻り値:
- メールステータス(valid/invalid/unknown)
- 配信可能性
- 使い捨てメールかどうか
- ロールベースメールかどうか
- 信頼度スコア
Claudeでの使用例:
"test@example.comが有効なメールか確認して"
verify_emails_bulk
複数のメールアドレスを一度に検証します。
パラメータ:
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
| emails | string[] | はい | メールアドレスの配列(最大1000) |
戻り値:
- job_id: ジョブ識別子
- status: 処理ステータス
- total: 合計数
- processed: 処理済み数
Claudeでの使用例:
"これらのメールを検証して: user1@example.com, user2@test.com, info@company.com"
check_credits
アカウント残高とレート制限を確認します。
パラメータ: なし
戻り値:
- 残りクレジット
- レート制限情報
- プラン詳細
Claudeでの使用例:
"検証クレジットの残りはいくつ?"
使用例
基本検証
ユーザー:
john@google.comを検証して
Claude:
そのメールアドレスを検証します。
メール検証結果
フィールド 値 メール john@google.com ステータス 有効 配信可能 はい 使い捨て いいえ スコア 0.95 このメールは有効で配信可能なようです。
複数メール検証
ユーザー:
これらのメールをチェックして: john@google.com, test@mailinator.com, support@microsoft.com
Claude:
3つすべてのメールアドレスを検証します。
メール ステータス 備考 john@google.com 有効 配信可能、企業メール test@mailinator.com 無効 使い捨てメール、拒否推奨 support@microsoft.com 有効 ロールベースアドレス、共有の可能性 推奨:
- john@google.com - 使用しても安全
- test@mailinator.com - 一時メール、非推奨
- support@microsoft.com - 有効だがチームの受信箱の可能性
開発者ワークフロー
ユーザー(Claude Codeで):
.env.exampleファイルのテストメールを検証して
Claude:
ファイルを読み込んで、見つかったメールアドレスを検証します。
.env.exampleで3つのメールアドレスが見つかりました:
- TEST_EMAIL=user@example.com
- ADMIN_EMAIL=admin@company.com
- SUPPORT_EMAIL=help@temp-mail.org
検証結果:
メール ステータス user@example.com 不明(exampleドメイン) admin@company.com 有効 help@temp-mail.org 無効(使い捨て) テスト用に実際のメールアドレスの使用を検討してください。
出力形式
MCPサーバーは整形された結果を返します:
## メール検証結果
**メール:** test@example.com
**ステータス:** 有効
**信頼度スコア:** 95.0%
### 詳細
| チェック | 結果 |
|---------|------|
| 配信可能 | はい |
| 有効な形式 | はい |
| 有効なドメイン | はい |
| 有効なMX | はい |
| 使い捨て | いいえ |
| ロールアドレス | いいえ |
| キャッチオール | いいえ |
| 無料プロバイダー | いいえ |
**使用クレジット:** 1ベストプラクティス
1. APIキーを安全に保存
APIキーをハードコードしないでください。環境変数を使用:
{
"env": {
"EMAILVERIFY_API_KEY": "${EMAILVERIFY_API_KEY}"
}
}2. 自然言語を使用
MCPサーバーはさまざまな表現を理解します:
- "user@example.comを検証して"
- "test@company.comは有効なメール?"
- "このメールが配信可能か確認して: john@test.com"
- "これらのメールアドレスを検証してもらえる?"
3. 可能な場合はバッチ処理
複数のメールの場合、Claudeにまとめて検証するよう依頼して効率化:
"これらのメールを一度に検証して: email1@test.com, email2@test.com, email3@test.com"
トラブルシューティング
MCPサーバーが見つからない
ClaudeがEmailVerifyツールを見つけられないと言う場合:
- 設定ファイルのパスを確認
- JSONが有効であることを確認
- Claude Desktopを完全に再起動
- APIキーが正しいことを確認
レート制限エラー
レート制限エラーが表示される場合:
- "クレジットは何件残ってる?"で残りクレジットを確認
- 少し待ってから再試行
- より高い制限のためのプランアップグレードを検討
接続の問題
検証が失敗する場合:
- インターネット接続を確認
- APIキーが有効であることを確認
- まずシンプルな検証を試す
FAQ
APIキーは安全ですか?
はい。APIキーはローカル設定ファイルに保存され、マシンで実行されるMCPサーバーのみが使用します。第三者に送信されることはありません。
どのAIクライアントがMCPに対応していますか?
Claude Desktop、Claude Code、Cursor、Zed、Cline、Continueなど、MCP対応クライアントならどれでも動作します。
オフライン時はどうなりますか?
EmailVerify APIに到達できない場合、ツールはエラーメッセージを返します。これはClaudeの他の機能には影響しません。
クレジットはどう機能しますか?
各メール検証で1クレジットを使用します。一括検証はメールあたり1クレジットです。check_creditsツールで残高を確認できます。