ACI.dev MCP Sunucularının Kullanımı

Günümüzün hızla gelişen geliştirme ortamında, Model Context Protocol (MCP) sunucuları, yapay zeka asistanlarını özel veri kaynaklarıyla birleştiren güçlü araçlar olarak ortaya çıktı. ACI.dev MCP Sunucuları, birleşik bir arayüz aracılığıyla birden fazla uygulama işlevine erişim sağlayan kapsamlı bir çözüm sunarak öne çıkıyor.

ACI.dev, her biri farklı geliştirme ihtiyaçlarını karşılamak üzere tasarlanmış iki farklı türde MCP sunucusu sağlar:

Uygulamalar MCP Sunucusu: Bu sunucu, seçtiğiniz belirli uygulamalardaki işlevlere doğrudan erişim sağlar. Sizi tek bir uygulamayla sınırlayan çoğu MCP sunucusunun aksine, ACI.dev'in Uygulamalar Sunucusu, tek bir sunucu yapılandırmasına birden fazla uygulama eklemenize olanak tanır.

Birleşik MCP Sunucusu: Bu yenilikçi sunucu, ACI.dev platformunda bulunan herhangi bir işlevi keşfedip yürütebilen iki meta işlev sağlayarak farklı bir yaklaşım sergiler. Bu dinamik yaklaşım, tüm araçları önceden listeleme ihtiyacını ortadan kaldırır.

ACI.dev MCP Sunucularının gücü, şu yeteneklerinde yatmaktadır:

• Farklı MCP sunucuları arasında geçiş yapmadan birden fazla uygulama işlevine erişim
• Belirli ihtiyaçlarınıza göre ilgili araçları dinamik olarak keşfetme
• Farklı uygulamalarda işlevleri sorunsuz bir şekilde yürütme
• Yalnızca gerektiğinde ilgili araçları yükleyerek bağlam penceresi kullanımını azaltma

API geliştiricileri için bu yetenekler, yapay zeka asistanlarının, birden fazla ayrı bağlantıyı yönetme yükü olmadan çeşitli uygulamalardaki araçlara erişebildiği ve bunları kullanabildiği daha kolay bir iş akışına dönüşür.

ACI.dev MCP Sunucularını Kurma: Adım Adım Kılavuz

ACI.dev MCP Sunucularını kullanmaya başlamak birkaç basit adım gerektirir. Bu bölüm, her iki sunucu türü için de eksiksiz kurulum sürecini anlatmaktadır.

ACI.dev MCP Sunucuları için Önkoşullar

Kurulum sürecine başlamadan önce, şunlara sahip olduğunuzdan emin olun:

1. Bir ACI.dev API anahtarı (ACI geliştirme platformundan edinilebilir)
2. UV paket yöneticisi yüklü
3. Uygulamalar yapılandırılmış ve platform.aci.dev'deki aracınız için allowed_apps içinde ayarlanmış
4. Uygulamaya özel hesaplarınızı aynı linked-account-owner-id altında bağladınız
5. Şu gibi MCP'yi destekleyen bir IDE:

• Claude Desktop
• Cursor
• Uygun uzantılara sahip VS Code

UV Paket Yöneticisini Yükleme

İlk olarak, henüz yapmadıysanız UV paket yöneticisini yükleyin:

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

Uygulamalar MCP Sunucusunu Kurma

Uygulamalar MCP Sunucusu, seçtiğiniz belirli uygulamalardaki işlevlere doğrudan erişim sağlar:

Uygulamalarınızı Seçin

Erişmek istediğiniz uygulamaları belirleyin. Mevcut uygulamaları platform.aci.dev/apps adresinde bulabilirsiniz.

Sunucuyu Çalıştırın

uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

<LINKED_ACCOUNT_OWNER_ID> değerini platform.aci.dev'deki hesap kimliğinizle değiştirin.

IDE'nizi Yapılandırın

Claude Desktop için, bunu claude_desktop_config.json dosyanıza ekleyin:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Cursor için, mcp.json dosyanıza ekleyin:

{
 "mcpServers": {
   "aipolabs-mcp-apps": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Birleşik MCP Sunucusunu Kurma

Birleşik MCP Sunucusu, iki meta işlevle daha dinamik bir yaklaşım sunar:

1. ACI_SEARCH_FUNCTIONS_WITH_INTENT - Niyetinize/ihtiyaçlarınıza göre işlevleri keşfeder
2. ACI_EXECUTE_FUNCTION - Aramayla keşfedilen herhangi bir işlevi yürütür

Sunucuyu Çalıştırın

uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

IDE'nizi Yapılandırın

Claude Desktop için, bunu claude_desktop_config.json dosyanıza ekleyin:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
   }
 }
}

Cursor için, mcp.json dosyanıza ekleyin:

{
 "mcpServers": {
   "aipolabs-mcp-unified": {
     "command": "uvx",
     "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
     "env": {
       "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
     }
   }
 }
}

Kurulumunuzu Doğrulama

Kurulumunuzun doğru çalıştığını doğrulamak için:

Uygulamalar Sunucusu için: Yapay zeka asistanınızdan, belirtilen uygulamalarınızdan birinden bir işlev kullanmasını isteyin:

"Brave Search kullanarak API geliştirmeyle ilgili son haberleri arayın"

Birleşik Sunucu için: Yapay zeka asistanınızdan bir işlevi keşfetmesini ve kullanmasını isteyin:

"REST API en iyi uygulamaları hakkında bilgi bulmam gerekiyor"

Yapay zeka, belirtilen işlevi doğrudan kullanarak (Uygulamalar Sunucusu) veya önce uygun işlevi keşfedip ardından yürüterek (Birleşik Sunucu) yanıt vermelidir.

API Geliştirme için Apidog MCP Sunucusunu Kullanın

ACI.dev MCP Sunucuları birden fazla uygulama işlevine erişim sağlamada mükemmel olsa da, API geliştirme genellikle API özellikleri ve uygulamalarıyla çalışmak için özel olarak tasarlanmış araçlar gerektirir. İşte bu noktada Apidog MCP Sunucusu devreye girerek, ACI.dev sunucularının genel amaçlı işlevselliğini tamamlayan, API odaklı geliştirme iş akışları için özel olarak oluşturulmuş yetenekler sunar.

Apidog MCP Sunucusu ile API Geliştirmeyi İyileştirme

Apidog MCP Sunucusu, API geliştirmede önemli bir ilerlemeyi temsil eder ve özellikle API özelliklerini yapay zeka asistanları için doğrudan erişilebilir hale getirmeye odaklanır. Genel amaçlı MCP sunucularının aksine, Apidog MCP Sunucusu, API geliştirmeye özel olarak tasarlanmıştır ve özellikler ile uygulamalar arasında mükemmel bir uyum sağlar.

Apidog MCP Sunucusu Nasıl Çalışır?

Kurulduktan sonra, Apidog MCP Sunucusu, API özellik verilerini yerel makinenizde otomatik olarak okur ve önbelleğe alır. Bu, yapay zeka asistanlarının geliştirme sırasında bu verileri sorunsuz bir şekilde almasını ve kullanmasını sağlar. İşlem şu şekilde çalışır:

1. API Özelliklerine Bağlanma: Apidog MCP Sunucusu, Apidog projelerinizdeki, yayınlanmış belgelerinizdeki veya OpenAPI dosyalarınızdaki API özelliklerinize doğrudan bağlanır
2. Verileri Yerel Olarak Önbelleğe Alma: Özellikler, hızlı erişim için önbelleğe alınır
3. Yapay Zekaya Bağlam Sağlama: Yapay zekaya API'niz hakkında soru sorduğunuzda, tam özelliklere erişebilir
4. Kod Oluşturmayı Etkinleştirme: Yapay zeka, API tasarımınıza mükemmel şekilde uyan kod oluşturabilir

Bu özel yaklaşım, tüm yapay zeka destekli geliştirmenin API özelliklerinizle mükemmel bir şekilde uyumlu kalmasını sağlar ve tasarım ile uygulama arasındaki yaygın kopukluğu ortadan kaldırır.

Apidog MCP Sunucusunu Kurma

Apidog MCP Sunucusunu kurmak birkaç basit adım gerektirir:

Önkoşullar:

• Node.js (sürüm 18 veya üzeri)
• MCP'yi destekleyen bir IDE (Cursor, VS Code + Cline eklentisi)

Veri Kaynağınızı Seçin: Apidog MCP Sunucusu üç farklı veri kaynağını destekler:

• Apidog Projesi: Ekibinizdeki API özelliklerine erişmek için
• Çevrimiçi API Belgeleri: Apidog aracılığıyla yayınlanan API belgelerini okumak için
• OpenAPI Dosyaları: Yerel veya çevrimiçi Swagger/OpenAPI dosyalarıyla çalışmak için

IDE'nizde MCP'yi Yapılandırın: Veri kaynağı olarak Apidog Projesi için (Windows örneği):

{
 "mcpServers": {
   "API specification": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<access-token>"
     }
   }
 }
}

Yapılandırmayı Doğrulayın: Yapay zeka asistanınıza şunu sorarak test edin:

"Lütfen MCP aracılığıyla API özelliğini getirin ve projede kaç tane uç nokta olduğunu söyleyin"

Apidog MCP ile Güçlü API Geliştirme İş Akışları

Apidog MCP Sunucusu, API geliştirmeyi dönüştüren özel iş akışlarını etkinleştirir:

Özelliklere Dayalı Kod Oluşturma

"API özelliğini getirmek ve 'Product' şeması ve ilgili şemalar için Java kayıtları oluşturmak için MCP'yi kullanın"

Özellikler Değiştiğinde Uygulamaları Güncelleme

"API özelliğine göre, 'Product' DTO'suna yeni alanları ekleyin"

Koda Belge Ekleme

"API özelliğine göre 'Product' sınıfındaki her alan için yorumlar ekleyin"

Eksiksiz API Uygulamaları Oluşturma

"API özelliğine göre '/users' uç noktasıyla ilgili tüm MVC kodunu oluşturun"

Sonuç: Geliştirme İhtiyaçlarınız İçin Doğru MCP Sunucusunu Seçme

Özel MCP sunucularının ortaya çıkışı, yapay zeka destekli geliştirmede önemli bir ilerlemeye işaret ediyor. ACI.dev MCP Sunucuları, çoklu uygulama işlevi erişimi sağlamada mükemmelken, Apidog MCP Sunucusu, özellikler ve uygulamalar arasında mükemmel bir uyum sağlayarak özellikle API geliştirmeye odaklanır.

Geliştiriciler için bu araçlar tamamlayıcı amaçlara hizmet eder:

• ACI.dev MCP Sunucuları: Birden fazla uygulamadan işlevlere erişmeniz veya belirli ihtiyaçlarınıza göre dinamik işlev keşfi istemeniz gerektiğinde idealdir.
• Apidog MCP Sunucusu: API'leri uygularken ve kodun API özellikleriyle mükemmel bir şekilde uyumlu olmasını sağlarken mükemmeldir.

Bu özel araçları, belirli gereksinimlerinize göre iş akışınıza dahil ederek, üretkenliği ve kod kalitesini önemli ölçüde artırabilirsiniz. Bu MCP sunucuları, geliştirme uygulamalarında temel bir değişimi temsil eder; işi daha verimli, doğru ve sonuç olarak daha keyifli hale getirir.