MCP Entegrasyonu
OpenFactory, Model Context Protokolünü desteklediğinden yapay zeka asistanları yapılar oluşturmanıza, tarifleri incelemenize, VM’leri yönetmenize ve test sonuçlarını incelemenize yardımcı olabilir.
Claude, Cursor, Claude Code, OpenAI Codex veya başka bir MCP uyumlu istemciden OpenFactory ile araçlar arasında geçiş yapmadan çalışmak istediğinizde MCP’yi kullanın.
Gereksinimler
- Uzak MCP sunucularını destekleyen bir MCP istemcisi
- Hesap destekli erişim için bu tarayıcıda OpenFactory’de oturum açın
- Konuk erişimi için aşağıda gösterilen oluşturulan konuk jetonunu kullanın
Hesap API anahtarları oluşturulduğunda bir kez gösterilir ve konsoldan iptal edilebilir. Konuk belirteçleri, ölçülü erişime yönelik tarayıcı tanımlayıcılarıdır; bunlar hesap sırları değildir.
Uç noktalar
| Taşıma | URL’si | Kullan |
|---|---|---|
| Akış yapılabilir HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP uç noktası |
Akış yapılabilir HTTP, desteklenen tek aktarımdır. Eski HTTP+SSE uç noktaları (/mcp/sse, /mcp/messages) kullanımdan kaldırıldı ve artık 410 Gone değerini döndürüyor; hala bunları kullanan herhangi bir istemciyi aynı Authorization başlığıyla yukarıdaki Akışlı HTTP URL’sine yönlendirin. Claude Code, Claude Desktop, Cursor, Codex ve OpenCode’un tümü Akışlı HTTP’yi destekler.
Yapılandırmayı Kopyala-Yapıştır
MCP ayarlarını değiştirdikten sonra Claude Desktop’ı, Cursor’u, OpenAI Codex’i veya uzun süre çalışan herhangi bir MCP istemcisini yeniden başlatın. OpenAI Codex, MCP sunucularını ~/.codex/config.toml’den okur ve Streamable HTTP’ye doğrudan bağlanır: mcp-remote köprüsüne gerek yoktur. Claude.ai özel bağlayıcıları, sunucu URL’sini ve başlığını ayrı alanlar olarak isteyebilir.
Mevcut Yetenekler
OpenFactory, aşağıdakiler için müşteriye yönelik araçları kullanıma sunar:
| Kategori | Örnekler |
|---|---|
| Yapılar | Yapıları listeleyin, tariflerden yapı oluşturun, yapı durumunu kontrol edin, başarısız olan yapıları yeniden deneyin |
| Tarifler | Şablonlara göz atın, tarifleri doğrulayın, şablonları özelleştirin |
| Resimler | Tamamlanan eserler için indirme bağlantılarını alın |
| VM’ler | VM’leri listeleyin, test VM’leri oluşturun, VM’leri başlatın veya durdurun, konsol bağlantılarını açın |
| Testler | Doğrulamayı çalıştırın, test çalıştırmalarını listeleyin, test sonuçlarını inceleyin, yeniden kullanılabilir test paketlerini yönetin |
| Uygulama kullanıcı arayüzü testi | any app URL: yeniden kullanılabilir, kendi kendini güçlendiren GUI senaryolarını test etmek için bir test VM’si kullanın. Dağıtıma gerek yok |
| Uygulama dağıtımı | Genel önizleme URL’si ile canlı bir web uygulamasına Git deposu dağıtın (https://<slug>.apps.openfactory.tech) |
Aracın kullanılabilirliği plan ve organizasyon izinlerine göre değişebilir.
Yeniden Kullanılabilir Test Paketleri
Test paketleri, bir değişken veya ISO oluşturulmadan önce oluşturulabilir. Birini tanımlayın
veya daha fazla test senaryosu, özel iddialar, önceden tanımlanmış testler ve adlandırılmış ISO hedefi
primary, client veya server gibi yuvalar. Yapılar hazır olduğunda her birini bağlayın
Tamamlanmış bir yapıya yuva açın ve paketi çalıştırın.
| Araç | Kullan |
|---|---|
create_test_suite | Yerleşik bir varyant gerektirmeden yeniden kullanılabilir bir paket oluşturun |
list_test_suites | Mevcut MCP kullanıcısının kullanabileceği paketleri listeleyin |
get_test_suite | Paket tanımını ve yakın çalışma geçmişini görüntüleyin |
update_test_suite_targets | Adlandırılmış ISO hedef yuvalarını tamamlanmış derlemelere bağlayın |
run_test_suite | Bağlı ISO hedef yuvalarına karşı bir paket çalıştırın |
list_test_suite_runs | Bir paketten oluşturulan liste çalıştırmaları |
get_test_suite_status | Yazmaya hazır olma durumunu ve en son çalıştırma durumunu görüntüleyin |
Uygulama Kullanıcı Arayüzü Testi: herhangi bir URL, dağıtım yok
Yönetilen test cihazı VM’sini bir noktaya işaret ederek user interface of any web app’i test edin.
URL’si. Uygulamanızı test etmek için OpenFactory ile dağıtmazsınız. Test cihazı VM’si
Vercel, AWS’de yerel bir geliştirme sunucusu ve bir önizleme/üretim dağıtımı açar
Netlify veya herhangi bir ana bilgisayar veya VM’den erişilebilen herhangi bir genel URL. Uygulamanız kalır
zaten çalıştığı yer.
Senaryolar sade bir dille yazılmıştır ve self-hardening: ilk çalıştırmadır
her bir kullanıcı arayüzü öğesinin nerede olduğunu öğrenir ve daha sonra bu bellekten tekrar oynatmayı çalıştırır (atlama
yavaş görsel geçiş). Bu, tekrar oynatmaları hızlı ve küçük kullanıcı arayüzü değişikliklerine karşı dayanıklı hale getirir. Senaryo desteği
için environment variables (${VAR}) ve 2FA (${totp:VAR}, RFC 6238)
oturum açma işlemleri; sırlar çalışma zamanında iletilir ve asla saklanmaz.
| Araç | Kullan |
|---|---|
ensure_tester_vm | Kalıcı masaüstü test aracı sanal makinenizi edinin veya oluşturun |
create_app_scenario | Bir uygulama URL’si için yeniden kullanılabilir bir GUI senaryosu kaydedin |
run_app_scenario | Çalıştırın (çalışma zamanı sırlarını buraya iletin) ve ekran görüntülerini + kararı kaydedin |
list_app_scenarios / get_app_scenario | Senaryolara ve bunların güçlendirilmiş önbelleklerine göz atın |
start_app_test / record_app_test_step / finish_app_test | Geçici bir koşuyu kendiniz sürün ve kaydedin |
annotate_screenshot | Ekran görüntüsüne etiketli vurgu kutuları çizin |
İş akışının tamamı için Uygulama Kullanıcı Arayüzü Testi’e bakın. şema ve 2FA örnekleri.
Uygulama Dağıtımı: Genel bir URL’ye Git deposu
Bir web uygulamasını doğrudan Git deposundan dağıtın ve public preview URL alın
(https://<slug>.apps.openfactory.tech) bir testi açabilir, paylaşabilir veya yönlendirebilirsiniz
senaryosu. OpenFactory repoyu klonlar, bağımlılıkları yükler, uygulamayı başlatır,
ve sizin için sağlık kontrollerini yapar. Bağlanacak hiçbir şey yok: bağlantı noktası yönlendirme yok,
tüneller veya DNS.
Bu, Uygulama Kullanıcı Arayüzü testiyle eşleşir: uygulamanızı dağıtın, ardından uygulamanıza karşı bir senaryo çalıştırın. URL’yi önizleyin veya dağıtımı atlayın ve halihazırda barındırdığınız bir uygulamayı (Vercel, AWS,…) test edin.
| Araç | Kullan |
|---|---|
create_app | Git deposunu uygulama olarak kaydedin (ad, kaynak, bilgi) |
deploy_app | Uygulamayı dağıtın ve genel önizleme URL’sini döndürün |
list_apps / get_app | Uygulamalarınıza, URL’lerine ve dağıtım geçmişine göz atın |
iterate_app | Bir uygulamaya doğal dil değişikliği gönderin; bir temsilci bunu uygular ve yeniden konuşlandırır |
get_app_build_status | Bir uygulamanın dağıtım durumunu ve uçuş sırasında değişiklik biletlerini yoklayın |
İş akışının tamamı için Uygulama Dağıtımı’e bakın. izin vermek için kendi kullanıcıları uygulamanızda yapılan değişiklikleri bir mikrofon düğmesinden konuşabilir; bkz. Ses Yineleme Widget’ı.
Örnek İstemler
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.Güvenlik Notları
- API anahtarlarını yalnızca güvendiğiniz müşterilerle kullanın.
- Makineleri döndürdüğünüzde veya bir projeden ayrıldığınızda konsoldaki eski anahtarları iptal edin.
- Derlemeler oluşturan, VM’leri başlatan veya altyapıyı değiştiren eylemler için onay gerektiren araç izinlerini tercih edin.
- OpenFactory API anahtarlarını istemlere, destek taleplerine, genel depolara veya paylaşılan belgelere yapıştırmayın.
Sorun Giderme
Araçlar Görünmüyor
MCP istemcinizi yeniden başlatın ve sunucu URL’sinin tam olarak şu şekilde olduğunu doğrulayın:
https://console.openfactory.tech/mcp-stream/mcpİstemciniz kullanımdan kaldırılan /mcp/sse URL ile yapılandırılmışsa, bir
410 Gone: URL’yi yukarıdakiyle değiştirin; başka hiçbir şeyin değişmesine gerek yok.
Kimlik Doğrulama Başarısız
Bu sayfayı yenileyin ve oluşturulan konfigürasyonu tekrar kopyalayın. Oturum açan kullanıcılar oluşturulan Authorization başlığını kullanmalıdır. Konuk kullanıcılar yukarıdaki kopyala-yapıştır yapılandırmasında oluşturulan X-Guest-Id başlığını kullanmalıdır.
Derleme veya VM Eylemleri Başarısız
OpenFactory planınızı, organizasyon izinlerinizi ve derleme durumunu kontrol edin. Bazı eylemler tamamlanmış bir derlemeyi, kalıcı bir VM yetkisini veya Kurumsal izinleri gerektirir.
Aktarım Hataları
Akışlı HTTP’yi desteklemiyorsa MCP istemcinizi güncelleyin. Güncelleyemiyorsanız HTTP+SSE uyumluluğu uç noktasına geçin.