# MCP sunucusu

> Claude, Cursor veya herhangi bir MCP istemcisi kafenizin kendi verisini tek satırla okur. npm ve PyPI üzerinde, kurulum yok, sunucu yalnızca okur.

Sadakio MCP sunucusu yapay zeka ajanınızı doğrudan verinize bağlar. Kurulum yoktur, komut paketi kendisi indirir, sunucu yalnızca okur ve hiçbir şeyi değiştirmez.

## Kurulum

```
npx sadakio-mcp    # Node 18 ve üzeri
uvx sadakio-mcp    # Python 3.10 ve üzeri
```

İstemcinizin ayar dosyasına yapıştırın ve `sk_` anahtarınızı yazın:

```json
{
  "mcpServers": {
    "sadakio": {
      "command": "npx",
      "args": ["-y", "sadakio-mcp"],
      "env": { "SADAKIO_API_KEY": "sk_ANAHTARINIZ" }
    }
  }
}
```

Claude Desktop, Claude Code, Cursor ve MCP konuşan her istemcide aynı blok çalışır.

## Araçlar

| Araç | Ne yapar |
|---|---|
| `list_guests` | Misafir listesi: arama ve sayfalama, telefonlar KVKK maskeli |
| `get_guest` | Tek misafir: kartları ve program tipiyle |
| `list_visits` | Ziyaret akışı: tarih filtreleriyle |
| `get_retention` | Geri dönen misafir özeti: 7, 30 ve 365 günlük pencereler |

## Ne sorulur

Ajanınıza doğal dille sorun:

- «Bu ay kaç misafir geri geldi, geçen ayla karşılaştır»
- «60 gündür gelmeyen ama 5'ten çok ziyareti olan misafirleri listele»
- «Dün kaç damga işlendi»

Paketler: [npm](https://www.npmjs.com/package/sadakio-mcp) · [PyPI](https://pypi.org/project/sadakio-mcp/) · MIT lisansı