Tüm Ürünler
Search

Bu Ürün

    OpenAPI Explorer:OpenAPI MCP Server User Guide

    Belge Merkezi

    OpenAPI Explorer:OpenAPI MCP Server User Guide

    Son Güncelleme:Oct 06, 2026

    Model Context Protocol (MCP), büyük dil modellerinin (LLM) harici araçlar ve veri kaynaklarıyla etkileşime girmesini sağlayan standartlaştırılmış bir protokoldür. Alibaba Cloud OpenAPI MCP Sunucusu, Alibaba Cloud API'lerini çağırmanıza ve bulut kaynaklarınızı doğal dil kullanarak yönetmenize olanak tanır.

    Kullanım seçeneği belirleyin

    Sürüm seçin

    Alibaba Cloud OpenAPI MCP Sunucusu aşağıdaki iki sürümde sunulur:

    Öğe

    Core sürümü

    Custom sürümü

    Kurulum hızı

    Hızlı. konsol üzerinde oturum açtıktan hemen sonra uç noktayı edinin.

    Orta. Bir sunucu oluşturmanız ve API'leri seçmeniz gerekir.

    API kapsamı

    Tüm Alibaba Cloud OpenAPI'leri kapsar.

    Yalnızca seçilen API'leri kapsar.

    API eşleştirme yöntemi

    LLM, semantik aramayı kullanarak API'leri otomatik olarak bulur ve çağırır. Birden fazla API benzer işlevlere sahip olduğunda daha spesifik istemler gerekebilir.

    Seçilen API'ler doğrudan araç olarak sunulur; bu sayede LLM arama yapmadan bunları çağırabilir.

    Ayarlama yeteneği

    Desteklenmez.

    Desteklenir. API açıklamalarını ve parametrelerini değiştirebilirsiniz.

    Sunucu sayısı

    Hesap başına bir adet.

    Farklı senaryolar için birden fazla sunucu oluşturulabilir.

    Kullanım senaryoları

    Hızlı başlangıç, keşif amaçlı işlemler ve ürünler arası iş akışları.

    Sabit iş süreçleri, net API gereksinimleri ve ayarlama gerektiren senaryolar.

    • Birden fazla bulut ürününü kapsayan işlemler veya hızlı başlangıç için Core Sürümünü kullanın.

    • Belirli API'leri aklınızda tutuyorsanız ve LLM'nin bunları arama yapmadan doğrudan çağırmasını istiyorsanız Custom Sürümünü kullanın.

    Kimlik doğrulama yöntemi seçin

    Bir sürüm seçtikten sonra bir kimlik doğrulama yöntemi de belirlemeniz gerekir. OpenAPI MCP Sunucusu aşağıdaki iki kimlik doğrulama yöntemini destekler:

    • OAuth kimlik doğrulaması (etkileşimli kimlik doğrulama): Oturum açmak için tarayıcıya otomatik olarak yönlendirir. Belirtecin süresi dolduğunda tekrar oturum açmanız gerekir.

    • Statik kimlik bilgisi kimlik doğrulaması: Tek seferlik ön kontrol sonrasında statik kimlik bilgilerini kullanarak bağlantı kurar; tarayıcı gerekmez.


    Öğe


    OAuth kimlik doğrulaması


    AccessKey kimlik doğrulaması


    Kullanım senaryoları


    Tarayıcı etkileşimi olan masaüstü istemciler, günlük geliştirme ve keşif amaçlı işlemler.


    Grafik arayüzü olmayan sunucular, CI/CD işlem hatları ve denetimsiz AI aracısı entegrasyonları.


    Yetkilendirme yöntemi


    Kullanıcı oturum açma ve yetkilendirme işlemi için tarayıcı yönlendirmesi.


    AccessKey bir ortam değişkeni aracılığıyla iletilir. Tarayıcı yönlendirmesi gerekmez.


    İzin kimliği


    Yetki veren kullanıcının kimliği.


    AccessKey ile ilişkili RAM kullanıcısının kimliği.


    Güvenlik


    Kısa ömürlü belirteçler daha yüksek güvenlik sağlar.


    Uzun ömürlü statik kimlik bilgileri dikkatli risk yönetimi gerektirir.

    Önkoşullar

    OpenAPI MCP Sunucusunu kullanmaya başlamadan önce seçtiğiniz kimlik doğrulama yöntemine göre aşağıdaki hazırlıkları tamamlayın.

    OAuth kimlik doğrulaması

    Bu yöntem, tarayıcı etkileşimini destekleyen masaüstü istemciler için uygundur. İzinler kullanıcıya bağlıdır, belirteçler kısa ömürlüdür ve güvenlik düzeyi daha yüksektir.

    1. Bir Alibaba Cloud hesabınız olmalıdır. Bir RAM kullanıcısı kullanıyorsanız gerekli izinleri verin. Daha fazla bilgi için RAM kullanıcısına MCP sunucusunda işlem yapma izni verme konusuna bakın.

    2. Yönetici hesabıyla RAM konsolu > OAuth Uygulamaları > Üçüncü Taraf Uygulamaları sayfasına gidin ve resmi OpenAPI MCP Sunucusu uygulamasını yükleyip atayın. Aksi takdirde MCP hizmeti için OAuth yetkilendirmesi başarısız olur. Daha fazla bilgi için Üçüncü taraf uygulama yükleme ve yetkilendirme konusuna bakın.

    Statik kimlik bilgisi kimlik doğrulaması

    Bu yöntem, CI/CD işlem hatları, CLI ortamları ve AI aracısı entegrasyonları gibi tarayıcı etkileşimi olmayan senaryolar için uygundur. AccessKey (AK) kimlik bilgilerinin ortam değişkenleri aracılığıyla iletilmesini destekler. Yerel olarak Alibaba Cloud CLI üzerinde zaten oturum açtıysanız MCP proxy'si mevcut kimlik bilgilerini otomatik olarak yeniden kullanır ve ek yapılandırma gerekmez.

    1. Python (>= 3,13) ve uv yüklüdür.

    2. Bir Alibaba Cloud hesabı kaydettiniz ve bir AccessKey oluşturdunuz. AccessKey ile ilişkili RAM kullanıcısı veya RAM rolüne AliyunOpenAPIMCPServerStaticCredentialAccess sistem ilkesi eklenmiştir. Bu ilkeyi bir RAM kullanıcısına eklemek için RAM konsolu adresine gidebilirsiniz.

    3. İlk kullanımdan önce hesabınızın yetkilendirildiğini doğrulamak için bir ön kontrol komutu çalıştırmanız gerekir. Bu tek seferlik kontrol tüm Alibaba Cloud hesabınız için geçerlidir ve yalnızca MCP sunucusunu çalıştıran makinede değil, tarayıcısı olan herhangi bir cihazda gerçekleştirilebilir. uvx alibabacloud.mcp-proxy@latest --server-url <MCP connection URL> pre-check --site-type INTL

    MCP sunucusu uç noktası

    İstemci yapılandırma süreci hem Core hem de Custom sürümleri için aynıdır. Tek fark, MCP sunucusu uç noktasını nasıl elde ettiğinizdir.

    Core sürümü

    Oturum açtıktan sonra sistem, yerleşik araç kombinasyonu aracılığıyla tüm Alibaba Cloud OpenAPI'leri kapsayan Core Sürümü için otomatik olarak bir MCP sunucusu uç noktası atar.

    1. Alibaba Cloud OpenAPI MCP hizmeti konsolunda oturum açın.

    2. Sol gezinme bölmesinde Core sekmesine tıklayın. Sayfa, Streamable HTTP endpoint ve SSE endpoint değerlerini gösterir.

    3. OAuth veya gelişmiş ayarları değiştirmek için ilgili Değiştir düğmesine tıklayın:

      • Multi-account MCP: Çok hesaplı senaryolarda MCP sunucularını merkezi olarak yönetin. Daha fazla bilgi için Çok hesaplı senaryoda OpenAPI MCP Sunucusu kullanma konusuna bakın.

      • Public access: Genel erişimi etkinleştirdikten sonra MCP hizmetine genel ağ üzerinden erişilebilir. Bu özellik yerel geliştirme ve hata ayıklama, bölgeler arası iş birliği veya harici sistem entegrasyonu için uygundur.

      • Custom VPC allowlist: Sıkı ağ güvenliği gereksinimleri olan senaryolar için uygundur.

    Custom sürümü

    Custom Sürümü için öncelikle bir MCP sunucusu oluşturmanız ve gerekli API'leri seçmeniz gerekir. Seçilen her API, LLM'ye doğrudan bir araç olarak sunulur; bu sayede LLM semantik arama yapmadan API'yi doğrudan çağırabilir.

    1. Alibaba Cloud OpenAPI MCP hizmeti konsolunda oturum açın.

    2. Sol gezinme bölmesinde Custom > Create öğesine tıklayarak MCP yapılandırma sayfasını açın.

      Aşağıdaki bilgileri girin:

      • Name: Ad 3 ila 16 karakter uzunluğunda olmalı ve yalnızca küçük harfler, rakamlar, alt çizgi (_) ve tire (-) içermelidir. Örneğin, mcp-demo.

      • Document Language: Araçlardaki API açıklamaları için dili seçin.

      • OAuth Configuration:

        • Alibaba Cloud Official OAuth: TONGYI Lingma, Cherry Studio ve Cursor gibi yerel istemciler için uygundur.

        • Custom OAuth: Kendi kendine dağıtılan Dify, AgentScope ve Claude Web/Mobile gibi kendi oluşturduğunuz platformlar veya üçüncü taraf hizmetler için uygundur.

      • Multi-account MCP: Çok hesaplı senaryolarda MCP sunucularını merkezi olarak yönetin. Daha fazla bilgi için Çok hesaplı senaryoda OpenAPI MCP Sunucusu kullanma konusuna bakın.

      • Cloud Product and API List: MCP hizmeti için API araçlarını yapılandırın.

      • Terraform Tools: Terraform HCL kodunu kullanarak MCP araçlarını tanımlayın. Terraform Araçları yalnızca kaynak oluşturmayı destekler, değiştirmeyi desteklemez. Daha fazla bilgi için OpenAPI MCP Sunucusunda Terraform Araçları kullanma konusuna bakın.

      • System Tools: Seçildiğinde MCP hizmetine otomatik olarak entegre edilen resmi önceden yapılandırılmış araçlar.

      • MCP Instructions: LLM'ye bu MCP'yi nasıl kullanacağını söyleyen bir istem. İstemcinin MCP standart protokolünün Instructions alanını desteklemesi gerekir.

      • Remarks: MCP hizmeti için açıklayıcı bilgiler ekleyin.

    3. Oluştur öğesine tıklayın ve risk uyarısını onaylayın. Sunucu oluşturulduktan sonra sayfa Streamable HTTP endpoint ve SSE endpoint değerlerini gösterir.

    Not

    Tek bir MCP sunucusu için en fazla 30 API seçmeniz önerilir. Daha fazla API kullanmanız gerekiyorsa birden fazla MCP sunucusu oluşturun.

    MCP'yi bir VPC ortamında kullanıyorsanız sayfada görüntülenen VPC uç noktasını kullanın.

    İstemci yapılandırması

    Sunucu uç noktasını elde ettikten sonra istemcinizde bağlantıyı yapılandırın. Bu yapılandırma hem Core hem de Custom sürümleri için geçerlidir. Alibaba Cloud OpenAPI MCP hizmeti konsolu, Cherry Studio, TONGYI Lingma/Cursor/Windsurf/VSCode, Claude Code ve Codex gibi yaygın istemciler için yerleşik yapılandırma şablonları sağlar. MCP geniş uyumluluğa sahiptir ve protokolü destekleyen diğer istemciler veya programlar da buna göre yapılandırılabilir.

    İki kimlik doğrulama yöntemi desteklenir:

    • OAuth kimlik doğrulaması (etkileşimli kimlik doğrulama): Yetkilendirme için otomatik olarak tarayıcıya yönlendirir.

    • Statik kimlik bilgisi kimlik doğrulaması: Ortam değişkeni aracılığıyla iletilen bir AccessKey veya Alibaba Cloud CLI kimlik bilgilerini kullanır.

    Önemli

    AccessKey uzun vadeli bir statik kimlik bilgisidir. Sızdırılması durumunda sürekli olarak kötüye kullanılabilir. AccessKey kullanırken aşağıdaki güvenlik uygulamalarına uymalısınız. Daha fazla bilgi için AccessKey oluşturma konusuna bakın.

    • Alibaba Cloud hesabınızın AccessKey'ini kullanmayın. Bunun yerine yalnızca minimum gereken izinlere sahip bir RAM kullanıcısının AccessKey'ini kullanın.

    • AccessKey'i mcp.json gibi sürüm kontrolündeki dosyalara sabit kodlamayın. Bunu ortam değişkenleri veya bir anahtar yönetimi hizmeti aracılığıyla enjekte etmeniz önerilir.

    • Kimlik bilgisi sızıntısı riskini azaltmak için AccessKey'inizi düzenli olarak döndürmeniz önerilir.

    OAuth kimlik doğrulaması (varsayılan)

    Bu yöntem, kullanıcıyı yetkilendirme sürecinden geçirmek için yerel tarayıcıyı açar; bu nedenle GUI'ye sahip masaüstü istemciler ve günlük geliştirme veya keşif görevleri için idealdir.

    Alibaba Cloud OpenAPI MCP hizmeti konsolunda oturum açın ve Core veya Custom Sürümü için MCP hizmeti uç noktası sayfasına gidin. One-click Configuration öğesine tıklayın ve OAuth authentication (default) öğesini seçin. Ardından ilgili istemci sekmesini seçin ve yapılandırmayı tamamlamak için yapılandırma şablonunu izleyin. İşlem sırasında tarayıcıda bir kullanıcı yetkilendirme sayfası görüntülenirse Authorize öğesine tıklayın.

    Cherry Studio

    Önkoşullar: Cherry Studio yüklenmiştir.

    Yapılandırmayı aşağıdaki yollardan biriyle tamamlayabilirsiniz:

    • Tek tıkla yapılandırma: Konsoldaki yapılandırma şablonu sayfasında One-click Configuration for Cherry Studio öğesine tıklayın ve istemleri izleyin.

    • Elle yapılandırma: Cherry Studio'da Settings > MCP Servers bölümüne gidin, Add > Quick Create seçeneklerini belirleyin, bir ad girin, tür olarak Streamable HTTP seçeneğini belirleyin ve URL alanına Streamable HTTP endpoint adresini girin. Alternatif olarak Import from JSON seçeneğini belirleyebilir ve sayfadaki yapılandırma JSON'unu yapıştırabilirsiniz.

    Yapılandırmayı kaydettikten sonra tarayıcınız otomatik olarak Alibaba Cloud OAuth yetkilendirme sayfasına yönlendirilir. Yetkilendirmeyi verdikten sonra MCP hizmeti başlar.

    TONGYI Lingma/Cursor/Windsurf/VSCode

    Önkoşullar: Node.js ve npm yüklenmiştir.

    Yapılandırmayı aşağıdaki yollardan biriyle tamamlayabilirsiniz:

    • Tek tıkla yapılandırma (Yalnızca Cursor tarafından desteklenir): Konsoldaki yapılandırma şablonu sayfasında One-click Configuration for Cursor öğesine tıklayın ve istemleri izleyin.

    • Elle yapılandırma: Konsol sayfasındaki yapılandırma JSON'unu istemcinizin MCP yapılandırma dosyasına yapıştırın.

    Her istemci için yapılandırma yöntemi:

    • TONGYI Lingma: TONGYI Lingma eklentisini açın, giriş sayfasında MCP tools öğesine tıklayın ve açılan pencerenin sağ üst köşesindeki + simgesine tıklayarak bir aracı manuel olarak ekleyin. Özel bir ad girin, Tür için STDIO seçeneğini belirleyin, Komut için npx girin ve Bağımsız Değişkenler için mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>" girin.

    • Cursor: Menü çubuğundan File > Preferences > Cursor Settings > Tools & Integrations yolunu izleyin, Add Custom MCP öğesine tıklayın ve JSON'u mcp.json dosyasına yapıştırıp kaydedin. Yapılandırma dosyası genellikle ~/.cursor/mcp.json veya projenizin kök dizinindeki .cursor/mcp.json konumunda bulunur.

    • Windsurf: JSON'u ~/.windsurf/mcp.json veya projenizin kök dizinindeki .windsurf/mcp.json dosyasına yapıştırın.

    • VSCode: Ayarlarda MCP'yi arayın ve istemlere göre yapılandırmayı ekleyin.

    Yapılandırmayı kaydettikten sonra ilk kullanımınızda tarayıcı üzerinden OAuth yetkilendirmesini tamamlamanız gerekir. Tarayıcı otomatik olarak açılmazsa uygulamayı yeniden başlatın.

    Claude Code

    Önkoşullar: Claude Code yüklenmiştir.

    MCP sunucusunu eklemek için terminalinizde aşağıdaki komutu çalıştırın. <Streamable HTTP endpoint> ifadesini konsoldan aldığınız gerçek adresle değiştirdiğinizden emin olun:

    claude mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>"

    Eklenen MCP sunucusunu sorgulamak için aşağıdaki komutu çalıştırın:

    claude mcp list

    Yapılandırma veya kullanım sırasında tarayıcınızda bir kullanıcı yetkilendirme sayfası görünürse Authorize öğesine tıklayın.

    Codex

    Önkoşullar: Codex CLI yüklenmiştir.

    MCP sunucusunu eklemek için terminalinizde aşağıdaki komutu çalıştırın. <Streamable HTTP endpoint> ifadesini konsoldan aldığınız gerçek adresle değiştirdiğinizden emin olun:

    codex mcp add openapi-mcp-core -- npx mcp-remote-alibaba-cloud "<Streamable HTTP endpoint>"

    Eklenen MCP sunucusunu sorgulamak için aşağıdaki komutu çalıştırın:

    codex mcp list

    Yapılandırma veya kullanım sırasında tarayıcınızda bir kullanıcı yetkilendirme sayfası görünürse Authorize öğesine tıklayın.

    Statik kimlik bilgisi kimlik doğrulaması

    Statik kimlik bilgisi kimlik doğrulaması, tarayıcı yönlendirmesi olmadan yerel proxy alibabacloud.mcp-proxy aracılığıyla tamamlanır. Bu yöntem, otomatik işlem hatları, yalnızca komut satırı ortamları ve denetimsiz AI Aracıları gibi senaryolar için uygundur.

    Alibaba Cloud OpenAPI MCP hizmeti konsolunda oturum açın, Core veya Custom Sürümünün MCP hizmeti uç noktası sayfasına gidin, One-click Configuration öğesine tıklayın ve Static Credential Authentication öğesini seçin. Ardından ilgili istemci sekmesini seçin ve yapılandırma şablonuna göre yapılandırmayı tamamlayın.

    Not

    Yerel olarak Alibaba Cloud CLI üzerinde oturum açtıysanız (aliyun configure), proxy CLI kimlik bilgilerini otomatik olarak okur. Yapılandırmada env ortam değişkenini ayarlamanız gerekmez.

    Cherry Studio

    Önkoşullar:

    1. Cherry Studio, Python (>= 3,13) ve uv yüklenmiştir.

    2. AccessKey'inize AliyunOpenAPIMCPServerStaticCredentialAccess sistem ilkesi eklenmiştir.

    3. İlk kullanımdan önce hesabınızın yetkilendirme durumunu doğrulamak için konsoldan ön kontrol komutunu çalıştırmanız gerekir. Bu komut, tarayıcısı olan herhangi bir cihazda çalıştırılabilir ve proxy'yi çalıştıran makineyle aynı olması gerekmez.

    Yapılandırmayı aşağıdaki şekilde tamamlayabilirsiniz:

    Cherry Studio'da Settings > MCP Servers > Add > Import from JSON yolunu izleyin ve yapılandırmayı yapıştırın. AccessKey ID/Secret ifadelerini gerçek anahtarlarınızla değiştirdiğinizden emin olun. Alibaba Cloud CLI zaten yapılandırıldıysa yerel kimlik bilgilerini yeniden kullanmak için env alanını kaldırabilirsiniz.

    Yapılandırmayı tamamladıktan sonra Cherry Studio'yu yeniden başlatın ve bir bölgedeki ECS örneklerinin listesini sorgulamak gibi bir test isteği gönderin. API beklendiği gibi çağrılıyorsa statik kimlik bilgisi kimlik doğrulaması başarılı olmuştur.

    TONGYI Lingma/Cursor/Windsurf/VSCode

    Önkoşullar:

    1. TONGYI Lingma/Cursor/Windsurf/VSCode, Python (>= 3,13) ve uv yüklenmiştir.

    2. AccessKey'inize AliyunOpenAPIMCPServerStaticCredentialAccess sistem ilkesi eklenmiştir.

    3. İlk kullanımdan önce hesabınızın yetkilendirme durumunu doğrulamak için konsoldan ön kontrol komutunu çalıştırmanız gerekir. Bu komut, tarayıcısı olan herhangi bir cihazda çalıştırılabilir ve proxy'yi çalıştıran makineyle aynı olması gerekmez.

    Her istemci için yapılandırma yöntemi:

    • TONGYI Lingma: Eklentinin MCP tools sayfasında manuel olarak bir araç ekleyin. Tür için STDIO seçeneğini belirleyin, Komut için uvx girin ve Bağımsız Değişkenler için alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP endpoint>" --site-type INTL girin. Ardından ortam değişkenlerine ALIBABA_CLOUD_ACCESS_KEY_ID ve ALIBABA_CLOUD_ACCESS_KEY_SECRET ekleyin.

    • Cursor: JSON'u projenin kök dizinindeki ~/.cursor/mcp.json veya .cursor/mcp.json dosyasına yapıştırın. AccessKey ID ve secret değerlerini değiştirin.

    • Windsurf: JSON'u projenin kök dizinindeki ~/.windsurf/mcp.json veya .windsurf/mcp.json dosyasına yapıştırın. AccessKey ID ve secret değerlerini değiştirin.

    • VSCode: Ayarlarda MCP'yi arayın ve istemlere göre yapılandırmayı ekleyin.

    Alibaba Cloud CLI zaten yapılandırıldıysa yerel kimlik bilgilerini yeniden kullanmak için ortam değişkeni yapılandırmasını kaldırabilirsiniz.

    Yapılandırmayı tamamladıktan sonra ayarları kaydedin ve istemciyi yeniden başlatın. API'nin beklendiği gibi çağrıldığını doğrulamak için bir test isteği gönderin. Bu, statik kimlik bilgisi kimlik doğrulamasının başarılı olduğunu gösterir.

    Claude Code

    Önkoşullar:

    1. Claude Code, Python (>= 3,13) ve uv yüklenmiştir.

    2. AccessKey'inize AliyunOpenAPIMCPServerStaticCredentialAccess sistem ilkesi eklenmiştir.

    3. İlk kullanımdan önce hesabınızın yetkilendirme durumunu doğrulamak için konsoldan ön kontrol komutunu çalıştırmanız gerekir. Bu komut, tarayıcısı olan herhangi bir cihazda çalıştırılabilir ve proxy'yi çalıştıran makineyle aynı olması gerekmez.

    Yapılandırmayı aşağıdaki şekilde tamamlayabilirsiniz:

    MCP sunucusunu eklemek için terminalinizde aşağıdaki komutu çalıştırın. <Access Key ID>, <Access Key Secret> ve <Streamable HTTP endpoint> ifadelerini gerçek değerlerinizle değiştirdiğinizden emin olun.

    Alibaba Cloud CLI zaten yapılandırıldıysa yerel kimlik bilgilerini yeniden kullanmak için ortam değişkeni yapılandırmasını kaldırabilirsiniz.

    claude mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=<Access Key ID> --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Access Key Secret> -- uvx alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP Endpoint>" --site-type INTL

    Eklenen MCP sunucusunu sorgulamak için aşağıdaki komutu çalıştırın:

    claude mcp list

    Codex

    Önkoşullar:

    1. Codex, Python (>= 3,13) ve uv yüklenmiştir.

    2. AccessKey'inize AliyunOpenAPIMCPServerStaticCredentialAccess sistem ilkesi eklenmiştir.

    3. İlk kullanımdan önce hesabınızın yetkilendirme durumunu doğrulamak için konsoldan ön kontrol komutunu çalıştırmanız gerekir. Bu komut, tarayıcısı olan herhangi bir cihazda çalıştırılabilir ve proxy'yi çalıştıran makineyle aynı olması gerekmez.

    Yapılandırmayı aşağıdaki şekilde tamamlayabilirsiniz:

    MCP sunucusunu eklemek için terminalinizde aşağıdaki komutu çalıştırın. <Access Key ID>, <Access Key Secret> ve <Streamable HTTP endpoint> ifadelerini gerçek değerlerinizle değiştirdiğinizden emin olun.

    Alibaba Cloud CLI zaten yapılandırıldıysa yerel kimlik bilgilerini yeniden kullanmak için ortam değişkeni yapılandırmasını kaldırabilirsiniz.

    codex mcp add openapi-mcp-core --env ALIBABA_CLOUD_ACCESS_KEY_ID=<Access Key ID> --env ALIBABA_CLOUD_ACCESS_KEY_SECRET=<Access Key Secret> -- uvx alibabacloud.mcp-proxy@latest --server-url "<Streamable HTTP Endpoint>" --site-type INTL

    Eklenen MCP sunucusunu sorgulamak için aşağıdaki komutu çalıştırın:

    codex mcp list

    MCP sunucusu kullanımı

    Yapılandırmadan sonra bulut kaynaklarını yönetmek için istemcinizde doğal dil kullanabilirsiniz. Daha fazla entegrasyon yöntemi için MCP'yi entegre etmenin diğer yolları konusuna bakın.

    • Core Sürümü: İhtiyaçlarınızı doğrudan doğal dilde ifade edin. LLM, eşleşen API'leri otomatik olarak bulur, parametre tanımlarını alır ve API adlarını veya parametrelerini belirtmenize gerek kalmadan API çağrılarını yürütür. Örneğin, "China (Hangzhou) bölgesindeki ECS örneklerini sorgulamama yardımcı ol" girerseniz LLM otomatik olarak DescribeInstances API'sini bulur ve çağırır.

    • Custom Sürümü: Yapılandırdığınız API'ler doğrudan LLM'ye araç olarak sunulur; bu sayede arama ve eşleştirme ihtiyacını ortadan kaldırarak çağrı yolunu kısaltır. Birden fazla API benzer işlevlere sahip olduğunda Custom Sürümü, LLM'nin tam olarak istediğiniz belirli API'yi çağırmasını sağlar.

    Cherry Studio

    1. Metin giriş kutusundaki menüden MCP sunucunuzu seçin.

      openapi-mcp-core sunucusunu seçin ve girdinin sağında yeşil bir onay işaretinin göründüğünden emin olun; bu, sunucunun etkin olduğunu gösterir.

    2. MCP işlevini test edin. Örneğin, belirli bir bölgedeki ECS örneklerini sorgulayın:

      Please help me query the list of ECS instances with regionId cn-chengdu and set x_mcp_region_id.
      Not

      API seçimi veya parametre ayarları yanlışsa isteminizi optimize etmeyi deneyin. Custom Sürümü için sorunu çözmek amacıyla MCP ayarlamasını da kullanabilirsiniz.

    Cursor

    1. Bir model ve API anahtarı seçin. Cursor'un LLM sağlayıcılarına yönelik gereksinimleri olduğu için (bkz. Supported providers), model ve API anahtarı seçerken belgelerine başvurmanız gerekir. Bu örnekte varsayılan değerler kullanılır.

    2. Cursor iletişim kutusunda Add Context öğesine tıklayın ve MCP sunucunuzu seçin.

    3. İletişim kutusunda MCP işlevini test etmek için doğal dilde bir sorgu girin; örneğin, "China (Chengdu) bölgesindeki ECS örneklerinin sayısını sorgulamama yardımcı ol ve yalnızca örnek sayısını göster." Enter tuşuna bastıktan sonra devam etmek için istem üzerine Run tool öğesine tıklayın.

    4. MCP yürütme sonucunu görüntüleyin. API seçimi veya parametre ayarları yanlışsa isteminizi optimize etmeyi deneyin. Custom Sürümü için sorunu çözmek amacıyla MCP ayarlamasını da kullanabilirsiniz.

    TONGYI Lingma

    1. TONGYI Lingma'da bir aracı seçin ve isteminizi girin. Örneğin, China (Chengdu) bölgesindeki ECS örnek listesini sorgulayabilir ve x_mcp_region_id değerini ayarlayabilirsiniz.

    2. MCP aracını yürütmek için TONGYI Lingma'daki istemleri izleyin.

    3. Sonucu görüntüleyin. API seçimi veya parametre ayarları yanlışsa isteminizi optimize etmeyi deneyin. Custom Sürümü için sorunu çözmek amacıyla MCP ayarlamasını da kullanabilirsiniz.

    Cline

    1. Cline iletişim penceresinde MCP işlevini test etmek için doğal dilde bir sorgu girin; örneğin, "China (Chengdu) bölgesindeki ECS örneklerinin sayısını sorgulamama yardımcı ol."

      Cline, yapılandırılmış MCP sunucusundan otomatik olarak DescribeInstances aracını seçer ve girdinizden RegionId parametresi için değeri çıkarır.

    2. MCP yürütme sonucunu görüntüleyin. API seçimi veya parametre ayarları yanlışsa isteminizi optimize etmeyi deneyin. Custom Sürümü için sorunu çözmek amacıyla MCP ayarlamasını da kullanabilirsiniz.

    MCP ayarlama (Yalnızca Custom Sürümü)

    Core Sürümü, API aramalarını ve çağrılarını otomatik olarak işlemek için yerleşik araçları kullanır. Ayarlamayı desteklemez.

    Büyük dil modeli (LLM) yanlış API seçebilir veya hatalı parametreler gönderebilir. Böyle bir durumda sunucudaki API'nin genel bakışını, açıklamasını ve istek parametre açıklamalarını değiştirin. Bu, LLM'nin API'yi daha doğru anlamasına ve çağırmasına yardımcı olur.

    Örnek 1: cn-hangzhou dışındaki bölgelerdeki kaynaklarda işlem yapılırken hatalar veya yanlış veriler oluşuyor

    Dahili olarak MCP, x_mcp_region_id kullanarak Endpoint değiştirir. LLM, girdiden x_mcp_region_id iletmesi gerektiğini anlayamazsa varsayılan olarak cn-hangzhou bölgesindeki kaynaklarda işlem yapar.

    Bu sorunu aşağıdaki iki yöntemden birini kullanarak çözün:

    • LLM'ye sorguda x_mcp_region_id ayarlamasını açıkça talimat verin.

      Find the list of ECS instances for regionId cn-qingdao, and set x_mcp_region_id.

    • MCP sunucusundaki API genel bakışını veya RegionId istek parametresinin açıklamasını ayarlayın.

      Örneğin, API genel bakışına "Kullanıcı tarafından belirtilen bölgeyi x_mcp_region_id değerine iletin" ifadesini ekleyin. Alternatif olarak, RegionId açıklamasına "RegionId parametresi varsa bunu x_mcp_region_id ile birlikte iletin" ifadesini ekleyin.

      Adımlar:

      1. Custom API MCP SERVER adresine gidin ve hedef MCP hizmetinin Actions sütunundaki Edit öğesine tıklayın.

      2. Ayarlanacak API'yi seçin ve Actions sütunundaki Edit öğesine tıklayın.

      3. Genel bakışı, API isteği açıklamasını veya API parametre açıklamalarını değiştirin.

      4. Değişiklikleri kaydedin. Ardından değişiklikleri uygulamak için istemcide MCP hizmetinden bağlantıyı kesin ve yeniden bağlanın.

    Örnek 2: İsteğe bağlı API parametrelerini silme

    Bazı isteğe bağlı parametreler belirli senaryolarda kullanılmaz. Bu parametreleri MCP sunucusunda silin. Silindikten sonra LLM, parametreleri oluştururken bunları yok sayar. Bu, hata oranını azaltır ve Token tüketimini düşürür.

    MCP erişim kontrolü

    image

    Bir AI aracısı OpenAPI MCP Sunucusuyla entegre olduktan sonra aracının bulut kaynaklarına erişim izni olmaz. Kullanıcı, aracının kendi adına işlem yapmasına yetki vermelidir. Örneğin, bir istemci bir OAuth süreci başlatabilir. Aracı, kullanıcı yetkilendirme verdikten sonra geçici erişim kazanır. Tüm işlemler kullanıcı yetkilendirmesi gerektirir. Aracı yalnızca kullanıcının izinleri dahilindeki görevleri gerçekleştirebilir. Bu, en az ayrıcalık ilkesini uygular. Ayrıca ActionTrail, işlemleri gerçekten gerçekleştiren kullanıcının kimliğini kaydeder.

    Senaryolar: CherryStudio, TONGYI Lingma, Qwen Code, Cursor, Claude Code, Dify, AgentScope ve LangGraph gibi istemci aracıları veya bir aracının kullanıcı adına hareket etmesi gereken senaryolar.

    MCP'yi entegre etmenin diğer yolları

    SSS

    Araçlardaki tüm API'ler MCP istemcisinden çağrılabilir mi?

    Her zaman değil. Bir API çağrısının başarısı RAM kullanıcısının izinlerine bağlıdır. Bu, OAuth kimlik doğrulamasını başlatan kullanıcı veya kimlik doğrulama için AccessKey (AK) ile ilişkili kullanıcı olabilir. Bir RAM kullanıcısının bir API'yi çağırma izni yoksa büyük dil modeli (LLM) de bunu çağıramaz.

    Çözüm: Gerekli API izinlerini RAM kullanıcısına verin. Daha fazla bilgi için RAM kullanıcısı izinlerini yönetme konusuna bakın.

    Önemli

    LLM'nin yanlış yorumlama nedeniyle kaynak silme API'lerini çağırmasının ve hizmetlerinizi etkilemesinin önlenmesi için RAM kullanıcısına kaynak silme izinleri vermeyin.

    RAM kullanıcısı olarak MCP Sunucusu oluştururken izin reddedildi

    Çözüm:

    • RAM kullanıcısına AliyunOpenAPIMCPServerFullAccess sistem ilkesini verin. Daha fazla bilgi için RAM kullanıcısı izinlerini yönetme konusuna bakın.

    • RAM kullanıcısına özel bir ilke verin:

      1. Yönetici hesabıyla RAM konsolu içinde özel bir ilke oluşturun. Daha fazla bilgi için Özel ilke oluşturma konusuna bakın.

        Aşağıda ilkenin içeriği verilmiştir:

        MCP Sunucusu işlemleri için ilkeyi görüntülemek için tıklayın

        Bu ilke, MCP Sunucularını oluşturma, güncelleme, sorgulama ve silme ile MCP sistem araçlarını sorgulama izinlerini içerir.

        {
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "openapiexplorer:*Mcp*",
        "ram:*Application*"
      ],
      "Resource": "*",
      "Effect": "Allow"
    }
  ]
}

      2. Yönetici hesabıyla özel izni hedef RAM kullanıcısına verin. Daha fazla bilgi için RAM kullanıcısı izinlerini yönetme konusuna bakın.

    Bir MCP Sunucusu bağlantı uç noktası açığa çıkarsa başkaları tarafından kötüye kullanılabilir mi?

    Hayır. Bir istemci uç noktayı kullandığında OAuth kimlik doğrulaması bir yetkilendirme süreci başlatır. Bu süreç, kullanıcının oturum açmasını ve erişim izni vermesini gerektirir. Sistem, RAM kullanıcısının Alibaba Cloud hesabının MCP Sunucusunun Alibaba Cloud hesabıyla eşleşip eşleşmediğini kontrol eder. Eşleşme durumunda erişim verilir. Statik kimlik bilgisi kimlik doğrulaması için erişim, AK ile ilişkili RAM kullanıcısının izinleriyle sınırlandırılır. Yetkisiz bir taraf bu izin kapsamını aşamaz.

    Statik kimlik bilgisi kimlik doğrulaması ile OAuth kimlik doğrulaması arasında nasıl seçim yapılır?

    Kullanım durumunuza uygun kimlik doğrulama yöntemini seçin:

    • OAuth kimlik doğrulaması: Tarayıcı etkileşimi içeren masaüstü istemci senaryoları için uygundur. İzinler kullanıcıya bağlıdır ve belirteç daha yüksek güvenlik için kısa ömürlüdür. Günlük geliştirme ve keşif amaçlı işlemler için OAuth kullanın.

    • Statik kimlik bilgisi kimlik doğrulaması (AK): Tarayıcı yönlendirmesinin uygun olmadığı, örneğin otomatik işlem hatları, yalnızca komut satırı ortamları (grafik kullanıcı arayüzü (GUI) olmayan sunucular) ve denetimsiz AI Aracısı entegrasyonları gibi senaryolar için uygundur. İzinler AK ile ilişkili RAM kimliğine bağlıdır. Kimlik bilgilerinin güvenliğini kendiniz yönetmelisiniz.

    AccessKey Secret sızdırılırsa ne yapmalıyım?

    1. RAM konsolunda AccessKey'i hemen devre dışı bırakın veya silin.

    2. Yeni bir AccessKey oluşturun ve istemci yapılandırmanızı güncelleyin.

    3. Yetkisiz çağrıları tespit etmek için sızıntı dönemindeki ActionTrail günlüklerini kontrol edin.