# MCP sunucusu

Claude ve diğer ajanlar dışa aktardıklarınızda arama yapabilsin.

Exporter, uygulamanın içinde bir MCP sunucusu çalıştırır. Dışa aktarma klasörlerinizi Claude'a, Cursor'a, VS Code'a ve diğer her MCP istemcisine salt okunur olarak ve yalnızca Mac'inizde sunar. Bir ajanın kullanabileceği skill'ler ve komut satırı için [Ajanlar için](https://exporter.dev/agents) sayfasına bakın.

## Başlatın

1. En az bir uygulamayı Markdown olarak dışa aktarın ([başlarken](https://exporter.dev/docs/getting-started)). Sunucu yalnızca Markdown dosyalarını okur.
2. MCP Sunucusu kartında "başlat" düğmesine basın. Kart ardından `localhost:8744` adresini ve bir "bağla" satırını gösterir.

Uç nokta, sabit bir bağlantı noktasında `http://localhost:8744/mcp` adresidir (Streamable HTTP). Sunucu uygulamanın içinde yaşar: Exporter çalıştığı sürece, pencere açık da olsa kapalı da olsa yanıt verir ve uygulamadan çıktığınızda durur. Çıktığınızda çalışıyorsa uygulamayla birlikte yeniden başlar. Sunucu açıkken `curl -s http://127.0.0.1:8744/health` komutu `OK` yanıtını verir.

## Claude Code'u bağlayın

```sh
claude mcp add --transport http exporter http://localhost:8744/mcp
```

Her projede olması için `--scope user` ekleyin. Karttaki "claude code" düğmesi bu komutu kopyalar.

## Claude Desktop, Cursor ve VS Code

- Claude Desktop: kartta "claude desktop" düğmesine basın. `npx -y mcp-remote http://localhost:8744/mcp` çalıştıran bir girdi kopyalar (`npx`, Node.js ile gelir). Bunu Settings > Developer > Edit Config altında `mcpServers` içine yapıştırın, kaydedin, sonra Claude'dan çıkıp yeniden açın
- Cursor ya da VS Code: kartta "cursor" ya da "vs code" düğmesine basın. Düzenleyici, sunucu kuruluma hazır olarak açılır; orada onaylayın

## Hangi klasörleri sunar

Apple Notes dışa aktarma klasörüyle aynı üst klasörde duran dışa aktarma klasörleri (Apple Notes klasörü yoksa, bulduğu ilk dışa aktarma klasörü). Başka bir yerdeki dışa aktarma klasörü ajanlar için görünmezdir; MCP Sunucusu kartı, ajanların hangilerini görebildiğini söyler.

| dışa aktarma klasörleri | sunulan |
| --- | --- |
| `~/Documents/notes`, `~/Documents/messages` | ikisi de |
| `~/Documents/notes`, `~/Dropbox/messages` | yalnızca notes |

Bir klasörü dahil etmek için o uygulamanın `şuraya aktar` satırında "değiştir..." düğmesine basın, aynı üst klasörde bir klasör seçin, sonra o kartta "tam yeniden eşzamanlama" düğmesine basın. Sunucu klasör listesini başlarken okur, bu yüzden her değişiklikten sonra "durdur" ve "başlat" düğmelerine basın. Her kaynak, klasörünün adını alır, örneğin `notes` ya da `messages`.

## Altı araç

| araç | ne yapar | parametreler |
| --- | --- | --- |
| `get_stats` | kaynak başına: dosya sayısı, en yeni ve en eski tarihler, boyut. Kaynak adlarını öğrenmek için önce bunu çağırın | `source` (isteğe bağlı) |
| `search` | sıralı tam metin araması | `query`, `source` (isteğe bağlı), `limit` (20) |
| `read` | tek bir öğe: Markdown'u, front matter'ı, değiştirilme tarihi ve boyutu | `source`, `id` (`.md` olmadan dosya adı) |
| `list` | bir kaynağın öğeleri | `source`, `limit` (50), `offset` (0) |
| `get_recent` | en son değişen öğeler | `sources` (virgülle ayrılmış, isteğe bağlı), `limit` (20) |
| `get_metadata` | sayılar ve son eşitleme zamanları | `source` (isteğe bağlı) |

`search`, Apple Notes, Kişiler ve Mesajlar'ı uygulamanın dizini üzerinden sıralar: bir ad sohbeti bulur, bir not sonucu da notu Apple Notes'ta açan bir bağlantı taşır. Bear, Logseq, Ekran Süresi ve Belgeler de sunulur, ancak dizin yanıt verirken `search` onları sıralamaz; onlara `list`, `get_recent` ve `read` ile ulaşın. Dizin henüz boşken `search` her kaynağın Markdown'unu tarar.

Yanıtlar ancak dışa aktarım kadar eksiksizdir: ücretsiz kotada bu, ilk 100 notunuz, 100 kişiniz ve en son 10 sohbetiniz, 10 gün ve 10 belgedir.

## Gizlilik

Sunucu 127.0.0.1 adresini dinler, bu yüzden Mac'inizin dışındaki hiçbir şey ona ulaşamaz ve yalnızca okur. Bir aracın döndürdüğü şey, yapay zekâyla yaptığınız sohbetin bir parçası olur ve yapıştırdığınız her şey gibi onun modeline gider.

## Çalışmadığında

- `Yapılandırılmış dışa aktarma klasörü yok. Önce bir dışa aktarma klasörü belirleyin.`: herhangi bir kartta bir dışa aktarma klasörü seçin
- `Dışa aktarılmış not bulunamadı. Önce bir dışa aktarma çalıştırın.`: bir kartta "şimdi eşzamanla", sonra "başlat" düğmesine basın
- "başlat" düğmesinde bir sistem hatası: 8744 numaralı bağlantı noktasını başka bir program kullanıyor. O programdan çıkın ve yeniden başlatın
- bir kaynak eksik: üst klasörün dışında duruyor, yalnızca HTML olarak dışa aktarıldı, sunucu başladıktan sonra ortaya çıktı ya da ücretsiz kotanın ötesinde

## Related

- [For agents](https://exporter.dev/agents): Skills, command line and MCP for agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac
- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code

---

human version: https://exporter.dev/tr/docs/mcp
every page: https://exporter.dev/llms.txt