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.

Configuration Manager Üzerinden Ayarların Yapılması

Oluşturulan bir config 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 seçin.

3. Configuration Manager → App Settings sekmesine gidin.
4. MCP → Office365 bölümünden ADD NEW seçeneğini tıklayın.

Gerekli Alanlar

• Name → Ayara verilecek ad.
• Client ID, Client Secret, Tenant ID, Scope → Azure Portal üzerinden alı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