MCP Server

模型上下文協定(MCP)是 Anthropic 推出的開放協定,使 AI 模型能夠安全地與外部工具和資料來源互動。透過 MCP,您可以讓 Claude 使用自然語言直接驗證郵箱。

什麼是 MCP?

MCP 允許 AI 模型:

• 呼叫外部工具和 API
• 存取本地檔案和資料
• 執行特定任務

**對於 EmailVerify:**使用者可以使用自然語言驗證郵箱,無需手動呼叫 API。

支援的客戶端

快速設定

步驟 1: 取得 API Key

造訪 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

驗證單個郵箱地址。

參數:

返回:

• 郵箱狀態(valid/invalid/unknown)
• 可送達性
• 是否為一次性郵箱
• 是否為角色郵箱
• 置信度分數

在 Claude 中的使用範例:

"檢查 test@example.com 是否是有效郵箱"

verify_emails_bulk

一次驗證多個郵箱地址。

參數:

返回:

• 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:

我會驗證所有三個郵箱地址。

郵箱	狀態	備註
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	未知(範例網域)
admin@company.com	有效
help@temp-mail.org	無效(一次性)

考慮使用真實郵箱地址進行測試。

輸出格式

MCP 伺服器返回格式良好的結果:

## 郵箱驗證結果

**郵箱:** test@example.com
**狀態:** VALID
**置信度分數:** 95.0%

### 詳情
| 檢查項 | 結果 |
|-------|--------|
| 可送達 | 是 |
| 格式有效 | 是 |
| 網域有效 | 是 |
| MX 記錄有效 | 是 |
| 一次性 | 否 |
| 角色地址 | 否 |
| 全捕獲 | 否 |
| 免費提供商 | 否 |

**使用積分:** 1

最佳實踐

1. 安全儲存 API Key

永遠不要硬編碼您的 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 工具:

1. 檢查您的設定檔路徑
2. 確保 JSON 格式有效
3. 完全重新啟動 Claude Desktop
4. 驗證您的 API 金鑰正確

速率限制錯誤

如果您看到速率限制錯誤:

1. 用 "我還有多少積分?" 檢查剩餘積分
2. 稍等片刻再試
3. 考慮升級您的套餐以取得更高限制

連線問題

如果驗證失敗:

1. 檢查您的網路連線
2. 驗證您的 API 金鑰有效
3. 先嘗試簡單的驗證

常見問題

我的 API 金鑰安全嗎?

是的。API 金鑰儲存在您的本地設定檔中,僅由執行在您機器上的 MCP 伺服器使用。它永遠不會傳送給第三方。

哪些 AI 客戶端支援 MCP?

任何相容 MCP 的客戶端都可以工作,包括 Claude Desktop、Claude Code、Cursor、Zed、Cline 和 Continue。

離線時會發生什麼?

如果無法存取 EmailVerify API,工具會返回錯誤訊息。這不會影響 Claude 的其他功能。

積分如何計算?

每次郵箱驗證使用 1 個積分。批次驗證每個郵箱使用 1 個積分。使用 check_credits 工具檢查您的餘額。

下一步