> 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/otomasyon-api-ve-sdklar/connect-ai-clients-mcp.md).

# AI istemcilerini MCP ile bağlayın

Ayarlar → Otomasyon bölümünde bir MCP jetonu oluşturun ve Claude Desktop, Claude Code, Cursor, Windsurf, VS Code veya Codex CLI'yi Incogniton hesabınıza bağlayın.

Sol taraftaki menüden **Ayarlar**'ı açın, **Otomasyon** sekmesine tıklayın ve **MCP Jetonu Oluştur**'a tıklayın. Ardından **AI istemcinize yükleyin** altında AI istemcinizi seçin ve **Yapılandırmayı kopyala**'ya tıklayın.

MCP (Model Context Protocol), Claude, Cursor veya VS Code gibi bir AI istemcisinin Incogniton hesabınızla çalışmasına olanak tanır. Profil bulma, oluşturma veya düzenleme, proxy'leri, grupları ve etiketleri yönetme ve profilleri başlatma veya durdurma işlemlerini yapabilirsiniz.

Bağlantı, `@incogniton/mcp` npm paketi üzerinden çalışır. AI istemciniz bunu `npx` ile başlatır, bu nedenle AI istemcisinin çalıştığı bilgisayarda [Node.js](https://nodejs.org/) 18 veya daha yenisi gereklidir.

### MCP jetonunuzu oluşturun

{% stepper %}
{% step %}

#### Otomasyon sekmesini açın

Sol taraftaki menüden **Ayarlar**'a tıklayın, ardından **Otomasyon** sekmesine tıklayın. **MCP jetonu** bölümüne gidin.
{% endstep %}

{% step %}

#### Jetonu oluşturun

**MCP Jetonu Oluştur**'a tıklayın. Yeni jeton, butonun altında bir alanda görünür.
{% endstep %}

{% step %}

#### Kopyalayın ve saklayın

Jetonun yanındaki **Kopyala**'ya tıklayın ve güvenli bir yerde saklayın, örneğin bir şifre yöneticisinde. Incogniton jetonu yalnızca bir kez gösterir: **Uyarı: Bu jetonu daha sonra geri alamazsınız — şimdi kopyalayın ve saklayın.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
MCP jetonunu bir şifre gibi saklayın. Ona sahip olan herkes hesabınızın profillerini yönetebilir. Asla paylaşmayın veya herkese açık bir dosyaya yapıştırmayın.
{% endhint %}

### Jetonunuzu değiştirin veya iptal edin

Bir seferde bir aktif MCP jetonunuz vardır. **MCP Jetonu Oluştur**'a tekrar tıklamak yeni bir jeton oluşturur ve eski jetonun çalışmasını durdurur. Bağladığınız her AI istemcisinde jetonu güncelleyin.

Tüm erişimi durdurmak için **Aktif jetonlar** altında **İptal Et**'e tıklayın. Hiçbir jeton aktif değilse, bölüm **Aktif jeton yok** gösterir.

### Incogniton'u AI istemcinize ekleyin

**AI istemcinize yükleyin** altında, **AI istemcisi** açılır menüsünü açın ve istemcinizi seçin: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code veya Codex CLI. Incogniton, yeni jetonunuzla doldurulmuş yapıştırmaya hazır bir yapılandırma gösterir ve nereye yapıştırmanız gerektiğini söyler. **Yapılandırmayı kopyala**'ya tıklayın, uygulamanın söylediği yere yapıştırın ve AI istemcisini yeniden başlatın.

Önce jetonu oluşturun. Bu listeyi daha sonra açarsanız, yapılandırma bir jeton yerine `YOUR_MCP_TOKEN` içerir: sakladığınız jetonla değiştirin.

Diğer MCP istemcilerinde manuel kurulum için [MCP sunucu belgelerine](https://api-docs.incogniton.com/mcp) bakın.

### AI istemcisinin MCP aracılığıyla yapabilecekleri

Bağlandıktan sonra, AI istemciniz şunları yapabilir:

* **Profiller:** profilleri arayın, oluşturun, düzenleyin ve klonlayın, ve yeni bir profil için kullanabileceğiniz grupları, etiketleri, proxy'leri ve tarayıcı dillerini arayın.
* **Gruplar ve etiketler:** profil gruplarını ve etiketlerini arayın ve oluşturun.
* **Proxy'ler:** proxy'leri arayın ve ekleyin, ve proxy gruplarını arayın ve oluşturun.
* **Takım:** takım üyelerini arayın.
* **Başlat ve durdur:** hangi bilgisayarların bir profili başlatabileceğini görün, bir profili başlatın, bir başlatma veya durdurmanın çalışıp çalışmadığını kontrol edin ve bir profili durdurun.
* **Bulut telefonları:** bulut telefonlarınızı listeleyin, Proxy Kitaplığınızdan bir proxy ile bir bulut telefonu oluşturun ve bulut telefonlarını başlatın veya durdurun. MCP aracılığıyla başlatılan telefonlar ekransız başlar.

Tam araç listesi [MCP sunucu belgelerinde](https://api-docs.incogniton.com/mcp) bulunmaktadır.

### MCP aracılığıyla başlatmanın nasıl çalıştığı

Bir profil her zaman bilgisayarlarınızdan birindeki Incogniton uygulamasında açılır. O bilgisayarın uygulamayı açık ve hesabınıza giriş yapmış olması gerekir.

* Bir bilgisayar müsaitse, profil orada başlatılır. Birkaç bilgisayar varsa, AI istemcisi bilgisayarların listesini alır ve siz birini seçersiniz.
* Hiçbir bilgisayarın 5 dakika içinde almadığı bir başlatma isteği sona erer.
* MCP yalnızca MCP aracılığıyla başlatılan profilleri durdurabilir. Incogniton uygulamasından kendiniz açtığınız bir profili kapatın.

### MCP başlatmasından sonra tarayıcıyı kontrol edin

MCP yalnızca profilleri açar ve kapatır. Tarayıcı içinde tıklayamaz, yazamaz veya sayfaları okuyamaz.

Bir başlatmadan sonra, AI istemcisi çalışan tarayıcının yerel bir DevTools adresini (`cdp_url`) alabilir. Kod çalıştırabilen bir AI istemcisi, Puppeteer, Playwright veya bir tarayıcı MCP'yi o adrese bağlayabilir.

{% hint style="info" %}
`cdp_url` yalnızca AI istemcisi, profili başlatan Incogniton uygulamasıyla **aynı bilgisayarda** çalıştığında çalışır. Başka bir bilgisayardan veya Claude Desktop gibi kod çalıştıramayan bir istemciden çalışmaz. Ayrıca Otomasyon sekmesinde **Tarayıcı uzaktan kontrolüne izin ver**'in açık olması gerekir. [Tarayıcı uzaktan kontrolü](https://docs.incogniton.com/documentation/turkish-documentation/otomasyon-api-ve-sdklar/browser-remote-control.md) bölümüne bakın.
{% endhint %}

### MCP'nin yapamayacakları

Bu işlemler MCP aracılığıyla yapılamaz:

* Çalışan bir profilde bir URL açma, sekmeleri yönetme veya sayfaları okuma.
* Bir proxy'nin çalışıp çalışmadığını kontrol etme.
* Profilleri silme.
* Bir profili yedekten geri yükleme.

Incogniton uygulamasının içindeki AI asistanı Cas, bunları yapabilir. Bunları kullanmak için uygulamada Cas'i açın.

### Sorun Giderme

* **İstemci Incogniton araçlarını göstermiyor:** yapılandırmayı yapıştırdıktan sonra AI istemcisini yeniden başlatın ve Node.js 18 veya daha yenisinin yüklü olduğunu kontrol edin.
* **İstemcinin MCP günlüğü "eksik taşıyıcı jeton" gösteriyor:** jeton yapılandırmadan eksik. `YOUR_MCP_TOKEN` yerine jetonunuzu yapıştırın.
* **Kimlik doğrulama hataları:** jeton değiştirildi veya iptal edildi. Yeni bir tane oluşturun ve yapılandırmayı güncelleyin.

Kendi bilgisayarınızda çalışan betikler için [yerel REST API](https://docs.incogniton.com/documentation/turkish-documentation/otomasyon-api-ve-sdklar/local-rest-api.md) veya [JavaScript ve Python SDK](https://docs.incogniton.com/documentation/turkish-documentation/otomasyon-api-ve-sdklar/javascript-and-python-sdk.md) kullanabilirsiniz.
