MCP

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://mcp.solk.app/mcp

Bu tek adres tüm Solk çalışma alanlarında çalışır: bağlanırken çalışma alanınızı (ör. firmaniz) yazar, girişi kendi çalışma alanınızda yaparsınız. Solk, Claude'un bağlayıcı dizininde de listelenir. Her çalışma alanının kendi adresi de durur — https://<firma>.solk.app/mcp — ikisi de aynı izinlerle çalışır. CRM'de Ayarlar → Uygulama bağlantıları ikisini de 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 → Browse connectors'tan Solk'u seçin — ya da + Add → Add custom connector ile ad Solk, adres https://mcp.solk.app/mcp.
  2. Connect'e basın ve çalışma alanınızı yazın (firmaniz ya da firmaniz.solk.app).
  3. Çalışma alanınızın 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 57 okuma, 41 yazma ve isteğe bağlı 10 kalıcı silme aracı sunar: arama, firma / kişi / fırsat / aksiyon / takvim / e-posta okuma, pano ve "Bugün", yorumlar, listeler, raporlar, ilişkiler ve tuvaller; ürün kataloğu, kalemli teklifler, siparişler, muhasebe / ERP sisteminizden cari ve faturalar, sözleşmeler, destek talepleri ve otomasyonlar; firma, kişi, fırsat, görev ve not açma, aşama değiştirme, aksiyon tamamlama, görüşme kaydı, yorum yazma, listeye ekleme, ilişki kurma, tuval oluşturma ve düzenleme; teklif hazırlama ve onaylatma, müşterinin PO numarasıyla sipariş açma, destek talebi açma ve güncelleme, elle çalıştırılan iş akışları; tüm kayıtlarda etkinlik arama, sayım ve toplamlar (aggregate), kılavuzda arama, e-posta şablonları ve taslak (göndermez), notlar, bildirimler, özel nesneler, WhatsApp Business (beta), çağrı merkezinin arama listesine ekleme ve yöneticiler için iş akışı taslağı. Tam liste ve parametreler: Araçlar. Ayrıca 11 hazır istem (firma özeti, toplantı hazırlığı, fırsat değerlendirmesi, haftalık hat, teklif hazırla, cari ve tahsilat, destek önceliklendirme…) ve kaynaklar (çalışma alanı şeması, satış süreci, kayıt ve tuval özetleri) vardır.

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, yazma ve silme ayrı — crm.read ve crm.write kapsamları onaylanır; okuma araçları istemciye "salt okunur" olarak bildirilir. Silme ve birleştirme ayrı Kalıcı silme (crm.delete) iznidir: onay ekranında varsayılan kapalı kutu, her çağrıda confirm: true. Ayrıntı
  • 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.