Bağlanma
Claude, Claude Code ve diğer MCP istemcilerini Solk kurulumunuza adım adım bağlayın; OAuth keşfinin nasıl çalıştığını görün.
Claude
- 1
Bağlayıcıyı ekleyin
Claude'da (web, masaüstü ya da mobil) Customize → Connectors → Browse connectors'ı açıp Solk'u seçin. Ya da kendiniz ekleyin: + Add → Add custom connector, ad
Solk, adreshttps://mcp.solk.app/mcp(çalışma alanınızın kendi adresihttps://<firma>.solk.app/mcpde olur). Gelişmiş ayarlardaki istemci kimliği alanlarını boş bırakın — Claude kendini otomatik tanıtır. - 2
Bağlanın
Bağlayıcının yanındaki Connect'e basın. Solk çalışma alanınızı sorar —
firmaniz(ya da girişte kullandığınız tam adres) yazıp Devam'a basın; Solk bir sonraki sefer için hatırlar. Adresinizi bilmiyor musunuz? Adresimi bilmiyorum → e-postanızın kayıtlı olduğu her çalışma alanının bağlantısı e-postayla gelir. Ardından çalışma alanınızın giriş sayfası açılır — şifreniz yalnız orada yazılır; giriş yaptıktan sonra onay ekranı Claude'un istediği izinleri gösterir:- Kayıtları okuma — firma, kişi, fırsat, aksiyon, e-posta yazışması, takvim ve panolar
- Kayıt oluşturma ve güncelleme — firma, kişi, fırsat, görev, not ve görüşme kaydı; görev tamamlama; aşama değiştirme
İzin ver'e basınca Claude'a dönersiniz.
- 3
Kullanın
Sohbette Solk'u açık tutun ve sorunuzu yazın. Claude bir aracı ilk kez kullanırken izin ister; okuma araçları için "her zaman izin ver" seçebilirsiniz.
Team / Enterprise: Bağlayıcıyı kuruluş sahibi Organization settings → Connectors → Add → Custom → Web ile ekler. Üyeler bağlayıcıyı kendi listelerinde görür ve Connect ile kendi Solk hesaplarıyla bağlanır — her üyenin yetkisi kendi Solk rolüyle sınırlıdır.
Claude Code
claude mcp add --transport http solk https://mcp.solk.app/mcpTarayıcıda çalışma alanınızı yazın. Bu adımı atlamak için çalışma alanınızın kendi adresini kullanın (https://<firma>.solk.app/mcp).
Ardından Claude Code'da /mcp → solk → Authenticate. Claude Code yerel bir dönüş adresi (http://localhost:<kapı>/callback) kullanır; Solk yerel geri döngü adreslerinde kapı numarasını eşleşmede yok sayar.
Projede herkesin kullanması için kapsamı proje yapabilirsiniz (--scope project, .mcp.json'a yazılır); her geliştirici yine kendi hesabıyla izin verir.
Claude API (MCP bağlayıcısı)
Kendi uygulamanızdan Claude'u Solk ile konuşturmak için Messages API'nin MCP bağlayıcısını kullanın: istekte anthropic-beta: mcp-client-2025-11-20 başlığı, mcp_servers içinde Solk adresi ve tools içinde aynı adla bir mcp_toolset olur.
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: mcp-client-2025-11-20" \
-H "content-type: application/json" \
-d '{
"model": "claude-opus-5-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Solk'ta bugün ne yapmam gerekiyor?"}],
"mcp_servers": [{
"type": "url",
"url": "https://ornek.solk.app/mcp",
"name": "solk",
"authorization_token": "sk_…"
}],
"tools": [{"type": "mcp_toolset", "mcp_server_name": "solk"}]
}'authorization_token: yöneticinin Ayarlar → Geliştiriciler'de oluşturduğu API anahtarı (sk_…) — araçlar anahtarı oluşturan kişinin yetkisiyle ve iki kapsamla çalışır. Kullanıcı adına çalışacaksanız kendi OAuth akışınızla aldığınız erişim belirtecini (mcp_…, 1 saat geçerli; yenileme) verin.- Anahtar istekle Anthropic'e gider; sunucu tarafında saklayın, tarayıcıya koymayın.
- Belirli araçları kapatmak için
toolsgirdisinedefault_config/configsekleyebilirsiniz (ör. yalnız okuma araçları).
ChatGPT, Cursor, VS Code ve diğerleri
Uzak MCP sunucusu (Streamable HTTP) destekleyen istemcilere aynı adresi girin. OAuth destekleyen istemciler keşfi kendileri yapar. Desteklemeyenlerde yönetici bir API anahtarı açıp Authorization: Bearer sk_… başlığıyla verebilir — bu durumda araçlar anahtarı açan yöneticinin yetkisiyle ve her iki kapsamla çalışır.
Tek adres ve çalışma alanınızın adresi
https://mcp.solk.app/mcp |
https://<firma>.solk.app/mcp |
|
|---|---|---|
| Kim kullanır | Claude'un bağlayıcı dizini; adres aramak istemeyen herkes | Tek çalışma alanına bağlanan yöneticiler ve geliştiriciler |
| Çalışma alanı | Bağlanırken bir kez sorulur (hatırlanır) | Adresle belli |
| Giriş ve onay | Kendi çalışma alanınızda (<firma>.solk.app) |
Kendi çalışma alanınızda |
| Belirteçler | Çalışma alanı önekiyle (<firma>.solk.app~mcp_…) |
mcp_… |
| İzinler, sınırlar, IP kısıtı | Aynı — isteği çalışma alanınız işler | Aynı |
mcp.solk.app isteği yalnız yönlendirir: şifre, kod, belirteç ya da kayıt verisi saklamaz; PKCE ve belirteç doğrulaması çalışma alanınızda yapılır. Çalışma alanınız istemcinin gerçek IP adresini görür — IP kısıtı aynen çalışır.
OAuth keşfi nasıl işler?
İstemciler için ek yapılandırma gerekmez; akış standartlara göredir (MCP Authorization, OAuth 2.1). Tek adreste yetkilendirme sunucusu https://mcp.solk.app'tir; adımlar aynıdır:
- İstemci belirteçsiz
POST /mcpgönderir →401veWWW-Authenticate: Bearer … resource_metadata="https://ornek.solk.app/.well-known/oauth-protected-resource/mcp". - İstemci korunan kaynak bilgisini okur (RFC 9728) → yetkilendirme sunucusu
https://ornek.solk.app. - Yetkilendirme sunucusu bilgisini okur (RFC 8414).
- Kendini kaydeder (RFC 7591) ya da istemci bilgi belgesi (CIMD) adresini
client_idolarak kullanır. - Kullanıcıyı PKCE (S256) ile onay ekranına yönlendirir, kodu belirteçle değiştirir.
Authorization: Bearer mcp_…ile MCP isteklerini gönderir; belirteç süresi dolunca yeniler.
Protokol ayrıntıları
| Taşıma | Streamable HTTP, JSON yanıt (SSE akışı yok) |
| Protokol sürümleri | 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 |
| Yöntemler | initialize, tools/list, tools/call, ping ve bildirimler |
GET /mcp |
405 (sunucudan istemciye akış yok) |
| Oturum | Durumsuz; Mcp-Session-Id gerekmez |
| Yetersiz kapsam | Yazma aracı crm.write olmadan çağrılırsa 403 + WWW-Authenticate: … error="insufficient_scope"; silme aracı crm.delete olmadan çağrılırsa isError: true ve bağlantıyı yeniden kurup Kalıcı silme kutusunu işaretleme açıklaması |
curl https://ornek.solk.app/mcp \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'