Підтримка MCP
Підключіть свого AI-помічника до Unbox
Використовуйте Model Context Protocol (MCP), щоб дозволити довіреному AI-агенту допомагати з вашою поштовою скринькою домену — шукати теми, створювати чернетки відповідей, надсилати листи та керувати спамом або кошиком — з тими ж обмеженнями та безпекою, що й веб-додаток Unbox.
Огляд
Unbox MCP призначений для власників особистих облікових записів, які хочуть мати AI-помічника — у Cursor, Workbuddy, OpenClaw або будь-якому сумісному з MCP хості — для роботи з їхньою розміщеною поштою. Це не API для розробників для створення додатків на Unbox; для транзакційної відправки з вашого домену дивіться нашу документацію HTTP API.
Що можуть робити агенти
Після входу ваш агент може викликати інструменти Unbox від вашого імені:
- Читання скриньки та обговорень — Переглядати розмови, відкривати обговорення та отримувати окремі повідомлення.
- Пошук листів — Знаходьте повідомлення у вашій скриньці за допомогою запитів природною мовою.
- Надсилання та відповіді — Створюйте нові листи або відповідайте в обговореннях з ваших адрес Unbox, відповідно до лімітів надсилання вашого плану.
- Організація — Позначати спам, відновлювати зі спаму, переміщувати до кошика або відновлювати — по одному повідомленню.
Масове очищення спаму або кошика, генерація ключів API та дії в командному робочому просторі недоступні через MCP у версії v1.
Як це працює
Ваш AI-клієнт підключається до сервера Unbox MCP. Сервер викликає API облікового запису Unbox, використовуючи звичайну веб-сесію — таку ж, як при вході на unbox.im.
- Додайте Unbox до конфігурації вашого MCP-клієнта (див. Налаштування нижче).
- Попросіть вашого агента увійти — він відкриє посилання в браузері, де ви надаєте доступ за допомогою вашого облікового запису Unbox.
- Після підключення попросіть агента читати пошту, створювати чернетки відповідей або організовувати повідомлення.
Увійти
Unbox використовує вхід через браузер, щоб ви завжди надавали доступ. Ваш агент запускає процес за допомогою інструментів входу, а потім ви завершуєте вхід у браузері:
- Ваш агент викликає unbox_login_start і показує вам URL-адресу браузера.
- Відкрийте посилання, увійдіть до Unbox, якщо потрібно, та скопіюйте одноразовий код посилання, показаний на сторінці.
- Вставте код назад вашому агенту (unbox_login_complete).
- Ваша сесія залишається активною протягом звичайного періоду веб-сесії Unbox — увійдіть знову, коли вона закінчиться.
URL для входу (для довідки)
https://unbox.im/uk/auth/desktop/link?source=mcpСпочатку потрібен обліковий запис? Створіть ваш Unbox ID, а потім поверніться, щоб підключити агента.
Налаштування
Додайте Unbox як сервер MCP у вашому AI-клієнті. Віддалений HTTP-транспорт — це найпростіший спосіб підключення до хмари Unbox:
Віддалений HTTP (рекомендовано)
Спрямуйте ваш MCP-клієнт на кінцеву точку MCP Unbox. Після додавання сервера використовуйте інструменти входу для автентифікації:
{
"mcpServers": {
"unbox": {
"url": "https://unbox.im/api/mcp"
}
}
}HTTP MCP може бути вимкнено на деяких розгортаннях, доки його не увімкне оператор. Якщо з'єднання не вдається, спробуйте пізніше або зверніться до служби підтримки.
Поширені інструменти
Після входу ваш агент може використовувати такі інструменти, як:
unbox_login_start— відкрити вхід через браузерunbox_login_complete— обміняти код посилання на сесіюunbox_list_threads— стрічка вхіднихunbox_search_inbox— пошук повідомленьunbox_reply_to_email— відповісти на повідомленняunbox_send_email— надіслати новий лист
Підтримувані клієнти
Будь-який MCP-сумісний агент-хост може підключитися до Unbox. Ми тестуємо та документуємо:
- Cursor — Додайте Unbox у розділі MCP серверів у налаштуваннях Cursor, а потім увійдіть через браузер.
- Workbuddy — Налаштуйте URL віддаленого MCP сервера, що вказує на Unbox, а потім автентифікуйтеся за допомогою свого облікового запису.
- OpenClaw — Підключіть OpenClaw до кінцевої точки Unbox MCP HTTP та завершіть вхід через браузер.
Безпека
- Вхід через браузер — Ви входите через Unbox у своєму браузері — агенти ніколи не бачать вашого пароля.
- Тільки власник облікового запису — Доступ до MCP обмежений лише власником особистого облікового запису, а не членами команди або спільними робочими просторами.
- Ті самі обмеження, що й у веб-додатку — Квоти на надсилання, правила спаму та транзакційна політика застосовуються до дій агента так само, як і в інтерфейсі вхідних.
- Без масового видалення — Агенти не можуть очищати спам, смітник або змінювати ключі API через MCP у версії v1.