MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Bu kaynakları kullanmaya başlamak için aşağıdaki adımları takip edin:

  1. Depoyu Çatallayın: GitHub forks bağlantısına tıklayın.
  2. Depoyu Klonlayın: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Azure AI Foundry Discord’a katılın ve uzmanlarla, diğer geliştiricilerle tanışın

🌐 Çok Dilli Destek

GitHub Action ile Desteklenir (Otomatik ve Her Zaman Güncel)

Arapça | Bengalce | Bulgarca | Burma (Myanmar) | Çince (Basitleştirilmiş) | Çince (Geleneksel, Hong Kong) | Çince (Geleneksel, Macau) | Çince (Geleneksel, Tayvan) | Hırvatça | Çekçe | Danca | Felemenkçe | Fince | Fransızca | Almanca | Yunanca | İbranice | Hintçe | Macarca | Endonezce | İtalyanca | Japonca | Korece | Malayca | Marathi | Nepalce | Norveççe | Farsça | Lehçe | Portekizce (Brezilya) | Portekizce (Portekiz) | Pencapça (Gurmukhi) | Romence | Rusça | Sırpça (Kiril) | Slovakça | Slovence | İspanyolca | Swahili | İsveççe | Tagalog (Filipince) | Tayca | Türkçe | Ukraynaca | Urduca | Vietnamca

🚀 Model Context Protocol (MCP) Başlangıç Müfredatı

C#, Java, JavaScript, Rust, Python ve TypeScript ile MCP’yi Kod Örnekleriyle Öğrenin

🧠 Model Context Protocol Müfredatına Genel Bakış

Model Context Protocol (MCP), yapay zeka modelleri ile istemci uygulamaları arasındaki etkileşimleri standartlaştırmak için tasarlanmış ileri teknoloji bir çerçevedir. Bu açık kaynaklı müfredat, C#, Java, JavaScript, TypeScript ve Python gibi popüler programlama dillerinde pratik kod örnekleri ve gerçek dünya kullanım senaryolarıyla yapılandırılmış bir öğrenme yolu sunar.

İster bir yapay zeka geliştiricisi, sistem mimarı, ister bir yazılım mühendisi olun, bu rehber MCP’nin temel prensiplerini ve uygulama stratejilerini öğrenmek için kapsamlı bir kaynaktır.

🔗 Resmi MCP Kaynakları

🧭 MCP Müfredatına Genel Bakış

📚 Tam Müfredat Yapısı

ModülKonuAçıklamaBağlantı
Modül 1-3: Temel Bilgiler
00MCP’ye GirişModel Context Protocol’ün genel bakışı ve yapay zeka süreçlerindeki önemiDaha fazla oku
01Temel Kavramlar AçıklanıyorMCP’nin temel kavramlarının detaylı incelemesiDaha fazla oku
02MCP’de GüvenlikGüvenlik tehditleri ve en iyi uygulamalarDaha fazla oku
03MCP ile BaşlangıçOrtam kurulumu, temel sunucular/istemciler, entegrasyonDaha fazla oku
Modül 3: İlk Sunucu ve İstemciyi Oluşturma
3.1İlk Sunucuİlk MCP sunucunuzu oluşturunRehber
3.2İlk İstemciTemel bir MCP istemcisi geliştirinRehber
3.3LLM ile İstemciBüyük dil modellerini entegre edinRehber
3.4VS Code EntegrasyonuMCP sunucularını VS Code’da kullanınRehber
3.5stdio Sunucustdio taşıma yöntemiyle sunucular oluşturunRehber
3.6HTTP AkışıMCP’de HTTP akışını uygulayınRehber
3.7AI Araç SetiMCP ile AI Araç Setini kullanınRehber
3.8TestMCP sunucu uygulamanızı test edinRehber
3.9DağıtımMCP sunucularını üretime dağıtınRehber
3.10Gelişmiş sunucu kullanımıGelişmiş özellikler ve iyileştirilmiş mimari için gelişmiş sunucular kullanınRehber
3.11Basit kimlik doğrulamaKimlik doğrulama ve RBAC’ı baştan gösteren bir bölümRehber
Modül 4-5: Pratik ve İleri Düzey
04Pratik UygulamaSDK’lar, hata ayıklama, test etme, yeniden kullanılabilir istem şablonlarıDaha fazla oku
05MCP’de İleri Düzey KonularÇok modlu yapay zeka, ölçekleme, kurumsal kullanımDaha fazla oku
5.1Azure EntegrasyonuMCP’nin Azure ile entegrasyonuRehber
5.2Çok ModlulukBirden fazla mod ile çalışmaRehber
5.3OAuth2 DemoOAuth2 kimlik doğrulamasını uygulayınRehber
5.4Kök BağlamlarKök bağlamları anlayın ve uygulayınRehber
5.5YönlendirmeMCP yönlendirme stratejileriRehber
5.6ÖrneklemeMCP’deki örnekleme teknikleriRehber
5.7ÖlçeklemeMCP uygulamalarını ölçeklendirinRehber
5.8Güvenlikİleri düzey güvenlik hususlarıRehber
5.9Web AramaWeb arama yeteneklerini uygulayınRehber
5.10Gerçek Zamanlı AkışGerçek zamanlı akış işlevselliği oluşturunRehber
5.11Gerçek Zamanlı AramaGerçek zamanlı arama uygulayınRehber
5.12Entra ID Kimlik DoğrulamaMicrosoft Entra ID ile kimlik doğrulamaRehber
5.13Foundry EntegrasyonuAzure AI Foundry ile entegrasyonRehber
5.14Bağlam MühendisliğiEtkili bağlam mühendisliği teknikleriRehber
5.15MCP Özel TaşımaÖzel Taşıma uygulamalarıRehber
Modül 6-10: Topluluk ve En İyi Uygulamalar
06Topluluk KatkılarıMCP ekosistemine nasıl katkıda bulunabilirsinizRehber
07Erken Benimseme DeneyimleriGerçek dünya uygulama hikayeleriRehber
08MCP için En İyi UygulamalarPerformans, hata toleransı, dayanıklılıkRehber
09MCP Vaka ÇalışmalarıPratik uygulama örnekleriRehber
10Uygulamalı Atölye ÇalışmasıAI Araç Seti ile bir MCP Sunucusu oluşturmaLaboratuvar
Modül 11: MCP Sunucu Uygulamalı Laboratuvar
11MCP Sunucu Veritabanı EntegrasyonuPostgreSQL entegrasyonu için kapsamlı 13 laboratuvarlık öğrenme yoluLaboratuvarlar
11.1GirişMCP’nin veritabanı entegrasyonu ve perakende analitiği kullanım senaryosu hakkında genel bakışLaboratuvar 00
11.2Çekirdek MimariMCP sunucu mimarisini, veri tabanı katmanlarını ve güvenlik desenlerini anlamaLab 01
11.3Güvenlik ve Çoklu KiracılıkSatır Düzeyi Güvenlik, kimlik doğrulama ve çoklu kiracı veri erişimiLab 02
11.4Ortam KurulumuGeliştirme ortamı, Docker ve Azure kaynaklarını kurmaLab 03
11.5Veri Tabanı TasarımıPostgreSQL kurulumu, perakende şema tasarımı ve örnek veriLab 04
11.6MCP Sunucu UygulamasıVeri tabanı entegrasyonu ile FastMCP sunucusu oluşturmaLab 05
11.7Araç GeliştirmeVeri tabanı sorgu araçları ve şema inceleme oluşturmaLab 06
11.8Anlamsal AramaAzure OpenAI ve pgvector ile vektör gömme uygulamaLab 07
11.9Test ve Hata AyıklamaTest stratejileri, hata ayıklama araçları ve doğrulama yaklaşımlarıLab 08
11.10VS Code EntegrasyonuVS Code MCP entegrasyonunu yapılandırma ve AI Chat kullanımıLab 09
11.11Dağıtım StratejileriDocker dağıtımı, Azure Container Apps ve ölçeklendirme dikkate alınması gerekenlerLab 10
11.12İzlemeApplication Insights, günlük kaydı, performans izlemeLab 11
11.13En İyi UygulamalarPerformans optimizasyonu, güvenlik güçlendirme ve üretim ipuçlarıLab 12

💻 Örnek Kod Projeleri

Temel MCP Hesaplayıcı Örnekleri

DilAçıklamaBağlantı
C#MCP Sunucu ÖrneğiKodu Görüntüle
JavaMCP HesaplayıcıKodu Görüntüle
JavaScriptMCP DemoKodu Görüntüle
PythonMCP SunucuKodu Görüntüle
TypeScriptMCP ÖrneğiKodu Görüntüle
RustMCP ÖrneğiKodu Görüntüle

Gelişmiş MCP Uygulamaları

DilAçıklamaBağlantı
C#Gelişmiş ÖrnekKodu Görüntüle
Java ve SpringContainer App ÖrneğiKodu Görüntüle
JavaScriptGelişmiş ÖrnekKodu Görüntüle
PythonKarmaşık UygulamaKodu Görüntüle
TypeScriptContainer ÖrneğiKodu Görüntüle

🎯 MCP Öğrenmek İçin Ön Koşullar

Bu müfredattan en iyi şekilde yararlanmak için aşağıdaki bilgilere sahip olmalısınız:

  • C#, Java, JavaScript, Python veya TypeScript dillerinden en az birinde temel programlama bilgisi

  • İstemci-sunucu modeli ve API’ler hakkında bilgi

  • REST ve HTTP kavramlarına aşinalık

  • (Opsiyonel) AI/ML kavramları hakkında temel bilgi

  • Destek için topluluk tartışmalarımıza katılmak

📚 Çalışma Kılavuzu ve Kaynaklar

Bu depo, etkili bir şekilde gezinmenize ve öğrenmenize yardımcı olacak çeşitli kaynaklar içerir:

Çalışma Kılavuzu

Bu depoyu etkili bir şekilde kullanmanıza yardımcı olacak kapsamlı bir Çalışma Kılavuzu mevcuttur. Kılavuz şunları içerir:

  • Ele alınan tüm konuları gösteren görsel bir müfredat haritası
  • Her depo bölümünün ayrıntılı bir dökümü
  • Örnek projeleri nasıl kullanacağınız hakkında rehberlik
  • Farklı beceri seviyeleri için önerilen öğrenme yolları
  • Öğrenme yolculuğunuzu tamamlayacak ek kaynaklar

Değişiklik Günlüğü

Müfredat materyallerindeki tüm önemli güncellemeleri izleyen ayrıntılı bir Değişiklik Günlüğü tutuyoruz:

  • Yeni içerik eklemeleri
  • Yapısal değişiklikler
  • Özellik iyileştirmeleri
  • Dokümantasyon güncellemeleri

🛠️ Bu Müfredatı Etkili Bir Şekilde Kullanma

Bu rehberdeki her ders şunları içerir:

  1. MCP kavramlarının açık açıklamaları
  2. Birden fazla dilde canlı kod örnekleri
  3. Gerçek MCP uygulamaları oluşturmak için alıştırmalar
  4. İleri düzey öğreniciler için ek kaynaklar

Etkinlikler

MCP Geliştirici Günleri Temmuz 2025

➡️Talep Üzerine İzle - MCP Geliştirici Günleri

AI modelleri ve bunların dayandığı araçlar arasında köprü kuran yeni standart Model Context Protocol (MCP) üzerine odaklanan sanal bir etkinlikte, iki gün boyunca derin teknik bilgiler, topluluk bağlantısı ve uygulamalı öğrenmeye hazır olun. MCP Geliştirici Günlerini izlemek için etkinlik sayfamızdan kayıt olabilirsiniz: https://aka.ms/mcpdevdays.

1. Gün: MCP Verimliliği, Geliştirici Araçları ve Topluluk:

Geliştiricilerin MCP’yi iş akışlarında kullanmalarını güçlendirmek ve harika MCP topluluğunu kutlamak üzerine. Arcade, Block, Okta ve Neon gibi topluluk üyeleri ve ortaklarla birlikte Microsoft’un açık, genişletilebilir bir MCP ekosistemi oluşturmak için nasıl iş birliği yaptığını göreceğiz.
Gerçek dünya demoları: VS Code, Visual Studio, GitHub Copilot ve popüler topluluk araçları
Pratik, bağlam odaklı geliştirici iş akışları
Topluluk liderliğinde oturumlar ve içgörüler
MCP ile yeni başlıyor veya zaten onunla çalışıyorsanız, 1. Gün ilham ve uygulanabilir çıkarımlarla sahneyi hazırlayacak.

2. Gün: MCP Sunucularını Güvenle Oluşturun

MCP geliştiricileri için. MCP sunucuları oluşturma ve MCP’yi AI iş akışlarınıza entegre etme stratejileri ve en iyi uygulamalar üzerine derinlemesine bir inceleme.

Konular şunları içerir:

  • MCP Sunucuları oluşturma ve bunları ajan deneyimlerine entegre etme
  • İstek odaklı geliştirme
  • Güvenlik en iyi uygulamaları
  • Functions, ACA ve API Management gibi yapı taşlarını kullanma
  • Kayıt hizalama ve araçlar (1P + 3P)

Bir geliştirici, araç oluşturucu veya AI ürün stratejistiyseniz, bu gün ölçeklenebilir, güvenli ve geleceğe hazır MCP çözümleri oluşturmak için ihtiyaç duyduğunuz içgörülerle dolu.

MCP Boot Camp Ağustos 2025

MCP sunucuları oluşturmayı, VS Code ile entegrasyonu ve Azure’da profesyonel olarak dağıtmayı öğrenmek için MCP için Başlangıç müfredatından içeriklere dayalı yoğun video oturumlarında eğitim alın. Büyük şirketlerin zaten kullandığı bir teknoloji hakkında pratik becerilerle ayrılın.

➡️Talep Üzerine İzle MCP Bootcamp | İngilizce

➡️Talep Üzerine İzle MCP Bootcamp | Brezilya

➡️Talep Üzerine İzle MCP Bootcamp | İspanyolca

C# ile MCP Öğrenelim - Eğitim Serisi

Model Context Protocol (MCP), AI modelleri ve istemci uygulamaları arasındaki etkileşimleri standartlaştırmak için tasarlanmış son teknoloji bir çerçeve hakkında bilgi edinelim. Bu başlangıç dostu oturumda, MCP’yi tanıtacağız ve ilk MCP sunucunuzu oluşturmanızda size rehberlik edeceğiz.

C#: https://aka.ms/letslearnmcp-csharp

Java: https://aka.ms/letslearnmcp-java

JavaScript: https://aka.ms/letslearnmcp-javascript

Python: https://aka.ms/letslearnmcp-python

🌟 Topluluk Teşekkürü

Önemli kod örnekleri katkılarından dolayı Microsoft Değerli Profesyonel Shivam Goyal teşekkür ederiz.

📜 Lisans Bilgileri

Bu içerik MIT Lisansı altında lisanslanmıştır. Şartlar ve koşullar için LICENSE dosyasına bakın.

🤝 Katkı Rehberi

Bu proje katkılara ve önerilere açıktır. Çoğu katkı, bir Katkı Lisans Sözleşmesi (CLA) imzalamanızı gerektirir. Bu sözleşme, katkınızı kullanma hakkına sahip olduğunuzu ve bu hakkı bize verdiğinizi beyan eder. Ayrıntılar için https://cla.opensource.microsoft.com adresini ziyaret edin.

Bir pull request gönderdiğinizde, bir CLA botu otomatik olarak bir CLA sağlayıp sağlamanız gerekip gerekmediğini belirleyecek ve PR’ı uygun şekilde süsleyecektir (örneğin, durum kontrolü, yorum). Bot tarafından sağlanan talimatları takip edin. Tüm depolarımızda CLA’yı yalnızca bir kez yapmanız gerekecek.

Bu proje Microsoft Açık Kaynak Davranış Kuralları benimsemiştir. Daha fazla bilgi için Davranış Kuralları SSS adresine bakın veya opencode@microsoft.com adresine ek sorular veya yorumlar gönderin.

📂 Depo Yapısı

Depo şu şekilde organize edilmiştir:

  • Çekirdek Müfredat (00-11): PostgreSQL entegrasyon laboratuvarlarını içeren on bir ardışık modülde düzenlenmiş ana içerik
  • 11-MCPServerHandsOnLabs/: PostgreSQL entegrasyonu ile üretime hazır MCP sunucuları oluşturmak için eksiksiz 13-laboratuvar öğrenme yolu
  • images/: Müfredat boyunca kullanılan diyagramlar ve illüstrasyonlar
  • translations/: Otomatik çevirilerle çok dilli destek
  • translated_images/: Diyagramların ve illüstrasyonların yerelleştirilmiş versiyonları
  • study_guide.md: Depoyu gezinmek için kapsamlı rehber
  • changelog.md: Müfredat materyallerindeki tüm önemli değişikliklerin kaydı
  • mcp.json: MCP spesifikasyonu için yapılandırma dosyası
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Proje yönetim belgeleri

🎒 Diğer Kurslar

Ekibimiz başka kurslar da üretiyor! Göz atın:

™️ Ticari Marka Bildirimi

Bu proje, projeler, ürünler veya hizmetler için ticari markalar veya logolar içerebilir. Microsoft ticari markalarının veya logolarının yetkili kullanımı, Microsoft’un Ticari Marka ve Marka Yönergeleri ile uyumlu olmalı ve bu yönergeleri takip etmelidir. Bu projenin değiştirilmiş versiyonlarında Microsoft ticari markalarının veya logolarının kullanımı, karışıklığa yol açmamalı veya Microsoft sponsorluğunu ima etmemelidir. Üçüncü taraf ticari markalarının veya logolarının kullanımı, ilgili üçüncü tarafların politikalarına tabidir.

Yardım Alma

Eğer takılırsanız veya yapay zeka uygulamaları oluşturma konusunda sorularınız olursa, şu topluluğa katılın:

Azure AI Foundry Discord

Eğer ürünle ilgili geri bildirimde bulunmak veya hata yaşarsanız, şu adresi ziyaret edin:

Azure AI Foundry Developer Forum


Feragatname:
Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayın. Belgenin orijinal dili, yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımından kaynaklanan yanlış anlamalar veya yanlış yorumlamalar için sorumluluk kabul etmiyoruz.