MCP Desteği
AI asistanınızı Unbox'a bağlayın
Güvendiğiniz bir AI ajanının, domain gelen kutunuzda size yardımcı olması için Model Context Protocol (MCP)'ü kullanın — konu başlıklarını arama, taslak yanıtlar oluşturma, e-posta gönderme ve spam veya çöp kutusunu yönetme — Unbox web uygulamasıyla aynı sınırlar ve güvenlikle.
Genel Bakış
Unbox MCP, kişisel hesap sahipleri için tasarlanmıştır; Cursor, Workbuddy, OpenClaw veya MCP uyumlu herhangi bir ana bilgisayarda, barındırılan postalarıyla çalışmak üzere bir AI asistanı isteyenler içindir. Unbox üzerinde uygulama geliştirmek için bir geliştirici API'si değildir; domaininizden işlemsel gönderim için HTTP API dokümanlarımıza bakın.
Ajanların yapabilecekleri
Giriş yaptıktan sonra ajanınız sizin adınıza Unbox araçlarını çağırabilir:
- Gelen kutusu ve konuları oku — Konuşmaları listele, bir konuyu aç ve tek tek mesajları getir.
- Posta ara — Doğal dil sorgularıyla gelen kutunuzdaki mesajları bulun.
- Gönder ve yanıtla — Planınızın gönderim sınırlarına tabi olarak, Unbox adreslerinizden yeni e-posta oluşturun veya bir konuya yanıt verin.
- Düzenle — Spam olarak işaretle, spam'den geri al, çöp kutusuna taşı veya geri yükle — her seferinde bir mesaj.
Toplu spam veya çöp kutusu temizleme, API anahtarı oluşturma ve ekip çalışma alanı işlemleri v1'de MCP üzerinden kullanılamaz.
Nasıl çalışır
AI istemciniz Unbox MCP sunucusuna bağlanır. Sunucu, normal bir web oturumu kullanarak Unbox hesap API'lerini çağırır — unbox.im'de oturum açtığınızda elde ettiğiniz türden bir oturum.
- Unbox'ı MCP istemci yapılandırmanıza ekleyin (aşağıdaki Kurulum bölümüne bakın).
- Ajanınızdan oturum açmasını isteyin — bir tarayıcı bağlantısı açar ve burada Unbox hesabınızla erişimi onaylarsınız.
- Bağlandıktan sonra, ajanınızdan postaları okumasını, taslak yanıtlar oluşturmasını veya mesajları düzenlemesini isteyin.
Oturum aç
Unbox, tarayıcı oturumu kullanır, böylece erişimi her zaman siz onaylarsınız. Ajanınız, oturum açma araçlarıyla akışı başlatır, ardından oturum açmayı tarayıcıda tamamlarsınız:
- Ajanınız unbox_login_start'ı çağırır ve size bir tarayıcı URL'si gösterir.
- Bağlantıyı açın, gerekiyorsa Unbox'a giriş yapın ve sayfada gösterilen tek kullanımlık bağlantı kodunu kopyalayın.
- Kodu tekrar ajanınıza yapıştırın (unbox_login_complete).
- Oturumunuz, normal Unbox web oturum süresi boyunca etkin kalır — süresi dolduğunda tekrar giriş yapın.
Oturum açma URL'si (referans için)
https://unbox.im/tr/auth/desktop/link?source=mcpÖnce bir hesaba mı ihtiyacınız var? Unbox ID'nizi oluşturun, ardından ajanınızı bağlamak için geri dönün.
Kurulum
Unbox'ı AI istemcinizde bir MCP sunucusu olarak ekleyin. Uzaktan HTTP taşıma, Unbox bulutuna bağlanmanın en basit yoludur:
Uzaktan HTTP (önerilir)
MCP istemcinizi Unbox MCP uç noktasına yönlendirin. Sunucuyu ekledikten sonra, kimlik doğrulaması için oturum açma araçlarını kullanın:
{
"mcpServers": {
"unbox": {
"url": "https://unbox.im/api/mcp"
}
}
}HTTP MCP, operatör tarafından etkinleştirilene kadar bazı dağıtımlarda devre dışı bırakılabilir. Bağlantı başarısız olursa daha sonra tekrar deneyin veya destek ekibiyle iletişime geçin.
Sık kullanılan araçlar
Oturum açtıktan sonra aracınız aşağıdaki gibi araçları kullanabilir:
unbox_login_start— tarayıcıda oturum açmayı başlatunbox_login_complete— bağlantı kodunu oturumla değiştirunbox_list_threads— gelen kutusu akışıunbox_search_inbox— mesaj araunbox_reply_to_email— bir mesaja yanıt verunbox_send_email— yeni e-posta gönder
Desteklenen istemciler
MCP uyumlu herhangi bir aracı ana bilgisayar Unbox'a bağlanabilir. Test edip belgelediğimiz araçlar:
- Cursor — Cursor ayarlarında MCP sunucuları altına Unbox'ı ekleyin, ardından tarayıcı akışıyla oturum açın.
- Workbuddy — Unbox'ı işaret eden bir uzak MCP sunucu URL'si yapılandırın, ardından hesabınızla kimlik doğrulaması yapın.
- OpenClaw — OpenClaw'ı Unbox MCP HTTP uç noktasına bağlayın ve tarayıcı oturum açma işlemini tamamlayın.
Güvenlik
- Tarayıcı oturumu — Tarayıcınızda Unbox üzerinden oturum açarsınız — aracılar şifrenizi asla görmez.
- Yalnızca hesap sahibi — MCP erişimi yalnızca kişisel hesap sahibiyle sınırlıdır; ekip üyeleri veya paylaşılan çalışma alanları için geçerli değildir.
- Web uygulamasıyla aynı sınırlar — Gönderme kotaları, spam kuralları ve işlemsel politikalar, aracı eylemleri için gelen kutusu arayüzünde olduğu gibi uygulanır.
- Toplu silme yok — Aracılar, v1'de MCP üzerinden spam klasörünü, çöp kutusunu boşaltamaz veya API anahtarlarını döndüremez.