MCP Server
MCP Server for email checker. Integrate email verification with Claude, Cursor, and AI assistants.
Model Context Protocol (MCP) - это открытый протокол от Anthropic, который позволяет ИИ-моделям безопасно взаимодействовать с внешними инструментами и источниками данных. Через MCP вы можете позволить Claude напрямую верифицировать email, используя естественный язык.
Что такое MCP?
MCP позволяет ИИ-моделям:
- Вызывать внешние инструменты и API
- Получать доступ к локальным файлам и данным
- Выполнять определенные задачи
Для EmailVerify: Пользователи могут верифицировать email на естественном языке без ручного вызова API.
Поддерживаемые клиенты
| Клиент | Статус | Описание |
|---|---|---|
| Claude Desktop | Поддерживается | Десктопное приложение для Mac/Windows |
| Claude Code | Поддерживается | CLI-ассистент для программирования |
| Cursor | Поддерживается | ИИ-редактор кода |
| Zed | Поддерживается | Высокопроизводительный редактор кода |
| Cline (VS Code) | Поддерживается | ИИ-расширение для VS Code |
| Continue | Поддерживается | ИИ-ассистент с открытым исходным кодом |
Быстрая настройка
Шаг 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 действительным email"
Настройка 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
Верификация одного email-адреса.
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| string | Да | Email-адрес для верификации |
Возвращает:
- Статус email (valid/invalid/unknown)
- Доставляемость
- Является ли временным email
- Является ли ролевым email
- Оценка уверенности
Пример использования в Claude:
"Проверь, является ли test@example.com действительным email"
verify_emails_bulk
Верификация нескольких email-адресов сразу.
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| emails | string[] | Да | Массив email-адресов (макс. 1000) |
Возвращает:
- job_id: Идентификатор задачи
- status: Статус обработки
- total: Общее количество
- processed: Обработано
Пример использования в Claude:
"Проверь эти email: user1@example.com, user2@test.com, info@company.com"
check_credits
Проверка баланса аккаунта и лимитов.
Параметры: Нет
Возвращает:
- Оставшиеся кредиты
- Информация о лимитах
- Детали плана
Пример использования в Claude:
"Сколько у меня осталось кредитов на верификацию?"
Примеры использования
Базовая верификация
Пользователь:
Проверь john@google.com
Claude:
Я проверю этот email-адрес для вас.
Результат верификации email
Поле Значение john@google.com Статус Действителен Доставляемый Да Временный Нет Оценка 0.95 Этот email выглядит действительным и доставляемым.
Верификация нескольких email
Пользователь:
Проверь эти email: john@google.com, test@mailinator.com, support@microsoft.com
Claude:
Я проверю все три email-адреса.
Статус Примечания john@google.com Действителен Доставляемый, корпоративный email test@mailinator.com Недействителен Временный email, рекомендую отклонить support@microsoft.com Действителен Ролевой адрес, может быть общим Рекомендации:
- john@google.com - Безопасен для использования
- test@mailinator.com - Временный email, не рекомендуется
- support@microsoft.com - Действителен, но вероятно общий ящик команды
Рабочий процесс разработчика
Пользователь (в Claude Code):
Проверь тестовые email в моем файле .env.example
Claude:
Прочитаю файл и проверю найденные email-адреса.
Найдено 3 email-адреса в .env.example:
- 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 Недействителен (временный) Рассмотрите использование реальных email-адресов для тестирования.
Формат вывода
MCP-сервер возвращает хорошо отформатированные результаты:
## Результат верификации email
**Email:** test@example.com
**Статус:** ДЕЙСТВИТЕЛЕН
**Оценка уверенности:** 95.0%
### Детали
| Проверка | Результат |
|----------|-----------|
| Доставляемый | Да |
| Валидный формат | Да |
| Валидный домен | Да |
| Валидный MX | Да |
| Временный | Нет |
| Ролевой адрес | Нет |
| Catch-all | Нет |
| Бесплатный провайдер | Нет |
**Использовано кредитов:** 1Лучшие практики
1. Храните API-ключ безопасно
Никогда не хардкодьте ваш API-ключ. Используйте переменные окружения:
{
"env": {
"EMAILVERIFY_API_KEY": "${EMAILVERIFY_API_KEY}"
}
}2. Используйте естественный язык
MCP-сервер понимает различные формулировки:
- "Проверь user@example.com"
- "Является ли test@company.com действительным email?"
- "Проверь, доставляемый ли этот email: john@test.com"
- "Можешь проверить эти email-адреса для меня?"
3. Группируйте, когда возможно
Для нескольких email попросите Claude проверить их вместе для эффективности:
"Проверь все эти email сразу: email1@test.com, email2@test.com, email3@test.com"
Устранение неполадок
MCP-сервер не найден
Если Claude говорит, что не может найти инструмент EmailVerify:
- Проверьте путь к файлу конфигурации
- Убедитесь, что JSON валиден
- Полностью перезапустите Claude Desktop
- Проверьте, что ваш API-ключ корректен
Ошибки лимита запросов
Если вы видите ошибки лимита запросов:
- Проверьте оставшиеся кредиты вопросом "Сколько у меня кредитов?"
- Подождите немного и попробуйте снова
- Рассмотрите обновление плана для более высоких лимитов
Проблемы с подключением
Если верификация не удается:
- Проверьте ваше интернет-соединение
- Убедитесь, что ваш API-ключ действителен
- Попробуйте сначала простую верификацию
FAQ
Безопасен ли мой API-ключ?
Да. API-ключ хранится в вашем локальном файле конфигурации и используется только MCP-сервером, работающим на вашей машине. Он никогда не отправляется третьим сторонам.
Какие ИИ-клиенты поддерживают MCP?
Работает любой MCP-совместимый клиент, включая Claude Desktop, Claude Code, Cursor, Zed, Cline и Continue.
Что происходит при отсутствии сети?
Если API EmailVerify недоступен, инструмент возвращает сообщение об ошибке. Это не влияет на другие возможности Claude.
Как работают кредиты?
Каждая верификация email использует 1 кредит. Массовые верификации используют 1 кредит на email. Проверьте баланс с помощью инструмента check_credits.