# Contextator

> Model Context Protocol konuşan, kendi kendine barındırılan bir dokümantasyon sunucusu — AI ajanlarına kendi dokümanlarınız üzerinde anlamsal arama kazandırır.

- Güncelleme: 2026-09-21
- Kaynak: https://contextator.com/tr/docs/home/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
**AI ajanınıza dokümantasyonunuzu verin.**

Contextator, [Model Context Protocol](https://modelcontextprotocol.io) konuşan, kendi kendine
barındırılan bir dokümantasyon sunucusudur. Onu dokümantasyonunuzun gerçekten bulunduğu yerlere
işaret edersiniz — sunucudaki bir klasör, bir git deposu, birinin size gönderdiği bir zip, bir
Obsidian vault'u, bir Notion workspace'i — ve her proje, Claude Code, Cursor, Claude Desktop ve diğer
her MCP istemcisinin arayabileceği — anlam ve birebir sözcük aynı anda — kendi URL'si olur:

```
http://localhost:3444/mcp/my-project
```

Ajanınıza *"imzalama anahtarını nasıl döndürüyoruz?"* diye sorun; dokümantasyonunuzu arar, doğru
paragrafı alıntılar ve hangi dosyadan geldiğini söyler.

Depo klonlamaya gerek yok — bu, yayımlanmış `contextator/contextator` imajını çeker:

```bash
mkdir contextator && cd contextator
curl -fsSLO https://raw.githubusercontent.com/Contextator/Contextator/main/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/Contextator/Contextator/main/.env.example
cp .env.example .env
docker compose up -d
```

Ardından **http://localhost:3444/** adresini açın ve ilk projenizi oluşturun. Turun tamamı
**[Hızlı Başlangıç](/tr/docs/quick-start/)** sayfasında — sıfırdan, sorulara yanıt veren bir ajana
kadar yaklaşık on dakika.

---

## Onu farklı kılan ne

- **Proje başına tek URL, tamamen izole.** `/mcp/billing`'e bağlı bir istemci `/mcp/mobile`'ı asla
  göremez. Ayrı belgeler, ayrı gömmeler, ayrı her şey.
- **Proje başına birden çok kaynak.** Bir yerel klasör *ve* iki git deposu *ve* yüklenmiş bir vault
  *ve* bir Notion workspace'i — hepsi tek bir aranabilir endpoint'te birleşir, her biri kendi adı
  altında.
- **Proje başına açık ya da kapalı.** Yeni bir proje varsayılan olarak token required'dır — onu
  oluşturmak bir kez gösterilen bir ilk token üretir — ve kendi sayfasından open'a ya da account
  required'a çevrilebilir. Open, endpoint'e ulaşabilen herkesin orada indekslenmiş her şeyi okuduğu
  anlamına gelir; token required bir bearer token gerektirir — bu bir hesap değil, endpoint için bir
  kimlik bilgisidir; account required ise projenin kendi üyeliklerini OAuth 2.1 üzerinden her istekte
  denetler. Bkz. [Güvenlik](/tr/docs/security/).
- **Paylaşılan bir parola değil, hesaplar.** Herkes kendisi olarak oturum açar; `root` ve `admin` her
  projeye ulaşır, bir `member` ise yalnızca eklediğiniz projelere, izleyici ya da editör olarak ulaşır.
  Bkz. [Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/).
- **Varsayılan olarak %100 yerel.** Gömme işlemi CPU'nuzda çalışır. API anahtarı yok, başka biriyle
  hesap yok, makineden hiçbir şey çıkmaz. Tercih ederseniz iki ortam değişkeniyle OpenAI gömmelerine
  geçin.
- **Çok dilli.** Varsayılan model Türkçe dahil 100 dili kapsar. Soruyu cevabın yazıldığı dilde sorun:
  diller arası eşleşme ölçülmüş bir model sınırıdır, açılıp kapanan bir ayar değil.
- **Tek konteyner.** PostgreSQL ve uygulama tek bir imajda birlikte gelir. Kurulacak bir veritabanı ve
  çalıştırılacak bir migration yoktur.
- **Markdown'dan fazlası.** Markdown, MDX ve düz metin oldukları gibi indekslenir; HTML, Word, CSV ve
  PDF kenarda Markdown'a çevrilir ve bir OpenAPI ya da Swagger spesifikasyonu operasyon başına bir
  belgeye dönüşür. OCR yoktur: taranmış bir PDF yarım indekslenmek yerine adıyla reddedilir.
- **Artımlı.** Dosyalar hash'lenir; bir yeniden indeksleme yalnızca gerçekten değişeni yeniden gömer.
- **Eski ve yeni istemcilerle çalışır.** Her iki MCP transport'u da aynı URL üzerinden sunulur, bu
  yüzden istemciler herhangi bir yapılandırma olmadan hangisini destekliyorlarsa onu seçer.

---

## Buradan başlayın

| Ne yapmak istiyorum… | Sayfa |
|------------|------|
| On dakikada çalışır ve bağlı hale getirmek | **[Hızlı Başlangıç](/tr/docs/quick-start/)** |
| Düzgünce kurmak (Compose, sade `docker run`, kendiniz derlemek, ya da kaynaktan) | [Kurulum](/tr/docs/installation/) |
| Her ayarı anlamak | [Yapılandırma](/tr/docs/configuration/) |
| Panoda yolumu öğrenmek | [Pano Turu](/tr/docs/dashboard-tour/) |
| Takımıma hesap vermek ve kimin neyi göreceğine karar vermek | [Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/) |
| Bir yerden dokümantasyon eklemek | [Belge Kaynakları](/tr/docs/document-sources/) |
| Claude Code / Cursor / Claude Desktop'ı bağlamak | [Yapay Zekâ İstemcilerini Bağlamak](/tr/docs/connecting-ai-clients/) |
| Ajanın gerçekte ne yapabileceğini bilmek | [MCP Araçları](/tr/docs/mcp-tools/) |
| Çalışmayan bir şeyi düzeltmek | [Sorun Giderme](/tr/docs/troubleshooting/) |

## Kaynaklar

| Kaynak | Sayfa |
|--------|------|
| Sunucuda bağlanmış bir klasör | [Yerel Klasör Kaynağı](/tr/docs/local-directory-source/) |
| Bir git deposu (GitHub, GitLab, Bitbucket, Gitea…) | [Git Deposu Kaynağı](/tr/docs/git-repository-source/) |
| Yüklediğiniz dosyalar, klasörler ve arşivler | [Yükleme Kaynağı](/tr/docs/upload-source/) |
| Bir Obsidian vault'u | [Obsidian Vault'ları](/tr/docs/obsidian-vaults/) |
| Bir Notion workspace'i | [Notion](/tr/docs/notion/) |

## Daha derine

[İndeksleme](/tr/docs/indexing/) · [Gömme Modelleri](/tr/docs/embedding-models/) ·
[İçerik Türleri](/tr/docs/content-types/) · [Push Webhook'ları](/tr/docs/push-webhooks/) ·
[Admin API](/tr/docs/admin-api/) · [Hesaplar ve İzinler](/tr/docs/accounts-and-permissions/) ·
[Güvenlik](/tr/docs/security/) · [Yedekleme ve Veri](/tr/docs/backup-and-data/) ·
[SSS](/tr/docs/faq/)

---

*Contextator, [GNU AGPL v3 ya da sonrası](/tr/docs/faq/) altında özgür yazılımdır — çalıştırın,
değiştirin, paylaşın; başkalarının ağ üzerinden erişmesine izin verdiğiniz değiştirilmiş bir sürüm,
onlara kaynağını borçludur. Bu şartlar size uymuyorsa ticari bir lisans da mevcuttur.*
