mailsocket — MCP-сервер для Claude Code: что делает и как установить
Предоставляет ИИ-агентам временные почтовые ящики и блокирует выполнение, пока во входящие не придёт одноразовый пароль или ссылка для входа.
claude mcp add --env MAILSOCKET_API_KEY=<MAILSOCKET_API_KEY> --env MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL> --transport stdio mcp -- uvx mailsocket-mcpЧто делает mailsocket
Интеграция даёт агенту набор инструментов для работы с входящей почтой. Модель может создать ящик командой create_inbox, а затем вызвать wait_for_otp или wait_for_link. Агенту не нужно писать циклы опроса: инструмент сам удерживает соединение, пока письмо не будет получено. Перехода по ссылке не происходит.
Сервер работает локально через uvx mailsocket-mcp или подключается к удалённому эндпоинту https://mcp.mailsocket.app/mcp. Для локального запуска нужен Python 3.10 и выше. Без переменной MAILSOCKET_API_KEY процесс сразу завершается с кодом 2. При удалённом вызове таймаут ожидания ограничен 55 секундами.
Для проверки сценариев есть команда send_test_code. Она отправляет тестовый код прямо во входящие без участия почтового сервера. На один ящик разрешено не больше пяти тестовых писем в час.
Какие задачи решает
- получить одноразовый код подтверждения при регистрации агентом
- извлечь ссылку для авторизации из входящего письма
- проверить сценарий авторизации с помощью тестового кода
- создать временный почтовый адрес для тестов без настройки почтового сервера
Примеры запросов агенту
- Создай временную почту и дождись OTP-код для регистрации.
- Подожди ссылку авторизации в ящике с идентификатором
inbox_id. - Отправь тестовый код в ящик и проверь чтение сообщений.
Как установить mailsocket
1Командой платформы
claude mcp add --env MAILSOCKET_API_KEY=<MAILSOCKET_API_KEY> --env MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL> --transport stdio mcp -- uvx mailsocket-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mailsocket-mcp <команда>
2Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.mailsocket.app/mcp1Командой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.mailsocket.app/mcp2Командой платформы
codex mcp add mcp --env MAILSOCKET_API_KEY=<MAILSOCKET_API_KEY> --env MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL> -- uvx mailsocket-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mailsocket-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.mailsocket.app/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>",
"MAILSOCKET_BASE_URL": "<MAILSOCKET_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mailsocket-mcp <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.mailsocket.app/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mailsocket-mcp"
],
"env": {
"MAILSOCKET_API_KEY": "<MAILSOCKET_API_KEY>",
"MAILSOCKET_BASE_URL": "<MAILSOCKET_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mailsocket-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.mailsocket.app/mcp2Командой платформы
gemini mcp add -e MAILSOCKET_API_KEY=<MAILSOCKET_API_KEY> -e MAILSOCKET_BASE_URL=<MAILSOCKET_BASE_URL> mcp uvx mailsocket-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mailsocket-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mailsocket
Как установить mailsocket в Claude Code?
Выполните команду claude mcp add mailsocket-mcp -e MAILSOCKET_API_KEY=<MAILSOCKET_API_KEY> -- uvx mailsocket-mcp. Вместо плейсхолдера подставьте ваш ключ доступа.
Что делает mailsocket?
Сервер даёт агенту инструменты для создания временных адресов и ожидания писем. Агент получает коды подтверждения и ссылки авторизации без написания собственного кода поллинга.
Чем отличается вызов ожидания на удалённом сервере от локального?
Удалённый сервис принудительно ограничивает ожидание 55 секундами для защиты от таймаута прокси. При локальном запуске предел ожидания достигает 120 секунд.
