Başka bir MCP istemcisini bağlama

Bu adımlar uzak MCP sunucularını destekleyen, ancak burada özel kılavuzu olmayan bir yapay zekâ aracısı veya düzenleyici için geçerlidir. Önce Başlamadan önce bölümünde açıklandığı gibi OAuth veya kişisel belirteç seçin.

Sunucuyu ekleme

1. İstemcinin MCP sunucusu ayarlarını açıp reconstruct adlı bir sunucu ekleyin.
2. Streamable HTTP seçin (bazı istemcilerde HTTP veya remote HTTP olarak adlandırılır).
3. Sunucu URL'sini https://reconstruct.dev/mcp olarak ayarlayın.

Tarayıcı üzerinden OAuth girişi

İstemciniz OAuth keşfini ve Dinamik İstemci Kaydını (DCR) destekliyorsa yalnızca https://reconstruct.dev/mcp ekleyin, OAuth seçip bağlanın. İstemci kendi geri çağrı adresini kaydeder, Reconstruct girişini açar ve erişimi onayladıktan sonra geri çağrıyı otomatik alır. Client ID veya geri çağrı portunu elle girmeniz gerekmez.

Barındırılan uygulamalar https://app.example.com/mcp/callback gibi herkese açık bir alan adında tam HTTPS geri çağrı adresi kaydedebilir. Yerel uygulamalar, açıkça belirtilen bir portla 127.0.0.1 veya localhost üzerinde tam HTTP geri çağrısı kaydedebilir. Geri çağrı MCP sunucusuna değil istemciye aittir ve istemci tarafından işlenir. Kayıt, PKCE S256, kullanıcı onayı ve yalnızca MCP kapsamları gerektirir. Joker karakterler, yerel döngü dışında kalan HTTP adresleri, URL parçaları ve uzak anahtar URL'leri reddedilir.

Otomatik kayıt yapamayan istemciler

Uygulama kendini kaydedemiyorsa önceden kayıtlı genel istemciyi kullanın:

1. İstemci kimliğini reconstruct-mcp, kapsamları openid aud-mcp olarak ayarlayın ve istemci sırrını boş bırakın.
2. Yerel OAuth geri çağrı portunu 58234, yolunu /callback olarak ayarlayın.
3. Kaydedip bağlanın, tarayıcı girişini tamamlayın, erişimi onaylayın ve istemciye dönün.

Özel istemciler için yerel geri çağrı

İstemciyi kendi bilgisayarınızda 58234 portunu dinleyecek şekilde yapılandırın ve şu tam yönlendirme URI'lerinden birini kullanın:

• http://127.0.0.1:58234/callback
• http://localhost:58234/callback

İstemci PKCE (S256) ile Authorization Code akışını desteklemelidir. reconstruct-mcp istemci kimliğini, openid aud-mcp kapsamlarını kullanın; istemci sırrı kullanmayın. Giriş ve belirteç değişiminde gönderilen yönlendirme URI'si yapılandırılan URI ile birebir aynı olmalıdır.

58234 portu yalnızca yerel tarayıcı geri çağrısı içindir. Uzak MCP sunucusu URL'si HTTPS üzerinden https://reconstruct.dev/mcp olarak kalır. Geri çağrı dinleyicisini yerel döngü arayüzüne bağlayın; bu portu ağa açmayın. Bu portta aynı anda yalnızca bir giriş akışı dinleyebilir; yenisini başlatmadan önce mevcut girişi tamamlayın.

İstemciye otomatik dönüş

MCP istemcisi tarayıcıyı açmadan önce yerel geri çağrı dinleyicisini başlatmalıdır. Giriş ve onaydan sonra Keycloak tarayıcıyı bu dinleyiciye yönlendirir; istemci yetkilendirme yanıtını alır, PKCE kullanarak kodu değiştirir ve MCP bağlantısına devam eder. Kullanıcıların geri çağrı URL'sini veya yetkilendirme kodunu elle kopyalaması gerekmemelidir.

Muse Code, Grok Build, Codex ve Claude Code kılavuzlarında gösterilen ortak portu kullanabilir. Cursor veya Claude Desktop gibi kendi sabit geri çağrısı olan istemciler destekledikleri adresleri korur.

Özel bir C# uygulamasında ClientOAuthOptions.RedirectUri yapılandırın ve tarayıcıyı açıp code, state ve iss değerlerini yakalamak için AuthorizationCallbackHandler uygulayın. Yalnızca yönlendirme URI'sini ayarlamak bir dinleyici oluşturmaz; SDK'nın varsayılan işleyicisi yönlendirme URL'sini elle ister. Resmî C# SDK OAuth seçeneklerine bakın.

Issuer değeri https://reconstruct.dev/sso/realms/reconstruct şeklindedir; kökte /authorize ve /token URL'leri oluşturmak yerine keşfedilen yetkilendirme ve belirteç uç noktalarını kullanın.

OAuth seçerken elle yapılandırılmış Authorization başlığını kaldırın. Girişte geri çağrı hatası bildirilirse istemcinin gösterdiği geri çağrı URI'siyle desteğe başvurun.

Kişisel erişim belirteci

İstemci OAuth desteklemiyorsa Platform ayarlarında MCP belirteci oluşturun ve HTTP Authorization başlığını Bearer <your MCP token> olarak ayarlayın. Destekleniyorsa istemcinin gizli bilgi deposunu veya CR_RECONSTRUCT_MCP_TOKEN ortam değişkenini kullanın.

Bağlantıyı kontrol etme

İstemciyi yeniden bağlayın veya başlatın. Araç listesinde list_products göründüğünü doğrulayın, ardından aracıdan bunu çağırmasını isteyin.

Tüm istemcilerin paylaştığı tek bir JSON biçimi yoktur. Bazıları mcpServers, bazıları servers veya mcp kullanır; bazıları type alanını zorunlu tutar. Tam alan adları ve belirteç genişletme sözdizimi için istemcinizin belgelerini izleyin. Yalnızca eski SSE aktarımını destekleyen istemci, Reconstruct'ın HTTP /mcp uç noktasını SSE olarak kullanamaz.

Bağlantı başarısız olursa sorun giderme tablosunu kontrol edin. Bağlandıktan sonra istem örneklerini deneyin.