Bu çalışma rehberi, "Yeni Başlayanlar için Model Bağlam Protokolü (MCP)" müfredatının depo yapısı ve içeriğine genel bir bakış sunar. Depoyu verimli bir şekilde gezmek ve mevcut kaynaklardan en iyi şekilde yararlanmak için bu rehberi kullanın.
Model Bağlam Protokolü (MCP), AI modelleri ile istemci uygulamalar arasındaki etkileşimler için standartlaştırılmış bir çerçevedir. Başlangıçta Anthropic tarafından oluşturulan MCP, artık resmi GitHub organizasyonu aracılığıyla daha geniş MCP topluluğu tarafından sürdürülebilmektedir. Bu depo, AI geliştiricileri, sistem mimarları ve yazılım mühendisleri için C#, Java, JavaScript, Python ve TypeScript dillerinde uygulamalı kod örnekleri içeren kapsamlı bir müfredat sunar.
mindmap
root((Yeni Başlayanlar için MCP))
00. Giriş
::icon(fa fa-book)
(Protokol Genel Bakış)
(Standardizasyonun Faydaları)
(Gerçek Dünya Kullanım Durumları)
(Yapay Zeka Entegrasyonu Temelleri)
01. Temel Kavramlar
::icon(fa fa-puzzle-piece)
(İstemci-Sunucu Mimarisi)
(Protokol Bileşenleri)
(Mesajlaşma Kalıpları)
(Taşıma Mekanizmaları)
(Görevler - Deneysel)
(Araç Açıklamaları)
02. Güvenlik
::icon(fa fa-shield)
(Yapay Zeka'ya Özel Tehditler)
(En İyi Uygulamalar 2025)
(Azure İçerik Güvenliği)
(Kimlik Doğrulama ve Yetkilendirme)
(Microsoft Komut Kalkanları)
(OWASP MCP İlk 10)
(Sherpa Güvenlik Atölyesi)
03. Başlangıç
::icon(fa fa-rocket)
(İlk Sunucu Uygulaması)
(İstemci Geliştirme)
(LLM İstemci Entegrasyonu)
(VS Code Uzantıları)
(SSE Sunucu Kurulumu)
(HTTP Akışı)
(Yapay Zeka Araç Seti Entegrasyonu)
(Test Çerçeveleri)
(Gelişmiş Sunucu Kullanımı)
(Basit Kimlik Doğrulama)
(Dağıtım Stratejileri)
(MCP Barındırıcıları Kurulumu)
(MCP İnceleyici)
04. Pratik Uygulama
::icon(fa fa-code)
(Çok Dilli SDK'lar)
(Test ve Hata Ayıklama)
(Komut Şablonları)
(Örnek Projeler)
(Üretim Kalıpları)
(Sayfalama Stratejileri)
05. İleri Konular
::icon(fa fa-graduation-cap)
(Bağlam Mühendisliği)
(Foundry Ajan Entegrasyonu)
(Çok Modlu Yapay Zeka İş Akışları)
(OAuth2 Kimlik Doğrulaması)
(Gerçek Zamanlı Arama)
(Akış Protokolleri)
(Kök Bağlamlar)
(Yönlendirme Stratejileri)
(Örnekleme Teknikleri)
(Ölçeklendirme Çözümleri)
(Güvenlik Sertleştirme)
(Entra ID Entegrasyonu)
(Web Arama MCP)
(Protokol Özellikleri Derinlemesine İnceleme)
06. Topluluk
::icon(fa fa-users)
(Kod Katkıları)
(Dokümantasyon)
(MCP İstemci Ekosistemi)
(MCP Sunucu Kayıt Defteri)
(Görüntü Oluşturma Araçları)
(GitHub İşbirliği)
07. Erken Benimseme
::icon(fa fa-lightbulb)
(Üretim Dağıtımları)
(Microsoft MCP Sunucuları)
(Azure MCP Servisi)
(Kurumsal Vaka Çalışmaları)
(Gelecek Yol Haritası)
08. En İyi Uygulamalar
::icon(fa fa-check)
(Performans Optimizasyonu)
(Hata Toleransı)
(Sistem Dayanıklılığı)
(İzleme ve Gözlemlenebilirlik)
09. Vaka Çalışmaları
::icon(fa fa-file-text)
(Azure API Yönetimi)
(Yapay Zeka Seyahat Acentası)
(Azure DevOps Entegrasyonu)
(Dokümantasyon MCP)
(GitHub MCP Kayıt Defteri)
(VS Code Entegrasyonu)
(Gerçek Dünya Uygulamaları)
10. Uygulamalı Atölye
::icon(fa fa-laptop)
(MCP Sunucu Temelleri)
(İleri Geliştirme)
(Yapay Zeka Araç Seti Entegrasyonu)
(Üretim Dağıtımı)
(4 Atölye Yapısı)
11. Veritabanı Entegrasyon Atölyeleri
::icon(fa fa-database)
(PostgreSQL Entegrasyonu)
(Perakende Analitiği Kullanım Durumu)
(Satır Seviyesi Güvenlik)
(Anlamsal Arama)
(Üretim Dağıtımı)
(13 Atölye Yapısı)
(Uygulamalı Öğrenme)
Depo, MCP'nin farklı yönlerine odaklanan on bir ana bölüm halinde düzenlenmiştir:
-
Giriş (00-Introduction/)
- Model Bağlam Protokolü genel bakışı
- AI boru hatlarında standardizasyon neden önemlidir
- Pratik kullanım örnekleri ve faydalar
-
Temel Kavramlar (01-CoreConcepts/)
- İstemci-sunucu mimarisi
- Ana protokol bileşenleri
- MCP'deki mesajlaşma kalıpları
-
Güvenlik (02-Security/)
- MCP tabanlı sistemlerde güvenlik tehditleri
- Uygulamaların güvence altına alınması için en iyi uygulamalar
- Kimlik doğrulama ve yetkilendirme stratejileri
- Kapsamlı Güvenlik Belgeleri:
- MCP Güvenlik En İyi Uygulamaları 2025
- Azure İçerik Güvenliği Uygulama Kılavuzu
- MCP Güvenlik Kontrolleri ve Teknikleri
- MCP En İyi Uygulamalar Hızlı Referans
- Önemli Güvenlik Konuları:
- İstek enjeksiyonu ve araç zehirleme saldırıları
- Oturum kaçırma ve karışık vekil problemleri
- Jeton geçişi güvenlik açıkları
- Aşırı izinler ve erişim kontrolü
- AI bileşenleri için tedarik zinciri güvenliği
- Microsoft İstek Kalkanları entegrasyonu
-
Başlangıç (03-GettingStarted/)
- Ortam kurulumu ve yapılandırma
- Temel MCP sunucuları ve istemcileri oluşturma
- Mevcut uygulamalarla entegrasyon
- İçerdiği bölümler:
- İlk sunucu uygulaması
- İstemci geliştirme
- LLM istemci entegrasyonu
- VS Code entegrasyonu
- Sunucudan Gönderilen Olaylar (SSE) sunucusu
- Gelişmiş sunucu kullanımı
- HTTP akışı
- AI Araç Seti entegrasyonu
- Test stratejileri
- Dağıtım yönergeleri
-
Pratik Uygulama (04-PracticalImplementation/)
- Farklı programlama dillerinde SDK kullanım
- Hata ayıklama, test ve doğrulama teknikleri
- Yeniden kullanılabilir istek şablonları ve iş akışları geliştirme
- Uygulama örnekleri içeren projeler
-
İleri Konular (05-AdvancedTopics/)
- Bağlam mühendisliği teknikleri
- Foundry ajan entegrasyonu
- Çok modlu AI iş akışları
- OAuth2 kimlik doğrulama demoları
- Gerçek zamanlı arama yetenekleri
- Gerçek zamanlı akış
- Kök bağlamların uygulanması
- Yönlendirme stratejileri
- Örnekleme teknikleri
- Ölçeklendirme yaklaşımları
- Güvenlik hususları
- Entra ID güvenlik entegrasyonu
- Web arama entegrasyonu
-
Topluluk Katkıları (06-CommunityContributions/)
- Kod ve dokümantasyon katkısı yapma yolları
- GitHub üzerinden iş birliği yapma
- Topluluk tarafından yönlendirilen geliştirmeler ve geri bildirimler
- Farklı MCP istemcilerinin kullanımı (Claude Desktop, Cline, VSCode)
- Popüler MCP sunucularıyla çalışma dahil, görüntü oluşturma da dahil
-
Erken Benimseme Dersleri (07-LessonsfromEarlyAdoption/)
- Gerçek dünya uygulamaları ve başarı hikayeleri
- MCP tabanlı çözümler geliştirme ve dağıtma
- Trendler ve geleceğe dair yol haritası
- Microsoft MCP Sunucular Kılavuzu: 10 üretim hazır Microsoft MCP sunucusuna kapsamlı rehber:
- Microsoft Learn Docs MCP Sunucusu
- Azure MCP Sunucusu (15+ özel konektör)
- GitHub MCP Sunucusu
- Azure DevOps MCP Sunucusu
- MarkItDown MCP Sunucusu
- SQL Server MCP Sunucusu
- Playwright MCP Sunucusu
- Dev Box MCP Sunucusu
- Azure AI Foundry MCP Sunucusu
- Microsoft 365 Agents Toolkit MCP Sunucusu
-
En İyi Uygulamalar (08-BestPractices/)
- Performans ayarlama ve optimizasyon
- Hata toleranslı MCP sistemleri tasarlama
- Test ve dayanıklılık stratejileri
-
Vaka Analizleri (09-CaseStudy/)
- MCP'nin çok yönlülüğünü gösteren yedi kapsamlı vaka analizi:
- Azure AI Seyahat Ajanları: Azure OpenAI ve AI Arama ile çok ajanlı orkestrasyon
- Azure DevOps Entegrasyonu: YouTube veri güncellemeleriyle iş akışlarını otomatikleştirme
- Gerçek Zamanlı Dokümantasyon Getirimi: Python konsol istemcisi ile HTTP akışı
- Etkileşimli Çalışma Planı Oluşturucu: Chainlit web uygulaması ile sohbet bazlı AI
- Düzenleyicide Dokümantasyon: VS Code entegrasyonu ve GitHub Copilot iş akışları
- Azure API Yönetimi: Kurumsal API entegrasyonu ve MCP sunucu oluşturma
- GitHub MCP Kayıt Defteri: Ekosistem geliştirme ve ajan entegrasyon platformu
- Kurumsal entegrasyon, geliştirici üretkenliği ve ekosistem geliştirmeyi kapsayan örnek uygulamalar
-
Uygulamalı Atölye (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)
- MCP ile AI Araç Seti’ni birleştiren kapsamlı uygulamalı atölye
- AI modelleri ile gerçek dünya araçları arasında köprü kuran zeki uygulamalar geliştirme
- Temeller, özel sunucu geliştirme ve üretim dağıtım stratejilerini kapsayan pratik modüller
- Laboratuvar Yapısı:
- Laboratuvar 1: MCP Sunucu Temelleri
- Laboratuvar 2: Gelişmiş MCP Sunucu Geliştirme
- Laboratuvar 3: AI Araç Seti Entegrasyonu
- Laboratuvar 4: Üretim Dağıtımı ve Ölçeklendirme
- Adım adım talimatlarla laboratuvar tabanlı öğrenme yaklaşımı
-
MCP Sunucu Veritabanı Entegrasyon Laboratuvarları (11-MCPServerHandsOnLabs/)
- PostgreSQL entegrasyonlu üretim hazır MCP sunucuları için kapsamlı 13-laboratuvar öğrenme yolu
- Zava Retail kullanım senaryosu ile gerçek dünya perakende analitiği uygulaması
- Satır Seviyesi Güvenliği (RLS), anlamsal arama ve çok kiracılı veri erişimi dahil kurumsal sınıf kalıplar
- Tam Laboratuvar Yapısı:
- Laboratuvar 00-03: Temeller - Giriş, Mimari, Güvenlik, Ortam Kurulumu
- Laboratuvar 04-06: MCP Sunucusu İnşası - Veritabanı Tasarımı, MCP Sunucusu Uygulaması, Araç Geliştirme
- Laboratuvar 07-09: Gelişmiş Özellikler - Anlamsal Arama, Test & Hata Ayıklama, VS Code Entegrasyonu
- Laboratuvar 10-12: Üretim ve En İyi Uygulamalar - Dağıtım, İzleme, Optimizasyon
- Kapsanan Teknolojiler: FastMCP framework, PostgreSQL, Azure OpenAI, Azure Container Apps, Application Insights
- Öğrenim Çıktıları: Üretim hazır MCP sunucuları, veritabanı entegrasyon kalıpları, AI destekli analiz, kurumsal güvenlik
Depo destekleyici kaynaklar içerir:
- Images klasörü: Müfredat boyunca kullanılan diyagramlar ve illüstrasyonlar içerir
- Çeviriler: Dokümantasyonun otomatik çevirileriyle çok dilli destek
- Resmi MCP Kaynakları:
- Sıralı Öğrenme: Yapılandırılmış bir öğrenme deneyimi için bölümleri sırayla (00'dan 11'e) izleyin.
- Dil Bazlı Odaklanma: Belirli bir programlama diliyle ilgileniyorsanız, örnekler dizininde tercih ettiğiniz dildeki uygulamaları keşfedin.
- Pratik Uygulama: Ortamınızı kurmak ve ilk MCP sunucunuzu ve istemcinizi oluşturmak için "Başlangıç" bölümünden başlayın.
- İleri Seviye Keşif: Temellerden rahat olduğunuzda, bilgilerinizi genişletmek için ileri konulara dalın.
- Topluluk Katılımı: Deneyimli uzmanlar ve diğer geliştiricilerle bağlantı kurmak için GitHub tartışmaları ve Discord kanalları aracılığıyla MCP topluluğuna katılın.
Müfredat çeşitli MCP istemcileri ve araçlarını kapsar:
-
Resmi İstemciler:
- Visual Studio Code
- MCP, Visual Studio Code içinde
- Claude Desktop
- Claude, VSCode içinde
- Claude API
-
Topluluk İstemcileri:
- Cline (terminal tabanlı)
- Cursor (kod editörü)
- ChatMCP
- Windsurf
-
MCP Yönetim Araçları:
- MCP CLI
- MCP Manager
- MCP Linker
- MCP Router
Depo çeşitli MCP sunucuları tanıtır, bunlar arasında:
-
Resmi Microsoft MCP Sunucuları:
- Microsoft Learn Docs MCP Sunucusu
- Azure MCP Sunucusu (15+ özel konektör)
- GitHub MCP Sunucusu
- Azure DevOps MCP Sunucusu
- MarkItDown MCP Sunucusu
- SQL Server MCP Sunucusu
- Playwright MCP Sunucusu
- Dev Box MCP Sunucusu
- Azure AI Foundry MCP Sunucusu
- Microsoft 365 Agents Toolkit MCP Sunucusu
-
Resmi Referans Sunucuları:
- Filesystem
- Fetch
- Memory
- Sequential Thinking
-
Görüntü Oluşturma:
- Azure OpenAI DALL-E 3
- Stable Diffusion WebUI
- Replicate
-
Geliştirme Araçları:
- Git MCP
- Terminal Control
- Code Assistant
-
Özel Sunucular:
- Salesforce
- Microsoft Teams
- Jira & Confluence
Bu depo, topluluktan katkıları memnuniyetle karşılar. MCP ekosistemine nasıl etkili katkı yapabileceğine dair rehberlik için Topluluk Katkıları bölümüne bakın.
Bu çalışma rehberi son olarak 5 Şubat 2026'da, en güncel MCP Spesifikasyonu 2025-11-25'i yansıtarak güncellenmiş olup, belirtilen tarihteki depo genel görünümünü sunmaktadır. Depo içeriği bu tarihten sonra güncellenebilir.
Feragatname: Bu belge, AI çeviri servisi Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde kesin ve yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilmektedir. Bu çevirinin kullanılması sonucu oluşabilecek yanlış anlamalar veya yorumlardan sorumlu olmadığımızı belirtiriz.