MCP

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. 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, adres https://mcp.solk.app/mcp (çalışma alanınızın kendi adresi https://<firma>.solk.app/mcp de olur). Gelişmiş ayarlardaki istemci kimliği alanlarını boş bırakın — Claude kendini otomatik tanıtır.

  2. 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. 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/mcp

Tarayı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 tools girdisine default_config / configs ekleyebilirsiniz (ö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:

  1. İstemci belirteçsiz POST /mcp gönderir → 401 ve WWW-Authenticate: Bearer … resource_metadata="https://ornek.solk.app/.well-known/oauth-protected-resource/mcp".
  2. İstemci korunan kaynak bilgisini okur (RFC 9728) → yetkilendirme sunucusu https://ornek.solk.app.
  3. Yetkilendirme sunucusu bilgisini okur (RFC 8414).
  4. Kendini kaydeder (RFC 7591) ya da istemci bilgi belgesi (CIMD) adresini client_id olarak kullanır.
  5. Kullanıcıyı PKCE (S256) ile onay ekranına yönlendirir, kodu belirteçle değiştirir.
  6. 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"}'