‍Genel Bakış

Dropbox MCP, Kuika uygulamalarında Dropbox API’si ile güvenli ve standartlaştırılmış dosya işlemleri yapılmasını sağlar.

Bu entegrasyon sayesinde:

• Dosya ve klasör listelenebilir,
• Dosya indirilebilir / yüklenebilir,
• Kopyalama, taşıma, klasör oluşturma işlemleri yapılabilir.

Configuration Manager Üzerinden Ayarların Yapılması

Oluşturulmuş bir konfigürasyon ayarı sadece bir projede kullanılabilir. Başka projelerde kullanılmak istendiğinde aynı ayarların yeniden oluşturulması gerekmektedir.

‍

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 →Dropbox bölümünden ADD NEW seçeneğini tıklayın.
5. Açılan pencerede:
   
   • Name: Ayar için isimlendirme.
   • App Key: Dropbox Developer Console’dan alınan App Key.
   • App Secret: Dropbox Developer Console’dan alınan Secret Key.

Dropbox API Key ve Secret Oluşturma

‍

1. Dropbox Developers Apps sayfasına gidin.
2. Giriş yapılmamışsa Dropbox hesabınızla giriş yapın.
3. Create app butonuna tıklayın.

4. App bilgilerini doldurup uygulamayı oluşturun.

5. Permissions sekmesinden şu scope’ları ekleyin:
   
   • files.metadata.read
   • files.content.read
   • files.content.write
   • sharing.write
   • Account_info.read

‍

6. Settings sekmesine gelin → Redirect URIs alanına şu adresi ekleyin:

https://platformapi.kuika.com/v1/api/McpClient/dropbox-callback

7. Eğer özel bir domain kullanıyorsanız:

<DOMAIN_NAME>/v1/api/McpClient/dropbox-callback

8. Aynı sayfadan App Key ve App Secret Key alınarak Configuration Manager → Dropbox MCP Settings alanına eklenir.

‍

9. Create ile kaydedildikten sonra Dropbox yetkilendirme ekranı açılır → Allow ile izin verilir.

Action Türleri

1. Dropbox Get File Metadata

‍

Bir dosya veya klasörün detaylarını getirir.

• Input:
  
  • settings: Configuration Manager’da tanımlanan bağlantı ayarları.
  • path: Dosya veya klasör yolu. Örn: /Documents/report.pdf
• Output:

‍

• tag, name, id, client_modified, server_modified, rev, size, path_display

2. Dropbox List Files

Belirli bir klasör altındaki dosya ve klasörleri listeler.

• Input:
  
  • settings
  • path: Klasör yolu. Örn: /Projects/Design
• Output:

• tag, name, path_display, size, server_modified_date, client_modified_date

3. Dropbox Download File

‍

Bir dosyayı indirir.

• Input:
  
  • settings
  • path: Dosya yolu. Örn: /Reports/2025-Q1.pdf
• Output:

• uri: Dosyanın indirilebilir URI’si
• mime_type: Dosya türü
• content: Base64 encoded içerik

• encoding: İçerik kodlama bilgisi
• metadata: Dosya bilgileri

4. Dropbox Upload File

Bir dosya yükler.

• Input:
  
  • settings
  • path: Yüklenecek dosyanın yolu.
  • base64Content: Dosya içeriği (Base64)
• Output:

• "success": true

5. Dropbox Move Item

‍

Bir dosya veya klasörü taşır.

• Input:
  
  • Settings
  • from_path: Taşınacak öğenin mevcut yolu
  • to_path: Yeni hedef yol
• Output:

• "success": true

6. Dropbox Copy Item

Bir dosya veya klasörü kopyalar.

• Input:
  
  • settings
  • from_path
  • to_path
• Output:

• "success": true

7. Dropbox Create Folder

Yeni klasör oluşturur.

• Input:
  
  • settings
  • path: Yeni klasörün yolu
• Output:

• "success": true

Kuika’da Kullanım

Configuration Manager’da oluşturulan Dropbox ayarları, projedeki Dropbox Action içinde settings parametresine bağlanarak kullanılabilir.

Örneğin:

• /Projects/Design klasörünü listelemek,
• /Reports/2025-Q1.pdf dosyasını indirmek,
• Yeni bir klasör oluşturmak veya dosya yüklemek.