# Yapay zekâ aracısı bağlama {/* #connect-an-ai-agent */}

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

- [Codex](/docs/tr/agents/codex)
- [Claude](/docs/tr/agents/claude)
- [Cursor](/docs/tr/agents/cursor)
- [Cline](/docs/tr/agents/cline)
- [VS Code'da GitHub Copilot](/docs/tr/agents/vscode-copilot)
- [Gemini CLI](/docs/tr/agents/gemini-cli)
- [MiMo](/docs/tr/agents/mimo)
- [Muse Code](/docs/tr/agents/muse-code)
- [Grok Build](/docs/tr/agents/grok-build)
- [Hermes Agent](/docs/tr/agents/hermes)
- [OpenClaw](/docs/tr/agents/openclaw)
- [OpenMausBot](/docs/tr/agents/openmausbot)
- [Diğer MCP istemcileri](/docs/tr/agents/other-mcp-clients)

## Başlamadan önce {/* #before-you-start */}

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-browser-sign-in */}

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](/docs/tr/agents/codex#oauth-browser-sign-in), [Claude Code](/docs/tr/agents/claude-code#oauth-browser-sign-in), [Cursor](/docs/tr/agents/cursor#oauth-browser-sign-in), [Cline](/docs/tr/agents/cline#oauth-browser-sign-in), [OpenMausBot](/docs/tr/agents/openmausbot#oauth-browser-sign-in) veya [başka MCP istemcisi](/docs/tr/agents/other-mcp-clients#oauth-browser-sign-in) 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 {/* #client-compatibility */}

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](/docs/tr/agents/claude-desktop) 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ş {/* #agent-discovery-and-device-sign-in */}

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](/docs/tr/skills) 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 {/* #personal-access-token */}

1. [Reconstruct Platform'a](https://reconstruct.dev/platform/) 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 {/* #select-captured-data */}

`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](/docs/tr/mcp-tools#usage-limits) bakın.

## Sorun giderme {/* #troubleshooting */}

| 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](/docs/tr/prompt-examples) deneyin veya [MCP araç kataloğuna](/docs/tr/mcp-tools) göz atın.

### Yeni yakalama veya güncelleme isteği {/* #request-a-new-capture-or-update */}

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](/docs/tr/mcp-tools#product-requests) bakın.