# 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-10-30
- 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, bir Confluence sitesi, yayımlanmış bir dokümantasyon sitesi, bir S3 bucket'ı, bir Google Drive klasörü, bir GitHub issue takipçisi — 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 *ve* bir Confluence sitesi *ve* bir web sitesi *ve* bir S3 bucket'ı *ve* Google Drive *ve* GitHub issue'ları — 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. (`-slim` varyantı PostgreSQL'i dışarıda bırakır ve `DATABASE_URL` ile sizin kendi PostgreSQL'inizi kullanır.)
- **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.** Bağlanmanın yolu Streamable HTTP'dir; eski HTTP+SSE transport'u
  eski istemciler için aynı URL üzerinde hâlâ sunulur, kullanımdan kaldırılmıştır ve yapılandırılacak bir
  şey yoktur.

---

## 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/) |
| Bir Confluence sitesi (Cloud ya da Data Center) | [Confluence](/tr/docs/confluence/) |
| Yayımlanmış bir dokümantasyon sitesi | [Dokümantasyon Sitesi Kaynağı](/tr/docs/documentation-site-source/) |

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