# 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.

```text
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?

:::cards
- [Firma ve kişi bulma](/mcp/prompts#lookup) search | "Alize Paketleme'de satın almadan kim sorumlu, son ne konuştuk?"
- [Günlük iş listesi](/mcp/prompts#today) check | "Bugün ve bu hafta geciken aksiyonlarım neler?"
- [Satış hattı](/mcp/prompts#pipeline) target | "Negotiation'daki fırsatları değere göre sırala, SLA'sı aşanları işaretle."
- [Kayıt açma](/mcp/prompts#write) plus | "Kuzey Plastik'le az önceki telefon görüşmesini kaydet, perşembeye teklif aksiyonu aç."
:::

## 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

```bash
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:

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

Ayrıntılı adımlar: [Bağlanma](/mcp/connect).

## 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](/mcp/tools).

## 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](/mcp/security).

## 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.