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.

ProtokolModel Context Protocol (MCP)
KapsamKişisel gelen kutusu — okuma, arama, yanıtlama, gönderme, spam ve çöp kutusu
Kimlik DoğrulamaTarayıcı oturumu → kısa süreli oturum

Ajanların yapabilecekleri

Giriş yaptıktan sonra ajanınız sizin adınıza Unbox araçlarını çağırabilir:

  • Gelen kutusu ve konuları okuKonuşmaları listele, bir konuyu aç ve tek tek mesajları getir.
  • Posta araDoğal dil sorgularıyla gelen kutunuzdaki mesajları bulun.
  • Gönder ve yanıtlaPlanı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üzenleSpam 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.

  1. Unbox'ı MCP istemci yapılandırmanıza ekleyin (aşağıdaki Kurulum bölümüne bakın).
  2. 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.
  3. 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:

  1. Ajanınız unbox_login_start'ı çağırır ve size bir tarayıcı URL'si gösterir.
  2. Bağlantıyı açın, gerekiyorsa Unbox'a giriş yapın ve sayfada gösterilen tek kullanımlık bağlantı kodunu kopyalayın.
  3. Kodu tekrar ajanınıza yapıştırın (unbox_login_complete).
  4. 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_starttarayıcıda oturum açmayı başlat
  • unbox_login_completebağlantı kodunu oturumla değiştir
  • unbox_list_threadsgelen kutusu akışı
  • unbox_search_inboxmesaj ara
  • unbox_reply_to_emailbir mesaja yanıt ver
  • unbox_send_emailyeni e-posta gönder

Desteklenen istemciler

MCP uyumlu herhangi bir aracı ana bilgisayar Unbox'a bağlanabilir. Test edip belgelediğimiz araçlar:

  • CursorCursor ayarlarında MCP sunucuları altına Unbox'ı ekleyin, ardından tarayıcı akışıyla oturum açın.
  • WorkbuddyUnbox'ı işaret eden bir uzak MCP sunucu URL'si yapılandırın, ardından hesabınızla kimlik doğrulaması yapın.
  • OpenClawOpenClaw'ı Unbox MCP HTTP uç noktasına bağlayın ve tarayıcı oturum açma işlemini tamamlayın.

Güvenlik

  • Tarayıcı oturumuTarayıcınızda Unbox üzerinden oturum açarsınız — aracılar şifrenizi asla görmez.
  • Yalnızca hesap sahibiMCP 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ırlarGönderme kotaları, spam kuralları ve işlemsel politikalar, aracı eylemleri için gelen kutusu arayüzünde olduğu gibi uygulanır.
  • Toplu silme yokAracılar, v1'de MCP üzerinden spam klasörünü, çöp kutusunu boşaltamaz veya API anahtarlarını döndüremez.
Unbox — MCP Destek | Unbox.im