Genel Bakış

Office365 MCP, Kuika uygulamanızda e-posta servislerini (mail listeleme, detay görüntüleme, klasör sorgulama ve mail gönderme) kullanabilmenizi sağlar.

Config Manager Üzerinden Ayarların Yapılması

Oluşturulan bir konfigürasyon ayarı yalnızca bir projede kullanılabilir. Başka projelerde kullanılmak istenirse yeniden oluşturulması gerekir.

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışacağınız projeyi açın.
3. Üst menüden Config Manager modülüne tıklayın.

4. Var olan bir konfigürasyonu düzenlemek için listeden adına tıklayın veya Create a blank configuration kartıyla yeni bir konfigürasyon oluşturun.
5. Konfigürasyon ekranının üst kısmında App Settings sekmesinin seçili olduğundan emin olun.
6. Sol menüde INTEGRATIONS başlığı altındaki MCP seçeneğine tıklayın.
7. Office 365 alanının altındaki Add New bağlantısına tıklayın.

8. Açılan Office365 MCP Setting penceresinde aşağıdaki alanları doldurun.

Gerekli Alanlar

Tüm alanlar zorunludur. Client ID, Client Secret, Tenant ID ve Scope bilgileri Azure Portal’da Microsoft Entra ID > App registrations bölümünde kaydettiğiniz uygulamadan alınır.

• Name: Yapılandırmaya verilecek ad.
• Client ID: Uygulamanızın Overview sayfasındaki Application (client) ID değeri.
• Client Secret: Uygulamanızın Certificates & secrets sayfasında oluşturduğunuz gizli anahtarın değeri.
• Tenant Id: Uygulamanızın Overview sayfasındaki Directory (tenant) ID değeri.
• Scope: Uygulamanın erişim izinleri (ör. User.Read, Mail.Read, Files.Read). Birden fazla izin gerekiyorsa aralarına boşluk koyularak yazılır. Bu izinlerin uygulamanızın API permissions sayfasında da tanımlı olması gerekir.

Yapılandırmayı Tamamlayın

1. Tüm alanları doldurduktan sonra Create butonuna tıklayın.
2. Office 365 hesabınıza yönlendirilirsiniz. Gerekli izni verin; izin adımı tamamlandığında yönlendirme (redirect) URL’si aracılığıyla Kuika’ya geri dönersiniz.
3. Office 365 açılır menüsünden oluşturduğunuz yapılandırmayı seçin.
4. Sağ üst köşedeki Save butonuna tıklayarak değişiklikleri kaydedin. (Mevcut bir konfigürasyonda bu buton Update olarak görünür.)

Azure Üzerinden Bilgi Oluşturma

1. Azure Portal’a gidin ve giriş yapın.

2. Microsoft Entra ID → Uygulama Kayıtları → Yeni Kayıt adımlarını izleyin.

• Name: İstediğiniz bir ad yazabilirsiniz.
• Desteklenen hesap türleri: Çok kiracılı ve kişisel hesaplar seçilmeli.
• Redirect URI:
  
  • Kuika için → https://platformapi.kuika.com/v1/api/McpClient/office365-callback
  • Özel domain için → <DOMAIN_NAME>/v1/api/McpClient/office365-callback

3. Kaydettikten sonra:
   
   • Application (Client) ID → Client ID

4. Sertifikalar ve Gizli Diziler → Yeni İstemci Gizli Dizisi adımıyla Client Secret oluşturun.

5. API İzinleri → İzin Ekle → Microsoft Graph → Uygulama İzinleri bölümünden şu izinleri ekleyin:
   
   • Mail.ReadBasic
   • Mail.Read
   • Mail.ReadWrite
   • Mail.Send

6. İzinler eklendikten sonra Yönetici Onayı (Admin Consent) verin.

Configuration Manager’da Kayıt

• Tenant ID için → common
• Scope için → offline_access Mail.ReadBasic Mail.Read Mail.ReadWrite Mail.Send

Alanları doldurduktan sonra Create butonuna basın.

‍

• Microsoft oturum açma ekranı gelir, giriş yapıp onay verin.
• Başarılı mesaj alındıktan sonra tekrar Create butonuna basarak işlemi tamamlayın.

Ayar artık Office365 Actions içinde kullanılabilir.

Action Türleri

1. Office365 List Mails

‍

Kullanıcının e-postalarını listeler.

Input

• settings (Config – zorunlu): Configuration Manager’da tanımlanmış Office365 ayarı.
• includeHiddenMessages (Boolean – opsiyonel): Gizli/sistem mailleri de getirilsin mi?
  
  • true → Gizli mailleri de listeler.
  • false (default) → Sadece görünen mailler.
• search (String – opsiyonel): Basit arama filtresi. (Ör: "subject:'invoice'")
• filter (String – opsiyonel): OData tabanlı gelişmiş filtre. (Ör: "from/emailAddress/address eq 'abc@company.com'")
• count (Integer – opsiyonel): Döndürülecek maksimum mail sayısı. (Default: 10)
• skip (Integer – opsiyonel): İlk kaç kaydın atlanacağı. (Sayfalama için)

Output

• id (String): Mailin benzersiz kimliği.
• subject (String): Mail konusu.
• body_preview (String): Mail gövdesinin ilk 255 karakterlik özeti.
• sender (Object): Gönderen bilgisi.
  
  • name (String) → Gönderenin adı.
  • address (String) → Gönderenin e-posta adresi.
• received_date_time (DateTime): Mailin alındığı zaman.
• sent_date_time (DateTime): Mailin gönderildiği zaman.
• has_attachment (Boolean): Mailde ek var mı?
• is_read (Boolean): Mail okunmuş mu?
• is_draft (Boolean): Taslak mı?
• importance (Enum): Mailin önemi: low, normal, high.
  
  
• web_link (String): Mailin Outlook Web’deki bağlantısı.
• categories (Array): Outlook renkli kategoriler listesi.
• body (Object): Mail gövdesi.
  
  • content_type (String) → "text" veya "html".
  • content (String) → Gövde içeriği.

2. Office365 Get Mail

Tek bir mailin detaylarını getirir.

Input

• settings (Config – zorunlu): Configuration Manager’daki Office365 ayarı.
• messageId (String – zorunlu): Mailin benzersiz kimliği. (List Mails ile bulunur.)

Output

• id (String): Mailin benzersiz kimliği.
• subject (String): Mailin konusu.
• body (Object): Tam gövde içeriği.
  
  • content_type (String) → "text" veya "html".
  • content (String) → Mailin tam içeriği.
• sender (Object): Gönderen bilgisi.
  
  • name (String)
  • address (String)
• has_attachment (Boolean): Ek var mı?
• is_read (Boolean): Okundu mu?
• is_draft (Boolean): Taslak mı?
• importance (Enum): Önem derecesi.
• received_date_time (DateTime): Alınma zamanı.
• sent_date_time (DateTime): Gönderilme zamanı.

3. Office365 List Mail Folders

Kullanıcının klasörlerini listeler.

Input

• settings → Office365 ayarı

Output

• id (String): Klasörün kimliği.
• display_name (String): Klasör adı. (Inbox, Sent Items, Drafts vb.)
• parent_folder_id (String): Üst klasör ID’si.
• child_folder_count (Integer): Alt klasör sayısı.
• unread_item_count (Integer): Okunmamış mail sayısı.
• total_item_count (Integer): Toplam mail sayısı.
• size_in_bytes (Integer): Klasörün toplam boyutu.
• is_hidden (Boolean): Sistem klasörü mü?

4. Office365 List Mails By Folder

Belirli bir klasördeki mailleri getirir.

Input

• settings (Config – zorunlu): Office365 ayarı.
• mailFolderId (String – zorunlu): Klasör kimliği (List Mail Folders ile bulunur).
• search (String – opsiyonel): Basit arama.
• filter (String – opsiyonel): OData filtre.
• count (Integer – opsiyonel): Maksimum sonuç sayısı.
• skip (Integer – opsiyonel): İlk kaç kaydın atlanacağı.

Output

• List Mails ile aynı alanlar döner.

5. Office365 Send Mail

Yeni bir e-posta gönderir.

Input

• settings (Config – zorunlu): Office365 ayarı.
• subject (String – zorunlu): Mail konusu.
• body (String – zorunlu): Mail içeriği.
• to (Array – zorunlu): Ana alıcı(lar). (Örn: ["abc@company.com"])
• cc (Array – opsiyonel): Bilgi alıcıları.
• bcc (Array – opsiyonel): Gizli alıcılar.

Output

• success (Boolean): İşlem başarılı ise true döner.

Kuika’da Kullanım

Oluşturulan Office365 ayarı, projedeki Office365 Action’larda settings parametresine bağlanarak kullanılabilir.

Örnek Senaryolar:

• Gelen kutusundaki son 10 maili getirme → List Mails (count=10)
• Belirli klasördeki mailleri listeleme → List Mails By Folder
• Tek bir mailin detayını görüntüleme → Get Mail
• Yeni e-posta gönderme → Send Mail