Cách Sử Dụng Máy Chủ ACI.dev MCP

Trong bối cảnh phát triển ngày nay đang tiến triển nhanh chóng, các máy chủ Model Context Protocol (MCP) đã nổi lên như những công cụ mạnh mẽ kết nối trợ lý AI với các nguồn dữ liệu chuyên biệt. Máy chủ MCP ACI.dev nổi bật với giải pháp toàn diện cho phép truy cập vào nhiều chức năng ứng dụng thông qua một giao diện thống nhất.

ACI.dev cung cấp hai loại máy chủ MCP riêng biệt, mỗi loại được thiết kế để đáp ứng các nhu cầu phát triển khác nhau:

Máy chủ Apps MCP: Máy chủ này cung cấp quyền truy cập trực tiếp vào các chức năng từ các ứng dụng cụ thể mà bạn chọn. Khác với hầu hết các máy chủ MCP khác, vốn hạn chế bạn chỉ với một ứng dụng duy nhất, Máy chủ Apps của ACI.dev cho phép bạn bao gồm nhiều ứng dụng trong một cấu hình máy chủ duy nhất.

Máy chủ MCP Unified: Máy chủ sáng tạo này có cách tiếp cận khác bằng cách cung cấp hai chức năng meta có thể khám phá và thực thi các chức năng có sẵn trên nền tảng ACI.dev. Cách tiếp cận linh hoạt này loại bỏ sự cần thiết phải liệt kê tất cả các công cụ từ trước.

Điểm mạnh của các Máy chủ MCP ACI.dev nằm ở khả năng:

Truy cập vào nhiều chức năng ứng dụng mà không cần chuyển đổi giữa các máy chủ MCP khác nhau
Khám phá các công cụ liên quan một cách linh hoạt dựa trên nhu cầu cụ thể của bạn
Thực thi các chức năng từ các ứng dụng khác nhau một cách liền mạch
Giảm thiểu việc sử dụng cửa sổ ngữ cảnh bằng cách chỉ tải các công cụ liên quan khi cần thiết

Đối với các nhà phát triển API, những tính năng này mang lại một quy trình làm việc mạch lạc hơn, trong đó trợ lý AI có thể truy cập và sử dụng các công cụ từ nhiều ứng dụng mà không cần quản lý nhiều kết nối riêng biệt.

💡

Mẹo Chuyên Nghiệp: Trong khi các Máy chủ MCP ACI.dev cung cấp quyền truy cập tuyệt vời vào nhiều chức năng ứng dụng, Máy chủ MCP Apidog cung cấp những khả năng chuyên biệt cho phát triển API. Máy chủ MCP Apidog cho phép trợ lý AI truy cập trực tiếp vào các thông số kỹ thuật API của bạn, đảm bảo rằng mã được tạo ra hoàn toàn khớp với tài liệu thiết kế của bạn.

button

Cài Đặt Máy Chủ MCP ACI.dev: Hướng Dẫn Từng Bước

Bắt đầu với Máy chủ MCP ACI.dev yêu cầu một vài bước đơn giản. Phần này sẽ hướng dẫn quy trình cài đặt hoàn chỉnh cho cả hai loại máy chủ.

Điều Kiện Cần Thiết cho Máy Chủ MCP ACI.dev

Trước khi bắt đầu quy trình cài đặt, hãy đảm bảo bạn có:

Một khóa API ACI.dev (có thể lấy từ nền tảng phát triển ACI)
Trình quản lý gói UV được cài đặt
Các ứng dụng đã được cấu hình và đặt trong allowed_apps cho tác nhân của bạn trên platform.aci.dev
Các tài khoản cụ thể của ứng dụng đã được liên kết dưới cùng một linked-account-owner-id
Một IDE hỗ trợ MCP, như:

Claude Desktop
Cursor
VS Code với các phần mở rộng phù hợp

Cài Đặt Trình Quản Lý Gói UV

Đầu tiên, cài đặt trình quản lý gói UV nếu bạn chưa làm:

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

Cài Đặt Máy Chủ Apps MCP

Máy chủ Apps MCP cung cấp quyền truy cập trực tiếp vào các chức năng từ các ứng dụng cụ thể mà bạn chọn:

Chọn Ứng Dụng Của Bạn

Xác định các ứng dụng mà bạn muốn truy cập. Bạn có thể tìm thấy các ứng dụng có sẵn tại platform.aci.dev/apps.

Chạy Máy Chủ

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

Thay thế <LINKED_ACCOUNT_OWNER_ID> bằng ID tài khoản của bạn từ platform.aci.dev.

Cấu Hình IDE Của Bạn

Đối với Claude Desktop, thêm vào claude_desktop_config.json của bạn:

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

Đối với Cursor, thêm vào mcp.json của bạn:

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

Cài Đặt Máy Chủ MCP Unified

Máy chủ MCP Unified cung cấp một cách tiếp cận năng động hơn với hai chức năng meta:

ACI_SEARCH_FUNCTIONS_WITH_INTENT - Khám phá các chức năng dựa trên ý định/nhu cầu của bạn
ACI_EXECUTE_FUNCTION - Thực thi bất kỳ chức năng nào được khám phá qua tìm kiếm

Chạy Máy Chủ

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

Cấu Hình IDE Của Bạn

Đối với Claude Desktop, thêm vào claude_desktop_config.json của bạn:

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

Đối với Cursor, thêm vào mcp.json của bạn:

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

Xác Minh Cài Đặt Của Bạn

Để xác minh cài đặt của bạn hoạt động đúng cách:

Đối với Máy Chủ Apps: Hãy nhờ trợ lý AI của bạn sử dụng một chức năng từ một trong những ứng dụng đã chỉ định của bạn:

"Tìm kiếm tin tức gần đây về phát triển API sử dụng Brave Search"

Đối với Máy Chủ Unified: Hãy nhờ trợ lý AI của bạn khám phá và sử dụng một chức năng:

"Tôi cần tìm thông tin về các thực hành tốt nhất của REST API"

AI nên phản hồi bằng cách trực tiếp sử dụng chức năng đã chỉ định (Máy Chủ Apps) hoặc bằng cách trước tiên khám phá và sau đó thực thi chức năng phù hợp (Máy Chủ Unified).

Sử Dụng Máy Chủ MCP Apidog Cho Phát Triển API

Trong khi các Máy chủ MCP ACI.dev xuất sắc trong việc cung cấp quyền truy cập vào nhiều chức năng ứng dụng, phát triển API thường yêu cầu các công cụ được thiết kế đặc biệt để làm việc với các thông số kỹ thuật và triển khai API. Đây là lúc Máy chủ MCP Apidog trở thành trung tâm, cung cấp các khả năng được xây dựng đặc biệt cho quy trình phát triển dựa trên API complementing với chức năng chung của các máy chủ ACI.dev.

Nâng Cao Phát Triển API Với Máy Chủ MCP Apidog

Máy chủ MCP Apidog đại diện cho một bước tiến lớn trong phương pháp phát triển API, tập trung cụ thể vào việc làm cho các thông số kỹ thuật API có sẵn trực tiếp cho trợ lý AI. Khác với các máy chủ MCP đa mục đích, Máy chủ MCP Apidog được xây dựng đặc biệt cho phát triển API, đảm bảo sự đồng bộ hoàn hảo giữa các thông số kỹ thuật và triển khai.

Cách Máy Chủ MCP Apidog Hoạt Động

Khi được thiết lập, Máy chủ MCP Apidog tự động đọc và lưu trữ dữ liệu thông số kỹ thuật API trên máy tính cục bộ của bạn. Điều này cho phép trợ lý AI truy xuất và sử dụng dữ liệu này một cách liền mạch trong quá trình phát triển. Quy trình hoạt động như sau:

Kết Nối Với Thông Số Kỹ Thuật API: Máy chủ MCP Apidog liên kết trực tiếp với các thông số kỹ thuật API của bạn, cho dù chúng ở trong các dự án Apidog, tài liệu được công bố, hay các tệp OpenAPI
Lưu Trữ Dữ Liệu Cục Bộ: Các thông số kỹ thuật được lưu trữ để truy cập nhanh
Cung Cấp Ngữ Cảnh Cho AI: Khi bạn hỏi AI về API của bạn, nó có thể truy cập các thông số kỹ thuật chính xác
Kích Hoạt Tạo Mã: AI có thể tạo mã hoàn hảo khớp với thiết kế API của bạn

Cách tiếp cận chuyên biệt này đảm bảo rằng mọi phát triển hỗ trợ AI đều hoàn toàn phù hợp với các thông số kỹ thuật API của bạn, loại bỏ sự kết nối thường thấy giữa thiết kế và triển khai.

Cài Đặt Máy Chủ MCP Apidog

Cài đặt Máy chủ MCP Apidog yêu cầu một vài bước đơn giản:

Điều Kiện Cần Thiết:

Node.js (phiên bản 18 trở lên)
Một IDE hỗ trợ MCP (Cursor, VS Code + plugin Cline)

Chọn Nguồn Dữ Liệu Của Bạn: Máy chủ MCP Apidog hỗ trợ ba nguồn dữ liệu khác nhau:

Dự Án Apidog: Để truy cập các thông số kỹ thuật API trong đội ngũ của bạn
Tài Liệu API Trực Tuyến: Để đọc tài liệu API được công bố qua Apidog
Tệp OpenAPI: Để làm việc với các tệp Swagger/OpenAPI cục bộ hoặc trực tuyến

Cấu Hình MCP Trong IDE Của Bạn: Đối với Dự án Apidog làm nguồn dữ liệu (ví dụ Windows):

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

Xác Minh Cấu Hình: Kiểm tra bằng cách hỏi trợ lý AI của bạn:

"Xin hãy lấy thông số kỹ thuật API qua MCP và cho tôi biết có bao nhiêu điểm cuối trong dự án"

Quy Trình Phát Triển API Mạnh Mẽ Với Apidog MCP

Máy chủ MCP Apidog cho phép các quy trình chuyên biệt biến đổi phát triển API:

Tạo Mã Dựa Trên Các Thông Số Kỹ Thuật

"Sử dụng MCP để lấy thông số kỹ thuật API và tạo các bản ghi Java cho sơ đồ 'Sản phẩm' và các sơ đồ liên quan"

Cập Nhật Các Triển Khai Khi Thông Số Thay Đổi

"Dựa trên thông số kỹ thuật API, thêm các trường mới vào DTO 'Sản phẩm'"

Thêm Tài Liệu Vào Mã

"Thêm chú thích cho mỗi trường trong lớp 'Sản phẩm' dựa trên thông số kỹ thuật API"

Tạo Các Triển Khai API Hoàn Chỉnh

"Tạo toàn bộ mã MVC liên quan đến điểm cuối '/users' theo thông số kỹ thuật API"

Kết Luận: Chọn Máy Chủ MCP Đúng Cho Nhu Cầu Phát Triển Của Bạn

Sự xuất hiện của các máy chủ MCP chuyên biệt đánh dấu một bước tiến đáng kể trong phát triển hỗ trợ AI. Các máy chủ MCP ACI.dev xuất sắc trong việc cung cấp quyền truy cập vào nhiều chức năng ứng dụng, trong khi Máy chủ MCP Apidog tập trung vào phát triển API bằng cách đảm bảo sự đồng bộ hoàn hảo giữa các thông số kỹ thuật và triển khai.

Đối với các nhà phát triển, những công cụ này phục vụ các mục đích bổ sung:

Các Máy chủ MCP ACI.dev: Lý tưởng khi bạn cần truy cập vào các chức năng từ nhiều ứng dụng khác nhau hoặc muốn khám phá chức năng một cách linh hoạt dựa trên nhu cầu cụ thể của mình.
Máy chủ MCP Apidog: Hoàn hảo khi triển khai API và đảm bảo mã hoàn toàn khớp với các thông số kỹ thuật API.

Bằng cách kết hợp những công cụ chuyên biệt này vào quy trình làm việc của bạn dựa trên yêu cầu cụ thể của mình, bạn có thể nâng cao đáng kể năng suất và chất lượng mã. Những máy chủ MCP này đại diện cho một sự chuyển mình cơ bản trong thực tiễn phát triển—giúp công việc hiệu quả hơn, chính xác hơn và cuối cùng là thú vị hơn.