Diğer MCP istemcilerini bağlama

Claude ve ChatGPT’nin yanı sıra HTTP üzerinden uzak sunucuları ve OAuth girişini destekleyen her MCP istemcisi çalışır – örneğin Cursor gibi IDE’ler veya test için MCP Inspector. Bu makale böyle bir istemciyi kendisi kuran ya da kendi entegrasyonunu geliştiren herkes içindir.

#Temel bilgiler

Sunucu URL’si

https://dock.at-harbor.com/mcp

Aktarım

Streamable HTTP, durumsuz. Her istek bir JSON-RPC mesajı (veya toplu mesaj) içeren bir POST’tur ve yanıt JSON olarak döner. Oturum kimliği ve sunucu akışı yoktur.

Protokol sürümleri

2025-11-25, 2025-06-18 ve 2025-03-26

Yöntemler

initialize, ping, tools/list ve tools/call. Sunucu kaynak (resources) veya istem (prompts) sunmaz.

Giriş

PKCE (S256) ile OAuth 2.1. Token olmadan sunucu 401 ile yanıt verir ve WWW-Authenticate başlığında meta verilerine işaret eder.

#Bir istemci kur

1. İstemcine uzak bir MCP sunucusu ekle (çoğu zaman “Remote”, “HTTP” veya “Streamable HTTP” olarak adlandırılır)
2. URL olarak https://dock.at-harbor.com/mcp gir
3. Client ID ve secret alanlarını boş bırak – istemci kendini kaydeder
4. Bağlantıyı başlat; giriş tarayıcında açılır, ardından LinkHarbor onay sayfası gelir
5. Çalışma alanını ve izinleri seç ve “İzin ver”e tıkla

Ayarın adı programdan programa değişir. Örneğin MCP Inspector’da “Streamable HTTP” aktarımını seçersin.

#Ayrıntılı OAuth akışı

1. İstemci MCP sunucusunu token olmadan çağırır ve kaynak meta verilerine işaretle birlikte 401 alır
2. Yetkilendirme sunucusu meta verilerini okur (uç noktalar, desteklenen yöntemler, izinler)
3. Kendini kaydeder: Dynamic Client Registration ile ya da bir https URL’sindeki bir istemci meta veri belgesiyle
4. Tarayıcıyı PKCE ve resource=https://dock.at-harbor.com/mcp dahil yetkilendirme isteğiyle açar
5. Sen giriş yapar ve onay sayfasında karar verirsin
6. İstemci kodu bir erişim token’ı ve bir yenileme token’ıyla değiştirir

Bir istemci hiç izin istemezse tümü istenir; bunları onay sayfasında yine de daraltabilirsin. Zaten değiştirilmiş bir yenileme token’ı yeniden kullanılırsa LinkHarbor güvenlik nedeniyle bağlantının tamamını sonlandırır.

#Yönlendirme adresleri için kurallar

• https adresleri
• http yalnızca kendi bilgisayarındaki loopback adresleri için (masaüstü istemcileri ve IDE’ler için)
• Ters alan adı gösteriminde özel uygulama şemaları
• İstemci başına en fazla 10 adres, parça (fragment) yok

Bir uygulama kendisi için kayıtlı olmayan bir adres gönderirse LinkHarbor durur: “Uygulama, kendisi için kayıtlı olmayan bir dönüş adresi gönderdi. İstek durduruldu.”

#Geliştiriciler için keşif adresleri

#Bilinmeyen uygulamalar

Tüm yönlendirme adresleri claude.ai, claude.com, chatgpt.com veya openai.com üzerinde olan uygulamalar bilinen sayılır. Kendi bilgisayarında çalışan ve localhost üzerinden dönen programlar – Claude Code, Codex ve IDE’ler gibi – onay sayfasında “LinkHarbor bu uygulamayı tanımıyor. Uygulama kendi bilgisayarında çalışıyor. Yalnızca az önce kendin başlattıysan devam et.” notunu, altta da “Seçiminden sonra bilgisayarındaki uygulamaya dönersin.” satırını gösterir. Diğer bilinmeyen web uygulamaları “LinkHarbor bu uygulamayı tanımıyor. Yalnızca bunu kendin başlattıysan ve … adresine güveniyorsan devam et.” notunu gösterir; … yerine kendi adresleri yazar. İstemciyi az önce kendin kurduysan ikisi de normaldir. Logo yalnızca uygulama bir logo gönderirse görünür. Girişi kendin başlatmadıysan “Reddet”e tıkla.