Dokümanlar
Contextator’ı çalıştırmak, bağlamak ve yönetmekle ilgili her şey tek yerde.
Başlangıç
- ContextatorModel 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.
- Hızlı BaşlangıçDokümantasyonunuzla ilgili soruları yanıtlayan bir ajana sıfırdan ulaşmak — Docker Compose, bir proje, bağlanan bir istemci, baştan sona yaklaşık on dakika.
- KurulumContextator'ı çalıştırmanın her yolu — Docker Compose, sade docker run, imajı kendiniz derlemek ya da kaynaktan — üstelik ilk hesap ve reverse proxy kurulumuyla.
- YapılandırmaContextator'ın okuduğu her ortam değişkeni — sunucu, hesaplar, veritabanı, depolama, belgeler, yüklemeler, gömme, arama, senkronizasyon, gözlemlenebilirlik, reverse proxy.
- Pano TuruContextator panosunda rehberli bir tur — oturum açmak, hesap menüsü, üst çubuk, proje listesi ve ayrıntısı, klavye kısayolları, footer ve Users sayfası.
Kaynaklar
- ProjelerHer şeyin ait olduğu birim — bir proje nasıl oluşturulur, MCP erişimi nasıl kontrol edilir, durumları nasıl okunur, nasıl yeniden indekslenir ya da silinir.
- Belge KaynaklarıBir projenin taşıyabileceği altı kaynak türü, her yolun önüne eklenen mount adı, ve hepsinde senkronizasyonun ve hataların nasıl işlediği.
- Yerel Klasör KaynağıSunucuda zaten var olan bir klasörün olduğu yerde indekslenmesi, allowed-roots güvenlik sınırı, ve neyin tarandığı ve atlandığı.
- Git Deposu KaynağıBir git deposundan doğrudan dokümantasyon indekslemek — özel depolar, sağlayıcı token'ları, senkronizasyonun ve push tetiklemeli yeniden indekslemenin nasıl çalıştığı.
- Yükleme KaynağıBaşka bir yeri olmayan dokümantasyon için panoya dosya, klasör ve arşiv sürüklemek, ve bunun sınırları.
- Obsidian Vault'larıBir Obsidian vault'unu bir local directory ya da upload olarak indekslemek, ve tam olarak hangi wikilink ve callout söz diziminin önce yeniden yazıldığı.
- NotionAPI üzerinden bir Notion çalışma alanını indekslemek — bir integration oluşturmak, sayfaları paylaşmak, neyin içeri alındığı, ve dışa aktarım zip alternatifi.
- ConfluenceConfluence Cloud ya da Data Center'ı indekslemek — dağıtım farkları, token türleri, özel adres sınırı ve Data Center webhook'u.
- Dokümantasyon Sitesi KaynağıHerkese açık bir sitenin sitemap'ini, llms.txt'ini ya da bir crawl'ını indekslemek — algılama, beş tavan, robots.txt ve tazelik kontrolü.
- İçerik TürleriBir kaynağın seçebileceği dört içerik türü çeşidi — plain, Obsidian vault, Notion export ve OpenAPI/Swagger — ve her biri chunk'lamadan önce neyi dönüştürür.
İşletim
- İndekslemeBir indeksleme çalışmasında ne olur, değişmemiş bir projeyi yeniden indekslemek neden hiçbir şeyi gömmez, belgeler nasıl parçalanır ve indeksleme sürerken neler reddedilir.
- Gömme ModelleriVarsayılan local model, OpenAI'a geçiş, modeli güvenle değiştirmek, arama sonuçlarının nasıl puanlandığı ve tamamen air-gapped çalıştırma.
- Yapay Zekâ İstemcilerini BağlamakClaude Code, Cursor, Claude Desktop ve diğer her MCP istemcisi için yapıştırmaya hazır kurulum; ayrıca token'lar, uzaktan erişim ve bir endpoint'i ajansız doğrulama.
- MCP AraçlarıHer projenin yayınladığı üç salt okunur araç — search_docs, list_topics ve read_document — argümanları, limitleri ve yapamadıkları.
- Push Webhook'larıGitHub, GitLab, Gitea, Bitbucket ve Confluence Data Center için kaynak başına push webhook kurmak, teslimatta ne olduğu ve bir secret'ı rotate etmek.
- Kubernetes Üzerinde ÇalıştırmaHelm chart'ının kurulumu — veritabanı ve SECRET_KEY yönetimi, ingress, kalıcılık, probe'lar, security context, kaynak boyutlandırma ve kaldırma.
Yönetim ve güvenlik
- Admin APIPanonun kendi JSON REST API'si — kimlik doğrulama, SSO, projeler, arama, kaynaklar, üyeler, MCP tokenları, webhook'lar, metrikler, audit log ve paylaşılan hata biçimleri.
- Hesaplar ve İzinlerPanoda oturum açmanın, rollerin, proje üyeliğinin, parolaların ve oturumların nasıl işlediği — ve kimse oturum açamadığında ne yapılacağı.
- GüvenlikContextator'ın tehdit modeli — yeni bir projenin MCP endpoint'i varsayılan olarak token gerektirir, ama açık'a çevrilebilir — ve onu kilitlemek için operatör kontrol listesi.
- Yedekleme ve VeriContextator'ın veritabanını, modellerini ve somutlaştırılmış kaynaklarını nerede sakladığı ve yerleşik yedekleme/geri yükleme komutunun bir arşivi nasıl aldığı ve denetlediği.
- Sorun GidermeBaşlangıç, oturum açma, kaynak, indeksleme ve arama sorunları için tam hata mesajları, nedenleri ve çözümleriyle eşleştirilmiş.
- SSSVeri, hesaplar, kaynaklar, MCP endpoint'i, indeksleme ve AGPL lisansı hakkında kısa, kendi içinde tamam cevaplar.
- Tek Oturum AçmaOIDC üzerinden federe oturum açma — etkinleştirme, otomatik hesap oluşturma, kendi hesabınızı bağlama ile bağlantısını kesme ve root'u yalnız yerel tutan korumalar.