Yapay zekâ aracısı bağlama

Reconstruct, yakalanmış arayüz verilerini MCP sunucusu üzerinden sunar. Kurulum talimatları için aracınızı seçin:

• Codex
• Claude
• Cursor
• Cline
• VS Code'da GitHub Copilot
• Gemini CLI
• MiMo
• Muse Code
• Grok Build
• Hermes Agent
• OpenClaw
• OpenMausBot
• Diğer MCP istemcileri

Başlamadan önce

Reconstruct MCP uç noktası https://reconstruct.dev/mcp adresidir ve Streamable HTTP kullanır. OAuth üzerinden tarayıcı girişiyle veya kişisel erişim belirteciyle bağlanabilirsiniz.

Yöntem	Nasıl çalışır	Ne zaman kullanılır
Tarayıcı üzerinden OAuth girişi	MCP istemciniz tarayıcıda Reconstruct girişini açar. Giriş yapıp erişimi onaylayın, ardından istemciye dönün. Platform'da belirteç oluşturmanız veya oradan kopyalamanız gerekmez.	OAuth destekli etkileşimli aracılar ve düzenleyiciler.
Kişisel erişim belirteci	Platform ayarlarında MCP belirteci oluşturup istemcinin kimlik bilgilerine ekleyin.	OAuth desteklemeyen istemciler veya tarayıcı girişi olmayan otomatik ortamlar.

İki yöntem de aynı MCP sunucusuna bağlanır ve Reconstruct hesabınızın aboneliğini ve kullanım kotasını kullanır.

Tarayıcı üzerinden OAuth girişi

OAuth ile bağlanmadan önce Platform'da kişisel belirteç çıkarmanız gerekmez.

1. İstemcinize uzak HTTP MCP sunucusu olarak https://reconstruct.dev/mcp ekleyin.
2. OAuth veya tarayıcıdan giriş seçin. İstemci bağlantı ayarlarını sorarsa aşağıdaki değerleri kullanın.
3. Sign in, Connect veya istemcinin MCP giriş komutunu başlatın. Tam işlem istemcinize bağlıdır.
4. Tarayıcıda Reconstruct hesabınıza giriş yapıp istenen erişimi onaylayın. Kayıt kullanılamıyorsa hesap erişimi için desteğe başvurun.
5. İstemciye dönüp araçlarını yenileyin. Bağlantıyı doğrulamak için list_products çağırmasını isteyin.

Ayar	Değer
Sunucu URL'si	https://reconstruct.dev/mcp
Aktarım	Streamable HTTP
OAuth istemci kimliği	Önceden yapılandırılmış istemciler için reconstruct-mcp; Claude Desktop otomatik kaydolur
Kapsamlar	openid aud-mcp
İstemci sırrı	Boş bırakın
OAuth issuer	https://reconstruct.dev/sso/realms/reconstruct
Yetkilendirme uç noktası	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth
Belirteç uç noktası	https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token

İstemci girişten sonra OAuth kimlik bilgilerini alıp saklar ve MCP çağrılarında kullanır. Bu yöntemde belirteç kopyalamanız veya CR_RECONSTRUCT_MCP_TOKEN ayarlamanız gerekmez. Mevcut bağlantıyı OAuth'a geçirirken elle yapılandırılmış Authorization başlığını veya bearer belirteci ayarını kaldırın.

Codex, Claude Code, Cursor, Cline, OpenMausBot veya başka MCP istemcisi için OAuth kurulum örneklerine bakın. İstemciniz için belgelenen geri çağrı ayarlarını kullanın. İstemci yeniden giriş isterse MCP giriş akışını tekrarlayın.

İstemci uyumluluğu

Tarayıcı giriş örnekleri Claude, Cursor, Claude Code, Codex, Grok Build ve Muse Code'u kayıtlı geri çağrı adresleriyle kapsar. Gemini CLI, VS Code, MiMo Code, MiMo Desktop, Hermes Agent ve OpenClaw kılavuzları kişisel erişim belirteci kullanır; VS Code kılavuzu ayrıca otomatik istemci kaydıyla tek tıklamalı kurulum sunar. Claude Desktop ve web bağlayıcısı, onaylanmış tam HTTPS geri çağrısıyla otomatik istemci kaydını destekler. OAuth keşfini ve Dinamik İstemci Kaydını destekleyen diğer istemciler de yalnızca sunucu URL'siyle bağlanabilir; kendi tam HTTPS veya yerel döngü geri çağrılarını kaydedip yönetirler. Önceden yapılandırılmış genel istemci ayarları, DCR desteklemeyen istemciler için alternatif olmaya devam eder.

OAuth uç noktaları keşif meta verisinden gelir. Web sitesinin kökündeki /authorize veya /token yerine SSO realm'i altında bulunurlar. İstemci kök uç noktayı açıyorsa önbellekteki keşif verisini yenilemek için sunucu yapılandırmasını yeniden yükleyip giriş yapın.

Claude'un bulut bağlayıcısı için Claude Desktop kılavuzunu izleyin. Başka bulut entegrasyonu bağlamadan önce tam geri çağrı URI'siyle desteğe başvurun. reconstruct-mcp için istemci sırrı girilmemelidir.

Aracı keşfi ve cihazla giriş

Herkese açık keşif https://reconstruct.dev/mcp/server-card adresinden başlar. Kökteki /.well-known/api-catalog herkese açık API belgelerini; /.well-known/agent-skills/index.json Reconstruct iş akışlarını ve kurulabilir arşivlerini listeler. Dokuz iş akışı, ayrı kurulum olmadan MCP kaynak erişimi, web sitesi veya GitHub CLI kurulumu, elle indirmeler ve istemciye özel eklenti paketleri için Reconstruct becerileri bölümüne bakın. Uzak MCP sunucusuna bağlanmak kullanıcının bilgisayarında .NET SDK gerektirmez.

Yayımlanmış web sayfaları ve belgeler Accept: text/markdown kabul eder. Çalışma alanı sayfaları yine hesap erişimi gerektirir.

OAuth Device Authorization uygulayan istemciler https://reconstruct.dev/auth.md okuyup https://reconstruct.dev/agent/register adresine {"type":"anonymous"} POST isteği gönderebilir. Yanıt bekleyen cihaz yetkilendirmesi, kullanıcı doğrulama URL'si ve kodu, son geçerlilik zamanı, yoklama aralığı ve gizli PKCE code_verifier içerir. Doğrulama talimatlarını kullanıcıya gösterin. Kullanıcı giriş yapıp erişimi onaylamalıdır. Aracı daha sonra device-code grant ve döndürülen code_verifier ile issuer'ın belirteç uç noktasını yoklar. Yoklama aralığına ve slow_down yanıtlarına uyun. Kayıt işlemi tek başına erişim belirteci çıkarmaz veya hesap oluşturmaz. Mevcut roller, abonelik sınırları ve onay gereksinimleri geçerli kalır.

Cihaz kodlarını, kod doğrulayıcılarını ve belirteçleri gizli tutun. Kullanıcı adına asla erişim onaylamayın. Bu akış, kendisini uygulayan istemcilerde kullanılabilir; düzenleyicinin mevcut Authorization Code + PKCE kurulumunun yerini almaz.

Kişisel erişim belirteci

1. Reconstruct Platform'a giriş yapıp Settings → API tokens bölümünü açın.
2. MCP kapsamlı (mcp) bir belirteç oluşturun ve gösterildiğinde gizli değerini kopyalayın.
3. İstemciyi Authorization: Bearer <token> gönderecek şekilde yapılandırın. Belirteci ortam değişkeninden okuyorsa CR_RECONSTRUCT_MCP_TOKEN kullanın.
4. Bağlanın ve istemciden list_products çağırmasını isteyin.

Belirteci yerel bir gizli bilgi veya istemci kimlik bilgisi deposunda tutun. Süresi dolarsa veya iptal edilirse Platform ayarlarında yenisini oluşturup istemcinin kimlik bilgilerini güncelleyin.

Yakalanmış verileri seçme

list_products, list_platforms ve list_versions ile başlayın. list_platforms.options.platforms[] içinden döndürülen kimliklerle platform türlerini ve ortamları seçin. list_platforms.platforms[] gerçekten yakalanmış verisi olan çiftleri içerir. Sayfa araçlarında list_pages.views[] içindeki tam kaydedilmiş view anahtarını kullanın. Sürüm birden çok ortam içeriyorsa environment değerini açıkça geçirin. Bağlam araçları kullanılabilir abonelik kotası gerektirir ve önbellekteki sonuçlar dahil, çağrı kabul edildiğinde bir bağlam okuması tüketir. Kabul edilen çağrı daha sonra başarısız olsa da sayılır. Keşif, görüntü araçları ve varlık indirmeleri bağlam okuması tüketmez. Kullanım sınırlarına bakın.

Sorun giderme

Belirti	Kontrol
401 Unauthorized	OAuth girişini tamamlayın veya kişisel belirteci kontrol edin; süresi dolmuş ya da iptal edilmişse değiştirin.
/authorize 404 döndürüyor	Bağlantı meta verisini yenileyip yeniden giriş yapın; yetkilendirme uç noktası https://reconstruct.dev/sso/realms/reconstruct altındadır.
invalid_scope	openid aud-mcp isteyin; Grok Build isteğe bağlı offline_access kapsamını da isteyebilir.
Girişten sonra kimlik doğrulama gerekiyor	Sunucuyu yenileyip OAuth girişini tekrarlayın. Çakışan elle yapılandırılmış bearer kimlik bilgilerini kaldırın.
OAuth yönlendirmesi eşleşmiyor	İstemciniz için belgelenen geri çağrı portunu kullanın. Hata sürerse istemcinin gösterdiği geri çağrı URI'siyle desteğe başvurun.
Dinamik istemci kaydı reddedildi	Otomatik OAuth kaydını seçip bir dakika sonra yeniden deneyin. İstemci tam HTTPS veya yerel döngü geri çağrısı sağlamalı ve PKCE S256 desteklemelidir. Kendini kaydedemiyorsa kılavuzundaki önceden yapılandırılmış OAuth ayarlarını kullanın.
Sunucu bağlanamıyor	Aracının çalıştığı makineden https://reconstruct.dev/mcp adresine erişilebildiğini doğrulayın.
Araçlar erişim reddedildi yanıtı döndürüyor	Reconstruct hesabınızla giriş yapıp aboneliğinizi kontrol edin. Erişim hâlâ kullanılamıyorsa desteğe başvurun.
Kota veya kullanım bilgisi kullanılamıyor	Hesap ayarlarında kullanımı ve durum sayfasını kontrol edin. Erişim kullanılabilir olduğunda yeniden deneyin.
Birden çok ortam yakalanmış	list_versions çıktısından environment sağlayın.
İstenen platform/görünüm kullanılamıyor	Yakalanmış platform/ortam çiftlerini ve tam list_pages.views[] anahtarlarını kullanın; desteklenen seçenekler depolanmış veriyi garanti etmez.
Hiç araç görünmüyor	Aracıyı yeniden başlatın veya MCP araç listesini yenileyin, ardından sunucu durumunu kontrol edin.

Bağlandıktan sonra istem örneklerini deneyin veya MCP araç kataloğuna göz atın.

Yeni yakalama veya güncelleme isteği

MCP sunucusu get_request_options, create_product_request, get_product_request, list_product_requests ve wait_product_request içerir. OAuth ile giriş yapın veya MCP erişim belirteci kullanın. Aboneliğiniz istekleri desteklemelidir; yalnızca kendi hesabınızla gönderilen istekleri görebilirsiniz. Aracıdan yeni ürün URL'si göndermesini veya bilinen yayımlanmış ürün anahtarını güncellemesini isteyin; ardından requestId değerini saklayıp inceleme durumu değişikliklerini beklemesini sağlayın. Onaylanan istek, yakalamanın henüz hazır olduğu anlamına gelmez. Parametreler için istek araçlarına bakın.