Aracılığıyla paylaş

Azure API Management'ta MCP sunucuları hakkında

ŞUNLAR IÇIN GEÇERLIDIR: Geliştirici | Temel | Temel v2 | Standart | Standart v2 | Premium | Premium v2

Bu makalede, Azure API Management'ta Model Bağlam Protokolü (MCP) sunucularını yönetmek için kullanabileceğiniz özellikler tanıtılmaktadır. MCP sunucuları, büyük dil modellerinin (LLM) ve yapay zeka aracılarının standartlaştırılmış bir protokol aracılığıyla veritabanları veya API'ler gibi dış veri kaynaklarına erişmesine olanak tanır.

Yapay zeka aracılarının ve LLM'lerin yaygınlaşmasıyla birlikte, MCP sunucularını yönetmek giderek daha önemli hale geliyor:

  • Aracıların araçlara ve kaynaklara güvenli, kontrollü bir şekilde erişime ihtiyacı vardır.
  • Geliştiriciler mevcut API'leri aracı araçları olarak yeniden kullanmak istiyor.
  • Kuruluşların gözlemlenebilirlik, denetim ve ölçeklendirmeye ihtiyacı vardır.

GITHub Copilot, ChatGPT, Claude gibi LLM'ler ve yapay zeka aracıları için MCP sunucularını ve bunların arka uçlarını güvenli bir şekilde kullanıma açmak ve yönetmek için API Management'ı kullanın. API Management, MCP sunucusu kimlik doğrulaması, yetkilendirme ve izleme üzerinde merkezi denetim sağlar. McP sunucularının yönetimini basitleştirirken ortak güvenlik risklerini azaltmaya ve gözlemlenebilirlik, denetim ve ölçeklenebilirlik sağlamaya yardımcı olur.

MCP kavramları ve mimarisi

Gelişmiş LLM özellikleri nedeniyle yapay zeka aracıları yaygın olarak benimseniyor. Ancak en gelişmiş modeller bile dış verilerden yalıtılması nedeniyle sınırlamalarla karşı karşıya kalır. Her yeni veri kaynağında verileri ayıklamak, hazırlamak ve modeller için erişilebilir hale getirmek için özel uygulamalar gerekebilir.

Model Bağlam Protokolü bu sorunu çözmeye yardımcı olur. MCP, yapay zeka modellerini ve aracılarını yerel veri kaynakları (veritabanları veya bilgisayar dosyaları) veya uzak hizmetler (uzak veritabanları veya API'ler gibi İnternet üzerinden kullanılabilen sistemler) gibi dış veri kaynaklarına bağlamak için açık bir standarttır.

MCP, bir konak uygulamanın birden çok sunucuya bağlanabildiği istemci-sunucu mimarisini izler. MCP konağınızın veya istemcinizin bir araca ihtiyacı olduğunda, MCP sunucusuna bağlanır. MCP sunucusu daha sonra bir veritabanına veya API'ye bağlanır. MCP konakları ve sunucuları, MCP protokolü aracılığıyla birbirleriyle bağlanır.

Aşağıdaki diyagramda MCP mimarisi gösterilmektedir:

Model bağlam protokolü (MCP) mimarisinin diyagramı.

Mimari aşağıdaki bileşenlerden oluşur:

Bileşen Açıklama
MCP sunucuları Dış özelliklere erişmesi gereken IDE'lerinizdeki sohbet uygulamaları veya yapay zeka yardımcıları gibi LLM uygulamaları (Visual Studio Code'da GitHub Copilot gibi)
MCP istemcileri Ana bilgisayar uygulamasının içinde, sunucularla 1:1 bağlantılarını koruyan protokol istemcileri
MCP sunucuları Her birinin belirli özellikleri kullanıma sunduğu ve istemcilere bağlam, araçlar ve istemler sağlayan basit programlar
MCP protokolü Ortada aktarım katmanı

MCP mimarisi , mesajlaşma içinJSON-RPC 2.0 üzerine kurulmuştur. İstemciler ve sunucular arasındaki iletişim tanımlı aktarım katmanları üzerinden gerçekleşir ve öncelikli olarak iki işlem modunu destekler:

  • Uzak MCP sunucuları - HTTP tabanlı aktarımları (Streamable HTTP gibi) kullanarak İnternet üzerinden erişilebilen bağımsız işlemler olarak çalıştırarak MCP istemcilerinin her yerde barındırılan dış hizmetlere ve API'lere bağlanmasına olanak tanır.

  • Yerel MCP sunucuları MCP istemcileri, aynı makinedeki MCP sunucularına bağlanmak için yerel aktarım yöntemi olarak standart giriş/çıkış kullanır.

MCP sunucu uç noktaları

MCP, uzak sunucular için aşağıdaki aktarım türlerini ve tipik uç noktaları sağlar:

Aktarım Türü Uç Noktalar Notes
Akışla aktarılabilir HTTP /mcp HTTP + SSE aktarımını değiştirir
SSE (sunucu tarafından gönderilen olaylar) /sse - SSE bağlantısı kurmak için kullanılır

/messages - MCP istemcisi ve sunucusu arasında çift yönlü mesajlaşma için kullanılır		 Protokol sürümü itibariyle kullanım dışı bırakıldı 2024-11-05

API Management'ta MCP sunucularını kullanıma sunma

Azure API Management uzak MCP sunucu modunu destekler. MCP sunucu uç noktalarını yönetmek için API Management'ın yerel özelliklerini ve yapay zeka ağ geçidinin özelliklerini kullanın.

API Management, MCP sunucularını kullanıma sunmanın iki yerleşik yolunu sağlar:

Kaynak Açıklama
MCP sunucusu olarak REST API Azure kaynaklarından içeri aktarılan REST API'ler de dahil olmak üzere API Management'ta yönetilen REST API'leri MCP sunucusu olarak kullanıma sunma. API işlemleri MCP araçlarına dönüşür. Daha fazla bilgi edinin
Mevcut MCP sunucusu API Management aracılığıyla MCP uyumlu bir sunucuyu (örneğin LangChain, LangServe, Azure mantıksal uygulaması, Azure işlev uygulaması) kullanıma sunma. Daha fazla bilgi edinin

Adım adım yönergeler ve sınırlamalar için bağlantılı makalelere bakın.

MCP sunucularını yönetme

MCP sunucusunu yönetmeye yardımcı olmak için bir veya daha fazla API Management ilkesi yapılandırın. İlkeler şu anda MCP sunucusunda araç olarak kullanıma sunulan tüm API işlemleri için geçerlidir. Erişimi, kimlik doğrulamayı ve araçların diğer yönlerini denetlemek için ilkeleri kullanın.

Aşağıdaki gibi ilkeleri yapılandırın:

  • Hız sınırlama ve kota zorlama - Zaman aralığı başına istek sayısını MCP sunucusunun araçlarıyla sınırlayın ve istemciler veya abonelikler için kullanım kotaları ayarlayın.
  • Kimlik doğrulaması ve yetkilendirme - Güvenli erişim için Microsoft Entra Id veya diğer kimlik sağlayıcıları tarafından verilen JSON web belirteçlerini (JWT) kullanarak gelen istekleri gerekli kılın ve doğrulayın.
  • IP filtreleme - İstemci IP adreslerine göre MCP sunucusunun araçlarına erişimi kısıtlayın.
  • Önbelleğe alma - Performansı geliştirmek ve arka uç yükünü azaltmak için MCP sunucusunun araçlarından gelen yanıtları önbelleğe alın.

MCP sunucusuna güvenli erişim

MCP sunucusuna gelen erişimi (BIR MCP istemcisinden API Management'a) ve giden erişimi (API Management'tan MCP sunucusu arka ucuna) güvenli hale getirebilirsiniz. Arka uçlarınıza ve kuruluşunuzun güvenlik duruşunuza bağlı olarak anahtar tabanlı veya OAuth kimlik doğrulaması gibi bir veya daha fazla güvenlik önlemi uygulayın.

Daha fazla bilgi ve örnek için bkz. MCP sunucularına güvenli erişim.

İzleme

Azure API Management'ta MCP sunucularını izlemek için API Management'ın ağ geçidi etkinliği için Azure İzleyici ile yerleşik tümleştirmesini kullanın.

  • MCP sunucu isteklerini, yanıtlarını ve ayrıntılı tanılamaları yakalamak için Azure Application Insights'ı veya Azure İzleyici'yi yapılandırın.
  • Birden çok sistem ve bileşendeki istekleri izlemek için istek üst bilgilerine bağıntı kimlikleri ekleyin.
  • Test konsolunda, Application Insights telemetrilerinde veya kaynak günlüklerinde istek izleme çıkışına özel izleme eklemek için MCP sunucularınız için izleme ilkelerini yapılandırın .

Daha fazla bilgi için bkz. API Management'ı izleme.

MCP sunucularını bulma

Kuruluşunuzdaki MCP sunucularını kaydetmek ve bulmak için Azure API Center'ı kullanın.

  • Azure API Center, API Management'ta kullanıma sunulan sunucular ve API Management dışında barındırılan sunucular dahil olmak üzere MCP sunucularını yönetmek için merkezi bir konum sağlar.

  • Kullanıcılarınızın özel, kurumsal kullanıma hazır bir MCP sunucu kayıt defteri aracılığıyla MCP sunucularını bulmasına ve bunlarla etkileşim kurmasına olanak tanımak için API Center portalını dağıtın.

Kullanılabilirlik

MCP sunucu yönetimi özellikleri aşağıdaki API Management hizmet katmanlarında kullanılabilir:

  • Klasik katmanlar: Geliştirici, Temel, Standart, Premium
  • v2 katmanları: Temel v2, Standart v2, Premium v2

Kendi altyapınızdaki MCP sunucularını yönetmek için API Management şirket içinde barındırılan ağ geçidini de kullanabilirsiniz.

Uyarı

AI Gateway yayın kanalı aracılığıyla yeni MCP sunucusuna ve yapay zeka ağ geçidi özelliklerine ve özelliklerine erken erişim elde edebilirsiniz. Bu erişim, genel kullanıma sunulmadan önce en son yapay zeka ağ geçidi yeniliklerini denemenize ve ürünü şekillendirmeye yardımcı olacak geri bildirim sağlamanıza olanak tanır. Daha fazla bilgi için bkz . API Management örnekleriniz için hizmet güncelleştirme ayarlarını yapılandırma.

İlgili içerik

  • Last updated on