> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/turkish-documentation/bulut-telefonlar/control-cloud-phones-from-scripts.md).

# Bulut telefonlarını scriptler ve AI istemcileri ile kontrol edin

Kendi scriptlerinizden yerel REST API veya Incogniton CLI ile veya MCP aracılığıyla bir AI istemcisi ile bulut telefonları listeleyin, başlatın, durdurun ve bağlanın.

Yerel REST API'yi **Ayarlar > Otomasyon** bölümünde açın (**Otomasyon API'sini etkinleştir** seçeneğini açın ve **Kaydet**'e tıklayın). Scriptleriniz ve Incogniton CLI, bulut telefonlarınızı listeleyebilir, başlatabilir ve durdurabilir, ve onlar için bir ADB adresi alabilir. **MCP token** ile bağlanmış AI istemcileri, bulut telefonlarını listeleyebilir, başlatabilir, durdurabilir ve oluşturabilir.

Bu sayfa, uygulama dışından telefonları kontrol etme ile ilgilidir. Incogniton içinde telefonlarda çalıştırdığınız hazır görevler için [Bulut telefonlarını yönetme](https://docs.incogniton.com/documentation/turkish-documentation/bulut-telefonlar/manage-cloud-phones.md#automation) bölümündeki **Telefon otomasyonu**'na bakın.

### İhtiyacınız olanlar

* **Ayarlar > Otomasyon** bölümünde yerel REST API'nin açılmış olması. [Yerel REST API'yi kullanma](https://docs.incogniton.com/documentation/turkish-documentation/otomasyon-api-ve-sdklar/local-rest-api.md) bölümüne bakın. Otomasyon API'si ücretli bir özelliktir.
* Scriptinizle aynı bilgisayarda açık ve giriş yapılmış Incogniton. API varsayılan olarak `127.0.0.1`, port 35000 üzerinde dinler.
* Bir ekipte, doğru bulut telefon izni: Telefonları listelemek, başlatmak ve durdurmak için **Bulut telefonlarını kullan (güç, yeniden başlatma, bağlanma)** ve ADB'yi açmak için **Bulut telefonlarını yönet (düzenleme, proxy, sıfırlama, Android sürümü, ADB, root, uygulamalar, otomasyon, taşıma)**.

### Yerel REST API ile yapabilecekleriniz

| Eylem                                                                                           | Endpoint                         | CLI komutu                 |
| ----------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------- |
| Ekibinizin bulut telefonlarını ID, ad, grup, durum, Android sürümü ve ADB adresi ile listeleyin | `GET /cloudphone/list`           | `cloudphone-list`          |
| Telefonları ekranlarını açmadan başlatın (ADB, uygulamalar ve otomasyon için)                   | `POST /cloudphone/start`         | `cloudphone-start`         |
| Telefonları başlatın ve her birinin ekranını Incogniton'da bir pencerede açın                   | `POST /cloudphone/start-display` | `cloudphone-start-display` |
| Telefonları kapatın                                                                             | `POST /cloudphone/stop`          | `cloudphone-stop`          |
| Çalışan bir telefonda ADB'yi etkinleştirin ve yerel adresini alın                               | `POST /cloudphone/adb`           | `cloudphone-adb`           |

Başlatma ve durdurma, telefon listesinden 1 ila 100 telefon ID'si alır. Her telefon kendi başına kontrol edilir (kalan dakika, abonelik aktif, proxy ayarlanmış, sıfırlanmıyor), bu nedenle bazı telefonlar başlatılabilirken diğerleri reddedilebilir; cevap her telefon için nedeni verir.

Bu şekilde başlatılan bir telefon, durdurulana kadar çalışmaya ve dakika kullanmaya devam eder. Bir telefonu durdurmak, penceresini ve Incogniton'daki yerel ADB bağlantısını da kapatır.

ADB eylemi, `127.0.0.1:6555` gibi bir yerel adres döndürür. Uygulamadaki **ADB komutunu kopyala** adresi gibi `adb connect` ile bağlanın. Telefon çalışıyor olmalıdır. [Bir bulut telefonuna ADB ile bağlanma](https://docs.incogniton.com/documentation/turkish-documentation/bulut-telefonlar/connect-to-a-cloud-phone-with-adb.md) bölümüne bakın.

Yerel REST API aracılığıyla bir bulut telefonunu düzenleyemez, yeniden başlatamaz veya sıfırlayamazsınız. Bunu uygulamada yapın: [Bir bulut telefonunu düzenleme, yeniden başlatma veya sıfırlama](https://docs.incogniton.com/documentation/turkish-documentation/bulut-telefonlar/edit-restart-and-reset-cloud-phones.md) bölümüne bakın.

### Incogniton CLI'yi kullanma

Yukarıdaki her eylemin eşleşen bir CLI komutu vardır. **Otomasyon** sekmesinde **CLI'yi İndir**'e tıklayarak yükleyin; yüklendiğinde, uygulama başladığında kendini günceller. Telefonlarınızı ve ID'lerini görmek için `incogniton-cli cloudphone-list` çalıştırın. Komutların, bayrakların ve çıktının nasıl çalıştığını görmek için [CLI belgelerine](https://api-docs.incogniton.com/cli) bakın.

### AI istemcisinden bulut telefonları kontrol etme (MCP)

Claude veya Cursor gibi bir AI istemcisini MCP token ile bağladığınızda (**Ayarlar > Otomasyon > MCP Token Oluştur**, [AI istemcilerini MCP ile bağlama](https://docs.incogniton.com/documentation/turkish-documentation/otomasyon-api-ve-sdklar/connect-ai-clients-mcp.md) bölümüne bakın), AI istemcisi:

* Bulut telefonlarınızı durumları ve ADB'nin açık olup olmadığı ile **listeleyebilir**.
* Ekransız, ADB, yüklü uygulamalar ve otomasyon için telefonları **başlatabilir**.
* Telefonları **durdurabilir**.
* Proxy Kütüphanenizden bir proxy ile yeni bir bulut telefonu **oluşturabilir**.

MCP araçları Incogniton'un sunucularında çalışır, bu nedenle Incogniton uygulaması kapalıyken de çalışırlar. Bir telefonun ekranını açamazlar: bir telefonu görmek için uygulamada açın (**Bulut Telefonları**, ardından **Güç Aç** veya **Bağlan**). MCP aracılığıyla başlatılan bir telefon, durdurulana kadar veya **Incogniton kapandığında bulut telefonlarımı durdur** açıkken Incogniton uygulamanız kapanana kadar çalışmaya devam eder (otomasyon görevi çalıştıran telefonlar çalışmaya devam eder).

{% hint style="info" %}
[api-docs.incogniton.com](https://api-docs.incogniton.com/apis) adresindeki geliştirici belgeleri profil, çerez ve otomasyon endpointlerini kapsar. Bulut telefonlarını otomatikleştirme hakkında sorularınız varsa [destek departmanımızla](https://incogniton.com/contact/) iletişime geçin.
{% endhint %}
