Solk MCP

Claude gibi yapay zekâ asistanlarını CRM'inize bağlayın — firmaları ve fırsatları sorun, görev ve görüşme kaydını sohbetten açın.

Solk MCP, her kurulumda çalışan bir Model Context Protocol sunucusudur. MCP destekleyen bir yapay zekâ asistanı (Claude, Claude Code, ChatGPT geliştirici modu, Cursor, VS Code…) bu sunucuya bağlandığında CRM'inizi doğal dille sorgulayabilir ve sizin onayınızla kayıt açabilir.

https://<firma>.solk.app/mcp

Bağlayıcı adresinizi CRM'de Ayarlar → Uygulama bağlantıları sayfası gösterir ve tek tıkla kopyalar.

Neler yapabilirsiniz?

Başlarken

Gereksinimler: Solk kurulumunuzda bir kullanıcı hesabı ve MCP destekleyen bir istemci. Bağlantı sizin hesabınızla çalışır; ek lisans gerekmez.

Claude (claude.ai, masaüstü ve mobil)

1. Claude'da Customize → Connectors → + Add → Add custom connector'ı açın.
2. Ad olarak Solk yazın, adres olarak https://<firma>.solk.app/mcp'yi yapıştırın ve Add'e basın.
3. Connect'e basın. Solk giriş sayfası açılır (oturumunuz açıksa doğrudan onay ekranı); izinleri onaylayın.

Team ve Enterprise planlarında özel bağlayıcıyı kuruluş sahibi bir kez ekler (Organization settings → Connectors → Add → Custom → Web); her üye kendi Solk hesabıyla Connect'e basar. Ücretsiz planda tek özel bağlayıcı eklenebilir.

Claude Code

claude mcp add --transport http solk https://ornek.solk.app/mcp

Claude Code içinde /mcp yazıp solk sunucusunu seçin ve tarayıcıda açılan onay ekranında izin verin.

Diğer istemciler

İstemciye uzak MCP sunucusu (Streamable HTTP) olarak adresi girin; istemci OAuth keşfini kendisi yapar. OAuth desteklemeyen ve sabit başlık isteyen araçlarda yönetici Ayarlar → Geliştiriciler'den açtığı API anahtarını kullanabilir:

{
  "mcpServers": {
    "solk": {
      "url": "https://ornek.solk.app/mcp",
      "headers": { "Authorization": "Bearer sk_…" }
    }
  }
}

Ayrıntılı adımlar: Bağlanma.

Araçlar

Sunucu 14 okuma ve 9 yazma aracı sunar: arama, firma / kişi / fırsat / aksiyon / takvim / e-posta okuma, pano ve "Bugün"; firma, kişi, fırsat, görev ve not açma, aşama değiştirme, aksiyon tamamlama ve görüşme kaydı. Tam liste ve parametreler: Araçlar.

Güvenlik

• OAuth ile kimlik — parolanız istemciye verilmez; onay ekranında istenen izinleri görürsünüz.
• Hesabınızın yetkileri — asistan yalnız sizin görebildiğiniz kayıtları görür ve yalnız sizin değiştirebildiklerinizi değiştirir; rol, modül izinleri ve kayıt görünürlüğü aynen geçerlidir.
• Okuma ve yazma ayrı — crm.read ve crm.write kapsamları ayrı onaylanır; okuma araçları istemciye "salt okunur" olarak bildirilir.
• Geri alınabilir — Ayarlar → Uygulama bağlantıları'nda bağlı uygulamaları, son kullanımı ve işlem sayısını görür, Erişimi kaldır ile anında kesersiniz.
• Denetlenebilir — her araç çağrısı denetim günlüğüne yazılır.

Ayrıntı: Güvenlik.

Sınırlar

Belirteç başına dakikada 300 istek. Bir araç yanıtı en çok ~90.000 karakter taşır; daha uzun yanıtlar kısaltılır ve sonuna sayfa ya da süzgeç kullanılması gerektiği notu eklenir.