İstemci bağlamak
appdyno, Mac’inizde, kullandığı telefonun ya da simülatörün yanında çalışır. İstemci ise sizin konuştuğunuz uygulamadır. Bu sayfa ikisini nasıl bağlayacağınızı istemci istemci anlatır, ayrıca hiçbir şey kurulu değilken bir telefonu nasıl hazırlayacağınızı gösterir. Her istemcinin neler sunduğu 2026-11-04’te kendi belgelerinden okundu. Bunlar sık değişir: bir menünün yeri değiştiyse istemcinin kendi sayfasına güvenin. İstemcilerin menü adları İngilizce arayüzdeki gibi yazıldı; telefon ayarlarının adları ise üreticiye ve sürüme göre değişebilir.
İstemcilerin çoğu appdyno’yu Mac’inizde kendisi başlatır ve appdyno kurulduktan sonra bunun için ağ gerekmez. Tek istisna: Mac uygulaması olmadan, ilk Android trace’i kendi trace processor’ını bir kez indirir. Tarayıcıda çalışan bir istemci ise Mac’inizde hiçbir şey başlatamaz. Zor olan durum budur.
| istemci | appdyno’ya nasıl ulaşır | başlangıç noktası |
|---|---|---|
| Claude Code, Claude Desktop | Mac’inizde çalıştırır | Bu Mac’teki istemciler |
| Codex, ChatGPT masaüstü uygulaması | Mac’inizde çalıştırır | Bu Mac’teki istemciler |
| Cursor, VS Code, Devin Desktop, Antigravity | Mac’inizde çalıştırır | Bu Mac’teki istemciler |
| Gemini CLI, Zed, opencode, Cline | Mac’inizde çalıştırır | Bu Mac’teki istemciler |
| Tarayıcıda ChatGPT | sizin çalıştırdığınız bir tünel; Business, Enterprise, Edu | Tarayıcıda ChatGPT |
| Tarayıcıda, telefonda, Cowork’te Claude | sizin çalıştırdığınız bir tünel | Tarayıcıda Claude |
Sonra cihazınızı hazırlayın: Android, iPhone veya simülatör. Bir şey ters giderse Çalışmıyorsa bölümüne bakın.
appdyno’yu kurmak
Section titled “appdyno’yu kurmak”Çoğu kişi için Mac uygulaması yeterlidir, terminal gerektirmez. npm paketi CI ve geliştiriciler içindir. İkisi de aynı kodu çalıştırır.
Mac uygulaması
Section titled “Mac uygulaması”Apple silicon işlemcili, macOS 13.5 ya da üstü bir Mac gerekir. Node, Xcode ya da terminal gerekmez: uygulama kendi Node’unu, Android ajanını ve penceresini içinde taşır.
Appdyno-<version>-arm64.dmgdosyasını sürümler sayfasından indirip açın.- Appdyno’yu Applications klasörüne sürükleyin.
- Appdyno’yu açın. Hub açılır, menü çubuğunda cihazlarınızla birlikte bir simge kalır. Dock’ta Appdyno yalnızca bir pencere açıkken görünür.
İlk açılış. Bir sürüm Developer ID ile imzalıdır ve Apple’ın noter onayından geçmiştir, bu yüzden çift tıklamayla açılır. macOS internetten gelen bir uygulamayı açmak isteyip istemediğinizi bir kez sorar: Open’a tıklayın.
Noter onayından geçmemiş bir derleme, örneğin bir kaynak kopyasından yapılıp başka bir Mac’e taşınmış olan, çift tıklamayla açılmaz. macOS 15 ve üstünde macOS uygulamayı doğrulayamadığını söyler: Done’a tıklayın, ardından System Settings, Privacy & Security bölümünde aşağı inip Open Anyway’e tıklayın ve parolanızı girin. macOS 13 ve 14’te uygulamaya Control ile tıklayıp Open’ı seçin ve onaylayın. İkisi de yalnızca bir kez sorulur.
Android için adb gerekir ve uygulama onu içinde taşımaz: Google’ın koşulları buna izin vermez ve içinde LGPL kod vardır. Menü çubuğundaki Get adb for Android, Google’ın koşullarını kabul ettiğinizde Google’ın kendi platform-tools paketini (16 MB) indirir ve sabit bir hash ile doğrular. Android Studio ya da ANDROID_HOME size zaten adb sağlıyorsa uygulama onu kullanır ve bu öğe görünmez.
Menü çubuğunda, Put appdyno on the PATH /usr/local/bin/appdyno konumuna bir bağlantı koyarak appdyno komutunun her terminalde çalışmasını sağlar, macOS parolanızı sorabilir. Add to MCP Clients neyi değiştireceğini gösterir ve appdyno install ile aynı işi yapar. Uygulamayı taşırsanız istemcileriniz ve bağlantı bir sonraki açılışta onu izler.
Homebrew ile. Her sürüm bir cask dosyası taşır: appdyno.rb. Onu kendi tap’inize kopyalayın:
brew tap-new you/toolsmkdir -p "$(brew --repository you/tools)/Casks"cp appdyno.rb "$(brew --repository you/tools)/Casks/"brew install --cask you/tools/appdynonpm paketi
Section titled “npm paketi”Bir Mac ve Node 22 ya da üstü gerekir. node --version ile bakın; “command not found” derse nodejs.org adresinden LTS sürümünü kurun.
npm install -g appdyno # appdyno komutunu kurarappdyno doctor # nelerin kurulu olduğunu, neyin eksik olduğunu söylernpx -y appdyno install, önce hiçbir şey kurmadan appdyno’yu istemcilerinize ekler; ama o zaman her istemci her açılışta npm’e son sürümü sorar ve onu doğrulamadan alır: bkz. appdyno’yu güncel tutmak. appdyno’yu kaynak koddan derlemek için bkz. CONTRIBUTING.tr.md.
appdyno’yu güncel tutmak
Section titled “appdyno’yu güncel tutmak”Yeni bir sürüme appdyno update ile geçilir. Komut satırı ve MCP sunucusu kendiliğinden sürüm aramaz, çünkü arama bir ağ çağrısıdır ve appdyno telemetri içermez. Mac uygulaması arar, aşağıda anlatıldığı gibi.
appdyno update --check # kurulu sürüm, son sürüm, ne olacağı; hiçbir şeyi değiştirmezappdyno update # son sürümü doğrular, sonra ona geçerMac’inizde bir şey değişmeden önce doğrulama yapılır ve bunu atlayan bir seçenek yoktur. Tam sürüm geçici bir klasöre kurulur, betiklerinin hiçbiri çalıştırılmaz ve npm audit signatures onu orada denetler. npm’in, yalnızca bir bağımlılık için değil o sürümün kendisi için bir provenance attestation doğrulamış olması ve bu attestation’ın sürümün appdyno’nun kendi deposundan derlendiğini söylemesi gerekir. Aksi halde sürüm bir kod ve bir ipucuyla reddedilir, sizin sürümünüz yerinde kalır.
Bunun için npm 11.12 ya da üstü gerekir, appdyno’yu pnpm kurmuş olsa bile: eski sürümler hangi paketi doğruladığını söylemez. Node 22 daha eski bir npm ile gelir, bu yüzden önce npm install -g npm@latest çalıştırın.
Ardından appdyno’yu hangi araç kurduysa onunla yükseltir. Hangisi olduğunu, sürümü ve klasörüyle birlikte appdyno doctor gösterir.
| neyle kuruldu | appdyno update |
|---|---|
npm install -g, her prefix |
npm ile, o prefix içinde, az önce doğruladığı kopyadan yükseltir |
pnpm add -g |
pnpm ile, tam o sürüme yükseltir; pnpm onu yeniden indirir |
| Mac uygulaması | uygulamayı değiştirir: aşağıya bakın |
| başka bir paket yöneticisi | reddeder: o yöneticiyle yükseltin |
tek seferlik npx |
reddeder: aşağıya bakın |
| kaynak kod | reddeder: git pull, ardından pnpm install && pnpm build |
| başka bir şey | reddeder: kuran araçla yükseltin ya da npm install -g ile kurun |
Başarısız bir kurulum eski sürümü çalışır halde bırakır. update hiçbir zaman daha eski bir sürüme geçmez, npm registry’sindeki latest bir ön sürümü gösterse bile ön sürüme de geçmez.
Mac uygulaması kendini aynı güvenceyle günceller: menü çubuğundaki Check for Updates ya da appdyno update ile. Açıldığında ve açık kaldıkça günde bir kez yeni sürüm arar, daha yeni bir sürümü bir kez önerir: siz Install’a tıklamadan hiçbir şey kurulmaz, menüdeki Check for Updates Automatically de aramayı kapatır. Arama yalnızca birazdan anlatılan küçük, imzalı dosyayı okur ve sizden hiçbir şey göndermez. Her sürüm, appcast denen küçük bir dosya yayımlar. Bu dosya, açık yarısı uygulamanızda bulunan bir anahtarla imzalıdır ve uygulama başka hiçbir şeye inanmaz: dosyanın gösterdiği disk imajını indirir, hash’ini ve boyutunu denetler, uygulamanın yanına açar, kod imzasını, aynı imzacıdan gelen aynı program olduğunu ve imzalanan sürüm olduğunu denetler. İkisini ancak bundan sonra değiştirir. Bunlardan biri başarısız olursa uygulamanız olduğu gibi kalır, güncelleme anahtarı olmadan yapılmış bir build ise güncellemeyi hiç kabul etmez. Ardından uygulamayı yeniden açın.
npx -y appdyno mcp çalıştıran bir istemci. npx her açılışta npm registry’sine sorar ve yukarıdaki denetimlerin hiçbiri olmadan son sürüme kendiliğinden geçer. appdyno global olarak kuruluysa npx onun yerine o kurulumu çalıştırır. Bu yüzden bir kez npm install -g appdyno çalıştırın: istemcilerinizin çalıştırdığı sürüm artık yalnızca siz appdyno update çalıştırdığınızda değişir.
Güncellemeden sonra. Çalışan bir MCP sunucusu, istemcisi onu yeniden başlatana kadar eski kodla devam eder, bu yüzden istemciyi yeniden başlatın. Android ajanı ve iOS runner için bir şey gerekmez: ikisi de bir sonraki bağlantıda hash’lerine göre değişir. Yeni bir iOS runner içeren sürüm onu ilk kullanımda bir kez derler, bu birkaç dakika sürer.
Bu Mac’teki istemciler
Section titled “Bu Mac’teki istemciler”appdyno install, bu Mac’teki istemcileri bulur ve seçtiklerinize appdyno’yu ekler. Yalnızca o tek girdiyi değiştirir, dosyanın yanına yedek bırakır, --dry-run ile hiçbir şey yazmaz.
appdyno install --dry-run # neyi değiştireceğini gösterirappdyno install # hangilerine ekleneceğini sorar; --yes hepsini seçerArdından istemciyi yeniden başlatın: çoğu listeyi yalnızca açılışta okur. appdyno install --remove girdiyi kaldırır.
Bulunamayan bir istemci klasörünü henüz oluşturmamıştır: bir kez açın ya da girdiyi aşağıdaki gibi elle ekleyin. Hepsi aynı komutu çalıştırır:
{ "command": "npx", "args": ["-y", "appdyno", "mcp"] }Seçenekler args dizisinin sonuna eklenir. Örneğin "--device", "emulator-5554" ya da "--allow-apps", "com.example.app". Bkz. Sunucu seçenekleri.
Hub’dan
Section titled “Hub’dan”Hub’ın kenar çubuğundaki Telefon Bağla, telefonu USB hata ayıklama ya da Güven adımlarından tek tek, telefonun söylediğine göre geçirir. Yalnızca elinizdeki telefonun gerektirdiğini sorar, bitince Yapay Zekâ İstemcileri’ni önerir. Araçlar bu sunucuyu tek seferde tüm istemcilere ekler: Tüm Yapay Zekâ İstemcilerine Ekle önce satırları gösterir.
Hub’ın kenar çubuğundaki Yapay Zekâ İstemcileri, buradaki her istemciyi gerçek durumuyla listeler:
| ne der | anlamı |
|---|---|
| Bağlı, ne zaman olduğuyla | burada gerçekten bir araç çağırdı. Başka hiçbir durumda Bağlı yazmaz |
| Eklendi, yeniden başlatın | girdisi yerinde, henüz çağrı gelmedi |
| Eklenmedi | bu Mac’te var, appdyno’ya ait bir şey yok |
| Ayar dosyası düzenlenemiyor | install okuyamadığı dosyaya dokunmaz, nedenini söyler |
| Bu Mac’te kurulu değil | burada dosyası ya da klasörü yok ve Bu Mac’te Yok altında listelenir: bir kez açın |
| Tarayıcıda çalışır: burada eklenecek bir şey yok | bkz. Tarayıcıdaki istemciler |
Ekle ve Kaldır, appdyno install kodunu kullanır. Önce satırların tam hali görünür, ikinci tıklamaya kadar hiçbir şey yazılmaz. Yalnızca o girdi değişir, dosyanın yanında yedek kalır. Geri Al yalnızca o girdiyi, seçenekleriyle birlikte eski haline döndürür; yedeği geri yüklemez, çünkü istemci o arada dosyasını yazmış olabilir.
Test Et, istemcinin girdisinin çalıştırdığını çalıştırır, araç listesini ister, ne bulduğunu ve sırada ne yapılacağını söyler. Araç çağırmaz, bu yüzden cihaza dokunmaz ve istemciyi Bağlı durumuna da geçirmez. Dock’tan açılan istemci, Dock’un verdiği kısa PATH ile denenir.
Bunu nasıl bilir: sunucu her istemci için verdiği adı ve sürümü, stdio mu HTTP mi kullandığını ve son çağrısının zamanını ~/Library/Caches/appdyno/clients altında tutar; gönderdiği hiçbir şeyi tutmaz. Listede olmayan bir istemci de çağırdığında kendi satırını alır. Adlar, çağrı yapılabilen yerlerde istemcinin kendi çağrısından okundu: bkz. Neyle denendi. Bir istemciyi kaldırmak çağrılarını da unutturur.
İstemcinin verdiği ad, bir cihazı yönetirken durum kapsülünde de görünür.
Kenar çubuğundaki Yardım ya da command-?, en son önde olan cihaz ve uygulamayla doldurulmuş, hedefe göre istemler sunar; her biri cihaza ne yaptığını söyler.
Claude Code
Section titled “Claude Code”appdyno installçalıştırın ya da elle ekleyin:claude mcp add --scope user --transport stdio appdyno -- npx -y appdyno mcp- Kontrol:
claude mcp listçıktısındaappdyno: ... ✔ Connectedgörünmeli. Oturum içinde/mcpyazın. - Deneyin: “cihazları listele” deyin.
--scope user sunucuyu bütün projelerde kullanılır yapar. Bu seçenek olmadan sunucu yalnızca bulunduğunuz klasöre eklenir.
Claude Desktop
Section titled “Claude Desktop”Masaüstü uygulamasındaki sohbet içindir. Claude Code’un listesini okumaz, Claude Code da bunu okumaz.
-
appdyno installçalıştırın. Elle yapmak için: Settings, Developer, Edit Config,~/Library/Application Support/Claude/claude_desktop_config.jsondosyasını açar. Şunu ekleyip kaydedin:{"mcpServers": {"appdyno": { "command": "npx", "args": ["-y", "appdyno", "mcp"] }}} -
Uygulamadan tamamen çıkın (Cmd-Q) ve yeniden açın. Pencereyi kapatmak yetmez.
-
Kontrol: sohbet kutusunun altındaki +, sonra Connectors. appdyno araçlarıyla birlikte listelenir.
“spawn npx ENOENT” hatası alıyorsanız ya da sunucu bağlanmıyorsa ilk bakılacak yer burasıdır: bkz. Uygulama npx’i veya adb’yi bulamıyor. Burada bir çağrının süresi 3-4 dakika kadardır, bu yüzden iOS’ta ilk kullanımdan önce appdyno ios build çalıştırın.
Ya da tek bir dosyadan, bir masaüstü eklentisinden kurun. Her sürümde appdyno-<version>.mcpb bulunur; sunucuyu, ajanlarını ve bir simgeyi içerir, bu yüzden uygulama ile appdyno arasında npx yoktur.
- Dosyayı son sürümden indirip uygulamayla açın; uygulama bir kurulum penceresi gösterir.
- Formu doldurun ya da boş bırakın. 3 alanı vardır: sürebileceği cihazlar, dokunabileceği uygulamalar ve açabileceği bağlantılar. Bunlar Sunucu seçenekleri bölümündeki
--allow-devices,--allow-appsve--allow-urlsseçenekleridir; boş bir alan hiçbir şeyi sınırlamaz. - Yukarıdaki gibi kontrol edin: appdyno araçlarıyla birlikte listelenir.
Dosya imzalı değildir. Her kurulum gibi Node 22 ya da üstünü ister. Dosyayı ya da yukarıdaki girdiyi kullanın, ikisini birden değil, çünkü her biri kendi sunucusunu başlatır.
Dosya bir appdyno komutu ve düzenlenecek bir girdi getirmez. adb’yi önce ANDROID_HOME içinde, sonra Android Studio’nun SDK’sında, ~/Library/Android/sdk, sonra appdyno tools install adb ile indirilmiş olanda, sonra PATH üzerinde bulur. iOS’ta ilk kullanımdan önce npx -y appdyno ios build, ikisi aynı sürümse, yardımcıları onun için de derler: bir derleme onu yapan kopyaya göre değil, yapıldığı kaynaklara göre tutulur.
Codex ve ChatGPT masaüstü uygulaması
Section titled “Codex ve ChatGPT masaüstü uygulaması”Codex komut satırı, editör eklentisi ve ChatGPT masaüstü uygulaması tek dosyayı paylaşır: ~/.codex/config.toml. Yani tek girdi üçüne de ulaşır. appdyno Mac’inizde, yerel çalışan konuşmalarda çalışır.
-
appdyno installçalıştırın. ÇıktıdaCodex and ChatGPT desktopyazar. Elle yapmak için dosyaya şunu ekleyin:[mcp_servers.appdyno]command = "npx"args = ["-y", "appdyno", "mcp"]startup_timeout_sec = 120tool_timeout_sec = 1800Uygulamadan yapmak için: Settings, MCP servers, Add server, STDIO, sonra Restart. Ardından iki süreyi dosyaya ekleyin.
-
Kontrol:
codex mcp listçıktısındaenabledgörünür. Oturumda ya da uygulamanın yazma kutusunda/mcpyazarak nelerin bağlı olduğunu görün.
Bu iki süre önemlidir. Varsayılanları 10 ve 60 saniyedir, oysa ilk çalıştırma ya da ilk derleme dakikalar sürer: istemci her seferinde vazgeçip baştan başlar. appdyno install bu değerleri yazar, sizin elle verdiklerinize dokunmaz.
Cursor
Section titled “Cursor”appdyno installçalıştırın ya da girdiyi~/.cursor/mcp.jsondosyasındamcpServersaltına ekleyin.- Kontrol: Cursor’ın Output panelinde (Cmd-Shift-U) MCP Logs’u seçin.
VS Code
Section titled “VS Code”-
appdyno installçalıştırın. Elle yapmak için komut paletinden “MCP: Open User Configuration” açıp şunu ekleyin. Burada anahtarservers, ayrıcatypeda gerekir:{"servers": {"appdyno": { "type": "stdio", "command": "npx", "args": ["-y", "appdyno", "mcp"] }}} -
Sunucuya güvenip güvenmediğinizi soran uyarıyı onaylayın.
-
Kontrol: Chat: Open Customizations, sonra MCP Servers.
Devin Desktop (eski adıyla Windsurf)
Section titled “Devin Desktop (eski adıyla Windsurf)”appdyno installçalıştırın. ÇıktıdaWindsurfyazar.~/.config/devin/mcp_config.jsondosyasına, sizde eskisi varsa~/.codeium/windsurf/mcp_config.jsondosyasına yazar. AnahtarmcpServers.- Kontrol: Customize, MCPs, This computer.
Antigravity
Section titled “Antigravity”Antigravity, Haziran 2026’da Gemini CLI’ın yerini aldı.
appdyno installçalıştırın ya da girdiyi~/.gemini/config/mcp_config.jsondosyasındamcpServersaltına ekleyin.- Yeniden başlatın, sonra
/mcpile kontrol edin.
Gemini CLI
Section titled “Gemini CLI”appdyno installçalıştırın ya dagemini mcp add -s user appdyno npx -y appdyno mcpyazın. Girdi~/.gemini/settings.jsondosyasında tutulur.- Kontrol:
gemini mcp list. Güvenmediğiniz bir klasördeDisabledder: orada bir kezgeminibaşlatıp klasöre güvenin.
-
appdyno installçalıştırın ya dasettings.jsondosyasına şunu ekleyin:{"context_servers": {"appdyno": { "command": "npx", "args": ["-y", "appdyno", "mcp"], "env": {} }}} -
Kontrol: Settings, AI, MCP Servers. appdyno’nun yanındaki nokta yeşile döner.
opencode
Section titled “opencode”-
appdyno installçalıştırın ya da~/.config/opencode/opencode.jsondosyasına şunu ekleyin:{"mcp": {"appdyno": { "type": "local", "command": ["npx", "-y", "appdyno", "mcp"], "enabled": true }}} -
Kontrol:
opencode mcp listçıktısındaconnectedyazar.
- Komut satırı için
appdyno installçalıştırın,~/.cline/data/settings/cline_mcp_settings.jsondosyasına yazar. Editör eklentisinde: MCP Servers simgesi, Configure, Configure MCP Servers, sonra girdiyimcpServersaltına ekleyin. - Kontrol:
cline config mcp.
Başka bir istemci
Section titled “Başka bir istemci”Ayarlarında “MCP” kelimesini arayın. Bir komut istiyorsa yukarıdakini verin. Çoğu şu biçimi kabul eder, birkaçı mcpServers yerine başka bir kelime kullanır:
{ "mcpServers": { "appdyno": { "command": "npx", "args": ["-y", "appdyno", "mcp"] } }}Tarayıcıdaki istemciler
Section titled “Tarayıcıdaki istemciler”Bunlar üreticisinin bulutunda çalışır. Mac’inizde bir program başlatamaz, 127.0.0.1 adresini de göremezler. appdyno’ya ulaşmaları için bir giriş kapısı gerekir ve appdyno bunu kendiliğinden açmaz: arada bize ait bir servis yoktur, tüneli siz çalıştırır, siz kapatırsınız.
Önce bunu okuyun. Adresi ve token’ı bilen herkes cihazlarınızı kullanabilir. Yalnızca tek bir uygulamayı değil: ekranda görünen her şeyi okuyabilir, yazı yazabilir, uygulama kurup kaldırabilir, bağlantı açabilir, ayarları değiştirebilir ve bir aracın yol aldığı yerlerde bu Mac’te dosya okuyup yazabilir (record, report, visual, flow, app install). Araçların döndürdüğünü istemcinin üreticisi de görür, yani ekranı gördüğünü varsayın.
Tünel açmadan önce:
- Test cihazı ve test hesapları kullanın, cihazda gerçek bir veri olmasın.
- Sunucuyu sınırlayın:
--allow-devices,--allow-apps,--allow-urls. - İşiniz bitince tüneli kapatın.
- Adres ya da token dışarı sızdıysa sunucuyu durdurun ve yeni bir token ile başlatın.
HTTP sunucusu
Section titled “HTTP sunucusu”Hub bunların hepsini Yapay Zekâ İstemcileri’nde, Tarayıcıda bölümünde yapar. Sunucuyu Başlat aynı komutu kendi sürecinde, 8765 numaralı porttan ya da sonraki boş porttan çalıştırır ve adresi söyler. Token siz istemedikçe gizli kalır, sunucuya ortam değişkeniyle gider ve durum klasöründe 0600 izniyle saklanır, böylece kayıtlı bir bağlayıcı çalışmaya devam eder. Yeni Token, dışarı sızan token’ın yerine yenisini koyar. Sunucu, hub nasıl kapanırsa kapansın onunla birlikte kapanır.
Elle, appdyno mcp --http aynı araçları MCP’nin Streamable HTTP taşıması üzerinden sunar. Siz istemedikçe kapalıdır ve yalnızca bu Mac’te dinler:
export APPDYNO_HTTP_TOKEN=$(openssl rand -hex 32)appdyno mcp --http 127.0.0.1:8765 --allow-devices '^EXAMPLE0SERIAL$'Adresi ve neyin gönderileceğini yazdırır. APPDYNO_HTTP_TOKEN yoksa kendisi üretip yazdırır, bir sonraki başlatmada başkasını üretir ve kayıtlı bağlayıcı artık eşleşmez. Kendi token’ınızı parola yöneticisinde saklayın. Token için bir seçenek yok, çünkü komut satırı seçeneği ps çıktısında görünürdü.
Token iki yolla gönderilebilir, istemci hangisini kullanabiliyorsa onu kullanır:
- başlık olarak:
http://127.0.0.1:8765/mcpadresineAuthorization: Bearer <token> - adresin içinde:
http://127.0.0.1:8765/mcp/<token>, başlık için alanı olmayan istemciler için
Token’ın adreste durması daha zayıftır: tünelin kayıtlarına ve istemcinin kayıtlı ayarlarına geçer. ChatGPT ve Claude hesaplarının çoğu başka yol bırakmıyor.
Tünelden önce bir kontrol:
curl -i -X POST http://127.0.0.1:8765/mcp # 401: sunucu orada ve token istiyornpx @modelcontextprotocol/inspector --cli "http://127.0.0.1:8765/mcp/$APPDYNO_HTTP_TOKEN" \ --transport http --method tools/list # araçları listelerSonra http://127.0.0.1:8765 adresine seçtiğiniz bir tünel açın ve size verdiği HTTPS adresini kullanın. Tünel, akış halindeki bir yanıtı geldikçe iletmelidir: bazı hızlı, adsız tüneller onu sonuna kadar tutar; adlandırılmış bir tünel kullanın.
Aynı anda tek istemci. Bir istemci araç çağırdığı andan itibaren sunucuyu tutar, son çağrısından 10 dakika sonrasına kadar. Başka bir istemci, önce bağlanmış olsa bile çağrısında, sunucuyu tutanın adını söyleyen 409 ile reddedilir. Yalnızca araçları listelemiş bir istemci hiçbir şey tutmaz, yani sağlık kontrolü kimseyi engellemez. 10 dakika dolunca ya da sunucuyu durdurunca, cihazda değiştirdiği her şey eski haline döner; bu Mac’teki bir istemci kapandığında olduğu gibi. Bağlam istemci başına değil, tektir: aynı istemcinin ikinci penceresi onu paylaşır. İki istemciyle iki cihaz kullanmak için iki portta iki sunucu çalıştırın.
Bir çağrı sürerken bağlantı koparsa, çağrı cihazda da durur.
Tarayıcıda ChatGPT
Section titled “Tarayıcıda ChatGPT”Tarayıcıdaki ChatGPT yalnızca uzak sunuculara ulaşır. Plugins altından bağlanır ve token gönderemez: formu OAuth, No authentication ya da ikisini birden sunar.
| plan | ne elde edersiniz |
|---|---|
| Business | her şey. Sunucuyu yalnızca yönetici ya da sahip ekleyebilir |
| Enterprise, Edu | her şey. Kimin ekleyebileceğine yönetici karar verir |
| Pro | yalnızca salt okunur işaretli araçlar: screen, find, screenshot, wait_for, assert, logs, crashes, audit, device_info, list_devices, visual ve okuma yapan perf_ araçları. tap yok, yazı yazma yok, use_device de yok: sunucuyu --device ile ya da tek cihaza izin vererek başlatın |
| Plus, Free | OpenAI’ın sayfaları bir şey söylemiyor. Yokmuş gibi düşünün ve masaüstü uygulamasını kullanın |
Masaüstü uygulamasında bunların hiçbiri yoktur: appdyno’yu Mac’inizde çalıştırır. Mümkünse onu kullanın.
Önerdiğimiz yol: OpenAI’ın Secure MCP Tunnel’ı. Port açmaz, herkese açık bir adres istemez ve appdyno’yu stdio üzerinden taşır, yani HTTP sunucusu devreye girmez. Bir OpenAI Platform organizasyonu gerekir, kişisel ya da şirketin olabilir.
-
Platform tünel ayarlarında bir tünel oluşturun,
tunnel_iddeğerini not edin. Bir runtime API anahtarı oluşturun. Tüneli ChatGPT çalışma alanınıza bağlayın, yoksa orada görünmez. -
Mac’inizde:
Terminal window brew install openai/tools/tunnel-clientexport CONTROL_PLANE_API_KEY="sk-..."tunnel-client init --sample sample_mcp_stdio_local --profile local-stdio \--tunnel-id tunnel_0123456789abcdef0123456789abcdef \--mcp-command "npx -y appdyno mcp --allow-devices '^EXAMPLE0SERIAL$'"tunnel-client doctor --profile local-stdio --explaintunnel-client run --profile local-stdio -
Çalışır halde bırakın. ChatGPT Plugins sayfasında: + düğmesi, Add custom MCP server, bir ad, Connection: Tunnel, tüneliniz, Authentication: No authentication. Uyarıyı kabul edin, sonra Create as a plugin.
-
Eklentiyi kurun. Yeni bir konuşmada
@yazın, appdyno’yu seçin ve cihazları listelemesini isteyin.
Her isteğin 120 saniyesi vardır, ne kadar ilerleme bildirirse bildirsin, boyut sınırı da 10 MiB’dir. Uzun ölçümler ve ilk derleme buna sığmaz: önce appdyno ios build çalıştırın.
Kendi tünelinizle. HTTP sunucusunu ve bir tüneli başlatın, sonra özel sunucuyu Server URL olarak https://<your tunnel>/mcp/<token> ve No authentication ile ekleyin. Bu adrese sahip olan herkes içeridedir, onu parola gibi saklayın.
ChatGPT her yazma işleminde varsayılan olarak onay ister. Bir telefonun araçları için bunu değiştirmek sizin kararınızdır. Bir kullanıcı bildirimine göre bir aracın görselini boş gösteriyor: screenshot boş dönerse screen kullanın.
Tarayıcıda Claude
Section titled “Tarayıcıda Claude”Bu bölüm Claude’un web, telefon ve Cowork sürümlerini ve masaüstü uygulamasındaki bağlayıcıları kapsar. Özel bağlayıcılar her planda vardır (Free’de bir tane), ancak Claude cihazınızdan değil kendi bulutundan bağlanır. Yani sunucunun internetten erişilebilir olması gerekir, bunu da sizin tüneliniz sağlar. claude_desktop_config.json gibi yerel dosyalar burada geçmez. Masaüstü uygulaması appdyno’yu Mac’inizde tünelsiz çalıştırır: mümkünse onu kullanın.
- HTTP sunucusunu ve bir tüneli başlatın.
- Customize, Connectors, +, Add custom connector.
- Bir ad ve
https://<your tunnel>/mcp/<token>adresini girin. - Authentication: No sign-in. Ekleyin.
- Sohbette: +, Connectors, açın ve cihazları listelemesini isteyin.
Team ve Enterprise’da bağlayıcıyı bir Owner, Organization settings, Connectors altından ekler.
Claude’un sayfaları bir konuda çelişiyor. Yardım makalesi sabit token için bir Request headers alanı gösteriyor, geliştirici sayfaları ise bu alanın yalnızca sınırlı sayıda kuruluşa açık bir beta olduğunu söylüyor. Bu alanı görüyorsanız düz https://<your tunnel>/mcp adresini ve Authorization: Bearer <token> başlığını kullanın, böylece token adreste durmaz.
Bir araç çağrısının yaklaşık 240 saniyesi, bir yanıtın yaklaşık 150.000 karakteri vardır. Claude’un kendi MCP tünelleri, sunucuda OAuth isteyen bir Enterprise önizlemesidir, dolayısıyla appdyno için bir yol değildir.
Android telefon veya emülatör
Section titled “Android telefon veya emülatör”Android cihazlarla konuşan adb aracı gerekir.
- Kurun. Ya Android Studio, appdyno’nun baktığı yere kurar, ya da Google’ın platform-tools paketini
appdyno tools install adb --accept-licenseile kurun; bu seçenek Google’ın koşullarını kabul ettiğinizi söyler. - Telefonda geliştirici seçeneklerini açın: Ayarlar, Telefon hakkında, Derleme numarasına (bazı telefonlarda Yapım numarası) yedi kez dokunun. Xiaomi’de bu OS sürümüdür.
- Ayarlar, Geliştirici seçenekleri altında USB hata ayıklamayı açın. Xiaomi’de USB ile yükle ve USB hata ayıklama (Güvenlik ayarları) da açılmalı.
- Kabloyu takın. Telefonun kilidini açın, sorduğu soruya İzin ver deyin.
- Kontrol:
appdyno devicestelefonudeviceolarak listeler.unauthorized, sorunun yanıtlanmadığı anlamına gelir: telefona bakın. Liste boşsa kablo büyük olasılıkla yalnızca şarj kablosudur. - Bir kontrol daha:
appdyno doctor --serial <serial>.
Telefon yok mu? Android Studio’nun Device Manager’ında sanal bir cihaz oluşturup başlatın. appdyno devices onu emulator-5554 olarak listeler.
appdyno ilk kullanımda cihaza kendi ajanını kurar. Xiaomi her yeni kurulumda ekranda sorar, appdyno da yalnızca kendi başlattığı kurulumda bu tek soruyu yanıtlar. Bkz. Bir telefona ulaşmak.
iPhone veya simülatör
Section titled “iPhone veya simülatör”App Store’dan Xcode kurun, bir kez açıp sorduklarını onaylayın. Bulunduğunu görmek için appdyno doctor çalıştırın.
Simülatör için başka bir şey gerekmez: ne hesap ne imzalama. Xcode’un Simulator uygulamasıyla açın ya da istemcinizden başlatmasını isteyin. appdyno’nun yardımcısını gerektiren ilk işlem onu derler, bu birkaç dakika sürer. Bunu önceden yapmak için:
appdyno ios buildiPhone biraz daha fazlasını ister, çünkü telefon yalnızca o telefon için imzalanmış kodu çalıştırır.
- Kabloyla bağlayın, kilidi açın, sorduğu soruya Güven deyin.
- Xcode’da: Settings, Accounts, +, Apple kimliğinizle giriş yapın.
- Telefonda: Ayarlar, Gizlilik ve Güvenlik, Geliştirici Modu, açın. Telefon yeniden başlar ve onay ister. Bu anahtar, telefon Xcode’a bir kez bağlandıktan sonra görünür.
- Telefonun kimliğini bulun:
xcrun devicectl list devicesya da Xcode’da Window, Devices and Simulators. - Aşağıdaki yollardan biriyle imzalayın.
- Kontrol:
appdyno doctortelefonu uyarısız listeler.no signing for the iPhone runnerderse okumaya devam edin. appdyno ios buildçalıştırın, sonra istemcinizden ekranı okumasını isteyin. İlk seferde telefonun kilidi açık kalsın. Geliştiriciye güvenilmediğini söylerse: Ayarlar, Genel, VPN ve Aygıt Yönetimi, güvenin.
İmzalama ne demek
Section titled “İmzalama ne demek”appdyno telefona küçük bir test uygulaması, yani runner yükler. iOS onu ancak Apple’dan gelen iki şeyle çalıştırır:
- kimlik: geliştirme sertifikanız ve giriş anahtarlığındaki özel anahtarı
- provisioning profile: kimliği, bu telefonu ve uygulama kimliğini adıyla yazan bir dosya
Bunlar kuruluysa appdyno kendisi bulur. Hesabınızda hiçbir şey oluşturmaz; tek istisna, aşağıdaki ikinci yolda bunu sizin istemenizdir.
Ücretli Apple Developer hesabıyla, wildcard profil
Section titled “Ücretli Apple Developer hesabıyla, wildcard profil”Kendiliğinden bulunan yol budur ve başka bir şey gerektirmez.
- Xcode, Settings, Accounts, ekibiniz, Manage Certificates, +, Apple Development.
- developer.apple.com adresinde Devices altına telefonun kimliğini ekleyin.
- Identifiers altına Wildcard türünde,
*değerli bir App ID ekleyin. - Profiles altına iOS App Development ekleyin, wildcard kimliği, sertifikanızı ve telefonu seçin. İndirip çift tıklayın.
- Kontrol:
appdyno doctor.
Xcode halletsin
Section titled “Xcode halletsin”appdyno’ya ekibinizin kimliğini verin, runner’ı hazırlaması için Xcode’dan bir kez istesin:
export APPDYNO_IOS_TEAM=ABCDE12345Kimlik 10 karakterdir, Apple Developer hesabınızda Membership altındadır. appdyno’yu başlatan istemci, kabuğunuzun değişkenlerini görmez: bunu girdinin env alanına ekleyin.
Ücretsiz Apple kimliği wildcard profil oluşturamaz, yani çalışabilecek tek yol budur ve profili bir yıl değil birkaç gün yaşar. Bu denenmedi.
Profili kendiniz belirtmek
Section titled “Profili kendiniz belirtmek”Derleme makinesi ya da birden çok profil olan bir Mac için:
export APPDYNO_IOS_PROFILE=/path/to/runner.mobileprovisionexport APPDYNO_IOS_KEYCHAIN=/path/to/build.keychain-dbexport APPDYNO_IOS_KEYCHAIN_PASSWORD=...Çalışmıyorsa
Section titled “Çalışmıyorsa”Uygulama npx’i veya adb’yi bulamıyor
Section titled “Uygulama npx’i veya adb’yi bulamıyor”Dock’tan açılan bir uygulama kabuğunuzun ayarlarını okumaz. Kısa bir PATH ile çalışır; bir paket yöneticisinin ya da sürüm yöneticisinin kurduğu Node ve adb burada bulunmaz. Sonuç: spawn npx ENOENT, bağlanmayan bir sunucu ya da adb: not found.
Terminalde nerede olduklarına bakın:
command -v npx node adbSonra girdiye npx için tam yolu ve node ile adb’yi de içeren bir PATH yazın. Yalnızca tam yol yetmez, çünkü npx’in kendisi de node’u bulmak zorundadır:
{ "mcpServers": { "appdyno": { "command": "/usr/local/bin/npx", "args": ["-y", "appdyno", "mcp"], "env": { "PATH": "/usr/local/bin:/usr/bin:/bin" } } }}ANDROID_HOME, APPDYNO_IOS_TEAM ve diğerleri de aynı şekilde env altına yazılır. Sonra uygulamayı tamamen yeniden başlatın. appdyno install bu eklemelere dokunmaz.
Diğer durumlar
Section titled “Diğer durumlar”| gördüğünüz | anlamı ve yapılacak |
|---|---|
| istemci araç göstermiyor, hata da vermiyor | yeniden başlatın, çoğu listeyi bir kez okur. Sonra kayıtlarına bakın ve appdyno doctor çalıştırın |
no connected device this server may drive |
appdyno devices hiçbir cihaz listelemiyor ya da --allow-devices onu dışarıda bırakıyor |
more than one device this server may drive |
istemcinize hangi cihazı kullanacağını söyleyin ya da girdiye --device ekleyin |
is held by pid ... |
o cihazı başka bir program kullanıyor. Durdurun ya da --share kullanın |
no signing for the iPhone runner |
bkz. iPhone veya simülatör |
DEVICE_LOCKED |
telefonun kilidini açın |
| iOS’ta ilk çağrı hata veriyor ya da zaman aşımına uğruyor | runner hâlâ derleniyor, istemci vazgeçti: appdyno ios build çalıştırıp yeniden deneyin |
| Codex’te çağrı 60 saniyede kesiliyor | girdiye tool_timeout_sec ekleyin |
| ChatGPT’de çağrı 120 saniyede kesiliyor | Secure MCP Tunnel’ın sınırı, artırılamaz: daha kısa bir işlem seçin ya da masaüstü uygulamasını kullanın |
| Claude’da çağrı 4 dakika civarında kesiliyor | barındırılan sürümün sınırı. Daha kısa bir işlem seçin ya da Claude Code kullanın |
HTTP sunucusunda 401 |
token yok ya da yanlış. Token gönderemeyen istemcide token adreste olmalı |
403 requests from ... are not accepted |
bir web sayfası ya da bu sunucuya ait olmayan Origin başlığı gönderen bir istemci. Değeri sunucunun kaydında yazar |
409 this server serves one client at a time |
iletide adı geçen başka bir istemci tutuyor. Son çağrısından 10 dakika bekleyin ya da sunucuyu yeniden başlatın |
address already in use |
port dolu: başka bir port seçin |
| bağlayıcı eklenmiyor ya da araç görmüyor | curl -i -X POST https://<your tunnel>/mcp 401 vermeli. Başka bir yanıt, tünelin sunucuya ulaşmadığını gösterir |
| bağlayıcı çalışıyordu, artık çalışmıyor | sunucu üretilmiş bir token ile yeniden başladı ya da tünelin adresi değişti. APPDYNO_HTTP_TOKEN saklayın, adlandırılmış tünel kullanın |
Neyle denendi
Section titled “Neyle denendi”macOS’ta, geçici bir ev klasörüyle, paketinden derlenip kurulan sürümle, bütün cihazlar --allow-devices ile dışarıda bırakılarak, 2026-11-04’te:
| denenen | sonuç |
|---|---|
listedeki her istemci için appdyno install |
her dosya yazıldı; ikinci kez: hepsi “already right” |
| Claude Code 2.1.318, stdio ve HTTP | bağlandı; yanlış token ve ikinci istemci reddedildi |
| Gemini CLI 0.66.0, opencode 1.19.5 | kendi mcp list komutlarıyla bağlandı |
| Codex CLI 0.166.0, Cline CLI 3.0.74 | dosyasını okuyup appdyno’yu listeledi; bağlantı kurulmadı |
| MCP Inspector komut satırı, token adreste | araçları listeledi, birini çağırdı |
Yapay Zekâ İstemcileri’nin bir istemcinin çağırdığını bilmesini sağlayan clientInfo adı, Claude Code 2.1.318 için istemcinin kendi çağrısından okundu: claude-code. Diğer istemciler için packages/cli/src/clients.ts içindeki kalıp, gönderdiği bilinen addan gelir ve burada görülmedi. Biri yanlışsa o istemci verdiği adla kendi satırında görünür, başkasının yerine asla Bağlı denmez.
Claude Code 2.1.319 bir aracın yapılandırılmış yanıtını görselleriyle birlikte bütünüyle, bir reddi de kodu ve ipucuyla gösterir. Bu, 2026-11-08 ve 2026-11-09’da arayüzsüz akışından (claude -p), iOS 27.2’li bir iPhone 17 Pro simülatöründe ve bir API 34 emülatöründe okundu.
Hesap, lisans ya da pencere gerektirdiği için denenmeyenler: ChatGPT uygulaması ve web sürümü, Claude Desktop ve web’deki Claude, Secure MCP Tunnel, herkese açık herhangi bir tünel, Codex’ten bağlantı, Cursor, VS Code, Devin Desktop, Antigravity ve Zed. Buradaki adımlar kendi belgelerinden alındı. scripts/check-mcpb.mjs masaüstü eklentisini açar ve sunucusunu manifest dosyasının dediği gibi stdio üzerinden, form boşken ve doluyken çalıştırır; dosyayı uygulamada açmak, formu ve uygulamadan ilk çağrı denenmedi. Ücretsiz Apple kimliğiyle imzalama da denenmedi.
Bu site ziyaretleri çerez kullanmadan Cloudflare Web Analytics ile sayar.