Cara Menggunakan Server MCP ACI.dev

Dalam lanskap pengembangan yang berkembang pesat saat ini, Model Context Protocol (MCP) server telah muncul sebagai alat yang ampuh yang menjembatani asisten AI dengan sumber data khusus. ACI.dev MCP Servers menonjol dengan menawarkan solusi komprehensif yang menyediakan akses ke berbagai fungsi aplikasi melalui antarmuka terpadu.

ACI.dev menyediakan dua jenis MCP server yang berbeda, masing-masing dirancang untuk memenuhi kebutuhan pengembangan yang berbeda:

Apps MCP Server: Server ini menyediakan akses langsung ke fungsi dari aplikasi tertentu yang Anda pilih. Tidak seperti kebanyakan MCP server yang membatasi Anda pada satu aplikasi, Apps Server dari ACI.dev memungkinkan Anda untuk menyertakan beberapa aplikasi dalam satu konfigurasi server.

Unified MCP Server: Server inovatif ini mengambil pendekatan yang berbeda dengan menyediakan dua fungsi meta yang dapat menemukan dan menjalankan fungsi apa pun yang tersedia di platform ACI.dev. Pendekatan dinamis ini menghilangkan kebutuhan untuk mendaftar semua alat di awal.

Kekuatan ACI.dev MCP Servers terletak pada kemampuannya untuk:

Mengakses berbagai fungsi aplikasi tanpa beralih di antara MCP server yang berbeda
Menemukan alat yang relevan secara dinamis berdasarkan kebutuhan spesifik Anda
Menjalankan fungsi di berbagai aplikasi dengan mulus
Mengurangi penggunaan jendela konteks dengan hanya memuat alat yang relevan saat dibutuhkan

Bagi pengembang API, kemampuan ini diterjemahkan ke alur kerja yang lebih efisien di mana asisten AI dapat mengakses dan memanfaatkan alat dari berbagai aplikasi tanpa beban mengelola banyak koneksi terpisah.

💡

Tip Pro: Sementara ACI.dev MCP Servers menawarkan akses fungsi multi-aplikasi yang sangat baik, Apidog MCP Server menyediakan kemampuan khusus untuk pengembangan API. Apidog MCP Server memberi asisten AI akses langsung ke spesifikasi API Anda, memastikan kode yang dihasilkan sangat cocok dengan dokumen desain Anda.

button

Menyiapkan ACI.dev MCP Servers: Panduan Langkah demi Langkah

Memulai dengan ACI.dev MCP Servers membutuhkan beberapa langkah mudah. Bagian ini membahas seluruh proses penyiapan untuk kedua jenis server.

Prasyarat untuk ACI.dev MCP Servers

Sebelum memulai proses penyiapan, pastikan Anda memiliki:

Kunci API ACI.dev (dapat diperoleh dari platform pengembangan ACI)
Manajer paket UV terinstal
Aplikasi yang dikonfigurasi dan diatur di allowed_apps untuk agen Anda di platform.aci.dev
Menghubungkan akun khusus aplikasi Anda di bawah linked-account-owner-id yang sama
IDE yang mendukung MCP, seperti:

Claude Desktop
Cursor
VS Code dengan ekstensi yang sesuai

Menginstal UV Package Manager

Pertama, instal UV package manager jika Anda belum melakukannya:

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

Menyiapkan Apps MCP Server

Apps MCP Server menyediakan akses langsung ke fungsi dari aplikasi tertentu yang Anda pilih:

Pilih Aplikasi Anda

Identifikasi aplikasi mana yang ingin Anda akses. Anda dapat menemukan aplikasi yang tersedia di platform.aci.dev/apps.

Jalankan Server

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

Ganti <LINKED_ACCOUNT_OWNER_ID> dengan ID akun Anda dari platform.aci.dev.

Konfigurasikan IDE Anda

Untuk Claude Desktop, tambahkan ini ke claude_desktop_config.json Anda:

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

Untuk Cursor, tambahkan ke mcp.json Anda:

{
 "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>"
     }
   }
 }
}

Menyiapkan Unified MCP Server

Unified MCP Server menyediakan pendekatan yang lebih dinamis dengan dua fungsi meta:

ACI_SEARCH_FUNCTIONS_WITH_INTENT - Menemukan fungsi berdasarkan maksud/kebutuhan Anda
ACI_EXECUTE_FUNCTION - Menjalankan fungsi apa pun yang ditemukan oleh pencarian

Jalankan Server

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

Konfigurasikan IDE Anda

Untuk Claude Desktop, tambahkan ini ke claude_desktop_config.json Anda:

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

Untuk Cursor, tambahkan ke mcp.json Anda:

{
 "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>"
     }
   }
 }
}

Memverifikasi Penyiapan Anda

Untuk memverifikasi bahwa penyiapan Anda berfungsi dengan benar:

Untuk Apps Server: Minta asisten AI Anda untuk menggunakan fungsi dari salah satu aplikasi yang Anda tentukan:

"Search for recent news about API development using Brave Search"

Untuk Unified Server: Minta asisten AI Anda untuk menemukan dan menggunakan sebuah fungsi:

"I need to find information about REST API best practices"

AI harus merespons dengan langsung menggunakan fungsi yang ditentukan (Apps Server) atau dengan pertama-tama menemukan dan kemudian menjalankan fungsi yang sesuai (Unified Server).

Gunakan Apidog MCP Server untuk Pengembangan API

Sementara ACI.dev MCP Servers unggul dalam menyediakan akses ke berbagai fungsi aplikasi, pengembangan API seringkali membutuhkan alat yang dirancang khusus untuk bekerja dengan spesifikasi dan implementasi API. Di sinilah Apidog MCP Server menjadi fokus, menawarkan kemampuan yang dibuat khusus untuk alur kerja pengembangan berbasis API yang melengkapi fungsionalitas tujuan umum dari server ACI.dev.

Meningkatkan Pengembangan API dengan Apidog MCP Server

Apidog MCP Server mewakili kemajuan signifikan dalam metodologi pengembangan API, berfokus secara khusus untuk membuat spesifikasi API dapat diakses langsung oleh asisten AI. Tidak seperti MCP server tujuan umum, Apidog MCP Server dibuat khusus untuk pengembangan API, memastikan keselarasan sempurna antara spesifikasi dan implementasi.

Cara Kerja Apidog MCP Server

Setelah disiapkan, Apidog MCP Server secara otomatis membaca dan menyimpan data spesifikasi API di mesin lokal Anda. Ini memungkinkan asisten AI untuk mengambil dan menggunakan data ini dengan mulus selama pengembangan. Prosesnya bekerja dengan:

Menghubungkan ke Spesifikasi API: Apidog MCP Server terhubung langsung ke spesifikasi API Anda, baik itu dalam proyek Apidog, dokumentasi yang diterbitkan, atau file OpenAPI
Menyimpan Data Secara Lokal: Spesifikasi disimpan dalam cache untuk akses cepat
Memberikan Konteks ke AI: Ketika Anda bertanya kepada AI tentang API Anda, ia dapat mengakses spesifikasi yang tepat
Mengaktifkan Pembuatan Kode: AI dapat menghasilkan kode yang sangat cocok dengan desain API Anda

Pendekatan khusus ini memastikan bahwa semua pengembangan yang dibantu AI tetap selaras sempurna dengan spesifikasi API Anda, menghilangkan pemutusan umum antara desain dan implementasi.

Menyiapkan Apidog MCP Server

Menyiapkan Apidog MCP Server membutuhkan beberapa langkah sederhana:

Prasyarat:

Node.js (versi 18 atau lebih tinggi)
IDE yang mendukung MCP (Cursor, VS Code + Cline plugin)

Pilih Sumber Data Anda: Apidog MCP Server mendukung tiga sumber data yang berbeda:

Proyek Apidog: Untuk mengakses spesifikasi API di dalam tim Anda
Dokumentasi API Online: Untuk membaca dokumentasi API yang diterbitkan melalui Apidog
File OpenAPI: Untuk bekerja dengan file Swagger/OpenAPI lokal atau online

Konfigurasikan MCP di IDE Anda: Untuk Proyek Apidog sebagai sumber data (contoh Windows):

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

Verifikasi Konfigurasi: Uji dengan bertanya kepada asisten AI Anda:

"Please fetch API specification via MCP and tell me how many endpoints exist in the project"

Alur Kerja Pengembangan API yang Kuat dengan Apidog MCP

Apidog MCP Server memungkinkan alur kerja khusus yang mengubah pengembangan API:

Pembuatan Kode Berdasarkan Spesifikasi

"Use MCP to fetch the API specification and generate Java records for the 'Product' schema and related schemas"

Memperbarui Implementasi Saat Spesifikasi Berubah

"Based on the API specification, add the new fields to the 'Product' DTO"

Menambahkan Dokumentasi ke Kode

"Add comments for each field in the 'Product' class based on the API specification"

Membuat Implementasi API Lengkap

"Generate all the MVC code related to the endpoint '/users' according to the API specification"

Kesimpulan: Memilih MCP Server yang Tepat untuk Kebutuhan Pengembangan Anda

Munculnya MCP server khusus menandai kemajuan signifikan dalam pengembangan yang dibantu AI. ACI.dev MCP Servers unggul dalam menyediakan akses fungsi multi-aplikasi, sementara Apidog MCP Server berfokus secara khusus pada pengembangan API dengan memastikan keselarasan sempurna antara spesifikasi dan implementasi.

Bagi pengembang, alat ini melayani tujuan yang saling melengkapi:

ACI.dev MCP Servers: Ideal ketika Anda perlu mengakses fungsi dari beberapa aplikasi atau menginginkan penemuan fungsi dinamis berdasarkan kebutuhan spesifik Anda.
Apidog MCP Server: Sempurna saat mengimplementasikan API dan memastikan kode selaras sempurna dengan spesifikasi API.

Dengan menggabungkan alat khusus ini ke dalam alur kerja Anda berdasarkan kebutuhan spesifik Anda, Anda dapat secara signifikan meningkatkan produktivitas dan kualitas kode. MCP server ini mewakili perubahan mendasar dalam praktik pengembangan—membuat pekerjaan lebih efisien, akurat, dan pada akhirnya lebih menyenangkan.