Azure Cosmos DB MCP Toolkit Generally Available: AI Agent'lar Veritabanınıza Doğrudan Bağlanıyor - IT Logs

Azure Cosmos DB MCP Toolkit, 2 Haziran 2026 itibarıyla generally available (v1.1.2) duruma geçti. Ignite 2025’te preview olarak duyurulan toolkit, AI agent’ların Cosmos DB veritabanlarına güvenli şekilde erişmesini sağlayan açık kaynaklı bir Model Context Protocol (MCP) sunucusu.

Ne yapıyor?

Toolkit, AI agent’larının veritabanıyla etkileşim kurabilmesi için sekiz MCP tool’u sunuyor:

list_databases: Hesaptaki tüm veritabanlarını listeler
list_collections: Veritabanı içindeki container’ları gezer
get_recent_documents: Zaman damgalı dokümanları çeker
find_document_by_id: ID ile doğrudan doküman bulur
text_search: CONTAINS ile property-value araması yapar
vector_search: Embedding’lerle semantic search
get_approximate_schema: Container şemasını örnekleyip çıkarsar

Vector search ve embedding desteği

Vector search için multi-provider embedding desteği var:

Azure AI Services (Cognitive Services endpoint’leri)
Azure AI Foundry project endpoint’leri
OpenAI native API

URL pattern’ine göre endpoint otomatik tespit ediliyor; manuel yapılandırma gerekmiyor.

Güvenlik modeli

Enterprise-grade bir security modeli kurulmuş:

Entra ID kimlik doğrulama
Role-based access control (RBAC)
Managed identity desteği

Role tarafından reddedilen operasyonlar için generic hata yerine düzgün 403 JSON-RPC yanıtı dönüyor.

Kurulum

git clone https://github.com/AzureCosmosDB/MCPToolKit.git
cp .env.example .env
dotnet run

Yapılandırma için Cosmos DB connection bilgileri, embedding endpoint (Azure AI Services, Foundry veya OpenAI) ve kimlik doğrulama bilgileri gerekiyor.

Hangi client’larla çalışıyor?

Microsoft Foundry: Katalogdan doğrudan entegrasyon
MCP protokolüyle uyumlu generic client’lar (HTTP transport, /mcp endpoint)
MCP protokolünü destekleyen AI agent’lar

Pratik senaryolar

Support agent: find_document_by_id ile sipariş durumunu çekiyor, shipping bilgilerine erişiyor ve kullanıcıya kişiselleştirilmiş yanıt veriyor.

RAG knowledge base: vector_search ile semantic article retrieval yapıyor, birden fazla kaynaktan yanıt sentezliyor ve atıflar üretiyor.

Preview’dan GA’ya neler değişti?

v1.1.2 GA release’i üç alana odaklanmış: esneklik, güvenilirlik ve geliştirici deneyimi.

Role assignment PowerShell script’leri düzeltildi
Yapılandırılmış error handling eklendi
Foundry parameter handling düzeltildi
Erken startup validation, anlaşılır hata mesajları
MCP HTTP transport düzgün şekilde register ediliyor
Web UI ve SDK endpoint’leri bir arada çalışıyor

AI agent’ları üretim veritabanlarına bağlama ihtiyacı giderek artıyor. Custom kod yazmak, güvenlik açıklarına sebep olmak veya provider lock-in’e takılmak yerine bu tür standardize bir araç kullanmak ekiplerin işini kolaylaştırıyor. Açık kaynak olması ve Entra ID + RBAC ile entegrasyonu da kurumsal senaryolar için uygun bir altyapı sunuyor.

Kaynak: https://devblogs.microsoft.com/cosmosdb/azure-cosmos-db-mcp-toolkit-is-now-generally-available-bringing-your-database-to-ai-agents-at-scale/