API envanterinizde MCP sunucularını kaydetme ve bulma

Bu makalede, uzak veya yerel model bağlam protokolü (MCP) sunucularının envanterini (veya registry) korumak ve proje katılımcılarının API Center portalı aracılığıyla bunları bulmasına yardımcı olmak için Azure API Center'ın nasıl kullanılacağı açıklanmaktadır. MCP sunucuları arka uç API'lerini veya veri kaynaklarını yapay zeka aracıları ve bunları kullanan modeller için standart bir şekilde kullanıma sunar.

Bu makalede gösterildiği gibi, API'leri ve diğer varlıkları kaydetme yönteminize benzer şekilde Azure portalını kullanarak uzak veya yerel MCP sunucularını kaydedebilirsiniz. API Center, envanterinize kaydedebileceğiniz iş ortağı MCP sunucularına bağlantılar da sağlar.

Tip

MCP sunucularını Azure API Management yönetiyorsanız, API Management örneğinizdeki MCP sunucuları ve diğer API'lerle API merkezinizi güncel tutmak için otomatik eşitlemeyi etkinleştirebilirsiniz. Daha fazla bilgi edinmek için bkz. AZURE API MANAGEMENT örneğinden API'leri eşitleme.

Note

New! API merkezinize kayıtlı MCP sunucuları artık Microsoft Foundry'nin araç kataloglarıyla tümleştirilebilir ve böylece MCP araçlarını idare edebilir ve yapay zeka aracılarının kullanımına sunabilirsiniz. Daha fazla bilgi için Foundry için ajanlar için Araç kataloğu ve Foundry için ajanlar için Özel araç kataloğu bölümüne bakın.

MCP sunucuları hakkında

Gelişmiş büyük dil modeli (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ü (MCP) bu sorunun çözülmesine 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 mimarisi

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.

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ı - MCP istemcileri, İNTERNET üzerinden MCP sunucularına bağlanır, HTTP ve sunucu tarafından gönderilen olayları (SSE) kullanarak bir bağlantı kurar ve OAuth kullanarak mcp istemcisinin kullanıcı hesabındaki kaynaklara erişimini yetkiler.

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

Önkoşullar

• Bir API merkezi. Henüz bir API merkeziniz yoksa API merkezi oluşturma hızlı başlangıcına bakın.
• Kaydetmek istediğiniz uzak bir MCP sunucusu URL uç noktası veya MCP sunucu paketi.
• (Uzak bir MCP sunucusu için) API merkezinizde MCP sunucusuyla ilişkilendirilecek bir ortam . Ortam, bir API yönetim platformu veya hesaplama hizmeti gibi MCP sunucusunun konumudur.

Uzak bir MCP sunucusu kaydını yap

Uzak bir MCP sunucusunu kaydetmek için:

1. Azure portalında oturum açın ve API merkezinize gidin.
2. Kenar çubuğu menüsündeki Stok'un altında Varlıklar'ı seçin.
3. + Varlık kaydet>MCP sunucusunu seçin.
   
4. MCP sunucusu kaydetme formunda, MCP sunucusu hakkındaki bilgileri sağlayın:
   1. MCP sunucusu için bir Başlık girin. API Center, başlığı temel alan bir Tanımlamayı otomatik olarak oluşturur, ancak gerekirse düzenleyebilirsiniz.
   2. McP sunucusu hakkında daha fazla bağlam sağlamak için bir Özet ve Açıklama girin.
   3. İsteğe bağlı olarak, bir görüntüyü MCP sunucusuyla ilişkilendirmek için bir Simge URL'si girin.
   4. Kullanım Örnekleri altında, isteğe bağlı olarak MCP sunucusu için bir veya daha fazla kullanım örneği için bir ad ve açıklama sağlayın.
   5. Uzaktan Kumandalar'ın altında aşağıdakileri yapın:
      1. + Uzak Bağlantı Ekle'yi seçin.
      2. MCP sunucusu için bir Çalışma Zamanı URL'si girin.
      3. MCP sunucusunun konumuna karşılık gelen bir API yönetim platformu veya işlem hizmeti gibi bir API Center Ortamı seçin.
      4. Kaydetseçeneğini seçin.
      5. İsteğe bağlı olarak, MCP sunucusunun birden çok uç noktası varsa veya birden çok ortamda dağıtılmışsa daha fazla uzak alan eklemek için önceki adımları yineleyin.
   6. İsteğe bağlı olarak, MCP sunucusuyla ilişkilendirilmiş bir kod deposunun URL'sini sağlamanız için Depo ekle seçeneğini belirleyin.
   7. Sürüm başlığı altında, MCP sunucusu için bir Sürüm başlığı, Sürüm kimliği ve Sürüm yaşam döngüsü sağlayın. API Center'daki sürümler hakkında daha fazla bilgi edinin.
   8. İsteğe bağlı olarak, MCP sunucusu için Lisans ve Dış belge bağlantılarını ve ilişkili bilgileri ekleyin.
   9. Oluştur'i seçin.

Uzak MCP sunucusu tanımları

API Center, uzak bir MCP sunucusu için otomatik olarak aşağıdaki OpenAPI tanımlarını oluşturur ve bunları kaydettiğiniz sunucu sürümüyle ilişkilendirir:

• Sunucu tarafından gönderilen olayları (SSE) aracı protokol olarak kullanmak için SSE tanımı
• Aktarımdan bağımsız bir aracı protokol kullanmak için akışla aktarılabilir tanım

Yerel bir MCP sunucusunu kaydetme

veya npmgibi pypi bir paket yöneticisi kullanarak yerel olarak yüklenen bir MCP sunucusunu kaydedebilirsiniz.

Yerel bir MCP sunucusunu kaydetmek için:

1. Azure portalında oturum açın ve API merkezinize gidin.
2. Kenar çubuğu menüsündeki Stok'un altında Varlıklar'ı seçin.
3. + Varlık kaydet>MCP sunucusunu seçin.
4. MCP sunucusu kaydetme formunda, MCP sunucusu hakkındaki bilgileri sağlayın:
   1. MCP sunucusu için bir Başlık girin. API Center, başlığı temel alan bir Tanımlamayı otomatik olarak oluşturur, ancak gerekirse düzenleyebilirsiniz.
   2. McP sunucusu hakkında daha fazla bağlam sağlamak için bir Özet ve Açıklama girin.
   3. İsteğe bağlı olarak, bir görüntüyü MCP sunucusuyla ilişkilendirmek için bir Simge URL'si girin.
   4. Kullanım Örnekleri altında, isteğe bağlı olarak MCP sunucusu için bir veya daha fazla kullanım örneği için bir ad ve açıklama sağlayın.
   5. Paketler'in altında aşağıdakileri yapın:
      1. + Paket ekle'yi seçin.
      2. MCP sunucusunun yüklenmesi için bir Paket kayıt defteri girin. Örneğin, npm.
      3. Paket kayıt defterinden bir Paket adı ve bir Sürüm girin.
      4. Çalışma zamanı ipucunda, MCP sunucusunu çalıştırmak için kullanılan çalışma zamanı komutunu girin. Örneğin, npx.
      5. Çalışma zamanı bağımsız değişkenlerinde, MCP sunucusunu çalıştırırken isteğe bağlı olarak bağımsız değişkenleri geçirin.
      6. Kaydetseçeneğini seçin.
      7. İsteğe bağlı olarak, MCP sunucusu birden çok paket kayıt defteri içinde kullanılabiliyorsa veya birden çok sürüme sahipse daha fazla paket eklemek için önceki adımları yineleyin.
   6. İsteğe bağlı olarak, MCP sunucusuyla ilişkilendirilmiş bir kod deposunun URL'sini sağlamanız için Depo ekle seçeneğini belirleyin.
   7. Sürüm başlığı altında, MCP sunucusu için bir Sürüm başlığı, Sürüm kimliği ve Sürüm yaşam döngüsü sağlayın. API Center'daki sürümler hakkında daha fazla bilgi edinin.
   8. İsteğe bağlı olarak, MCP sunucusu için Lisans ve Dış belge bağlantılarını ve ilişkili bilgileri ekleyin.
   9. Oluştur'i seçin.

İş ortağı MCP sunucusunu kaydet

Azure API Center, API envanterinize ekleyebileceğiniz iş ortağı MCP sunucularının seçilmiş bir listesini sağlar. Bu liste Azure Logic Apps, GitHub ve diğerleri gibi Microsoft hizmetleri MCP sunucularını içerir.

Api envanterinize bir veya daha fazla iş ortağı MCP sunucusu kaydederek bunları kuruluşunuzdaki geliştiricilerin ve diğer paydaşların kullanımına açın.

İş ortağı MCP sunucusunu kaydetmek için:

1. Azure portalında API merkezinize gidin.
2. Kenar çubuğu menüsündeki Keşfet'in altında MCP (önizleme) öğesini seçin.
3. Kullanılabilir iş ortağı MCP sunucularına göz atın. API envanterinize bir MCP sunucusu eklemek için Kaydet'i seçin. Kaydı tamamlamak için sağlanmışsa ekrandaki yönergeleri izleyin.

İş ortağı MCP sunucusu eklediğinizde, API Center sizin için otomatik olarak aşağıdaki ayarları yapılandırıyor:

• API türü MCP olarak ayarlanmış api envanterinizde bir API girdisi oluşturur.
• MCP sunucusu için bir ortam ve dağıtım oluşturur.
• İş ortağı tarafından sağlanırsa MCP sunucusu için OpenAPI tanımları ekler.

Kendi MCP sunucularınızı oluşturma ve kaydetme

Azure işlem hizmetlerini kullanarak MCP sunucuları oluşturmak ve bunları API merkezinize kaydetmek için aşağıdaki örneklere bakın:

• Logic Apps MCP sunucusu oluşturma ve kaydetme
• Bir Azure İşlevleri MCP sunucusu oluşturun ve kaydedin

API Center portalını kullanarak MCP sunucularını bulma

API Center portalınızı, geliştiricilerin ve kuruluşunuzdaki diğer paydaşların envanterdeki MCP sunucularına göz atıp filtreleyebilmesi için ayarlayın.

• Kullanıcılar, MCP sunucusunun URL uç noktası ve araç şemaları gibi ayrıntıları görüntüleyebilir ve MCP sunucusunu Visual Studio Code ortamlarına yükleyebilir.

• Yerleşik test konsolu, kullanıcıların MCP sunucu araçlarını test etmesine ve yanıtları doğrudan portalda görüntülemesine olanak tanır. MCP sunucusu ayrıntıları sayfasının Belgeler sekmesinde bir araç seçin ve ardından Test konsoluna erişmek için aracı çalıştır'ı seçin.

MCP sunucularına erişimi yönetme

İsteğe bağlı olarak, envanterinizde MCP sunucularını kimlerin görüntüleyebileceğini ve erişebileceğini yönetmek için API Center'ın erişim yönetimi özelliklerini kullanın. Daha fazla bilgi için bkz. API merkezinizdeki API'lere erişimi yetkilendirme.

İlgili içerik

• API Management'taki MCP sunucuları hakkında
• API Management'tan API merkezinize API'leri içeri aktarma
• API Center için Visual Studio uzantısını kullanarak Visual Studio Code API'leri oluşturun ve kaydedin.
• Azure API Center'ın özel, kurumsal kullanıma hazır MCP kayıt defterinizi nasıl güçlendirebileceğini gösteren canlı bir örnek için MCP Center adresini ziyaret edin.