Kết nối các máy chủ MCP với Bot của bạn #

Các máy chủ MCP cho phép bot AI của bạn sử dụng các công cụ từ một hệ thống khác trong các cuộc trò chuyện trực tiếp — mà bạn không cần phải tự tay xây dựng từng công cụ. Bạn chỉ cần trỏ bot đến một máy chủ MCP một lần, và mọi công cụ mà máy chủ đó cung cấp sẽ tự động khả dụng cho bot.

Nếu bạn đã từng sử dụng Hàm tùy chỉnh (Custom Functions), thì đây cũng là ý tưởng tương tự nhưng được nâng cấp thêm một bước: một hàm tùy chỉnh là một công cụ đơn lẻ mà bạn tự thiết lập, trong khi một máy chủ MCP là một gói công cụ có sẵn mà bot có thể tự khám phá và gọi.

Máy chủ MCP là gì? #

MCP (Model Context Protocol) là một tiêu chuẩn mở để cung cấp cho các trợ lý AI quyền truy cập vào các công cụ bên ngoài. Nhiều ứng dụng và dịch vụ hiện đại hiện nay xuất bản một “máy chủ MCP” — một địa chỉ web duy nhất hiển thị một tập hợp các công cụ mà AI có thể gọi: tra cứu thông tin, tìm nạp bản ghi, chạy truy vấn, tạo mục mới.

Thay vì mô tả từng công cụ cho bot, bạn cung cấp cho Your AI Connector địa chỉ máy chủ và khóa truy cập. Your AI Connector sẽ hỏi máy chủ “bạn có thể làm gì?”, nhận lại danh sách các công cụ và cung cấp chúng cho bot của bạn. Khi máy chủ thêm một công cụ mới, bot của bạn có thể sử dụng nó mà không cần thêm bất kỳ thiết lập nào từ phía bạn.

Hàm tùy chỉnh so với Máy chủ MCP — nên sử dụng cái nào:

Bạn có thể sử dụng cả hai cùng lúc trên cùng một Agent.

Cách thức hoạt động (Phiên bản đơn giản) #

1. Bạn đăng ký một máy chủ MCP trên trang MCP Servers — bao gồm địa chỉ web và tiêu đề xác thực (thường là một khóa API).
2. Your AI Connector kết nối và khám phá các công cụ của máy chủ, sau đó ghi nhớ danh sách này.
3. Bạn kích hoạt máy chủ trên một Tác nhân (Agent).
4. Trong cuộc trò chuyện, khi khách hàng yêu cầu điều gì đó mà công cụ có thể giải quyết, bot sẽ gọi công cụ đó, đọc kết quả và trả lời một cách tự nhiên.

Khách hàng không bao giờ nhìn thấy các quy trình kỹ thuật — họ chỉ nhận được câu trả lời dựa trên thông tin thực tế và cập nhật.

Chi phí cho một lệnh gọi công cụ MCP #

Một lệnh gọi công cụ từ máy chủ MCP được tính phí chính xác như một lệnh gọi hàm tùy chỉnh, dựa trên cấp độ Chất lượng AI (AI Quality tier) của Tác nhân của bạn:

Thêm máy chủ MCP (Từng bước) #

Trong thanh bên chính, dưới mục AI Studio, nhấp vào Máy chủ MCP. Sau đó nhấp vào + Thêm máy chủ.

Điền vào biểu mẫu:

Chọn cách đăng nhập: Khóa API hoặc OAuth #

Your AI Connector hỗ trợ hai cách để xác thực với máy chủ. Hãy chọn cách mà tài liệu của máy chủ yêu cầu bạn sử dụng, bằng cách dùng tùy chọn Xác thực ở đầu biểu mẫu:

• Khóa API / tiêu đề: phương thức gốc được mô tả ở trên. Bạn dán một thông tin xác thực cố định (khóa API hoặc mã thông báo) vào trường Giá trị tiêu đề xác thực, và Your AI Connector sẽ gửi nó trong mỗi yêu cầu. Phù hợp nhất cho các máy chủ cung cấp cho bạn một khóa có thời hạn dài.
• OAuth (đăng nhập): dành cho các máy chủ yêu cầu bạn đăng nhập thay vì dán khóa. Với OAuth, không cần phải sao chép khóa — bạn phê duyệt quyền truy cập bằng cách đăng nhập, tương tự như cách “Đăng nhập bằng Google” hoạt động trên các trang web khác.

Để kết nối bằng OAuth:

1. Chọn OAuth làm phương thức xác thực. Các trường Auth Header sẽ biến mất và được thay thế bằng thẻ Connect — bạn sẽ không cần khóa.

2. Điền Tên và URL máy chủ, sau đó nhấp vào Lưu. Máy chủ sẽ được thêm vào danh sách của bạn, nhưng hiện tại sẽ hiển thị là chưa kết nối.
3. Nhấp vào Kết nối trên máy chủ. Một cửa sổ đăng nhập bảo mật sẽ mở ra để bạn phê duyệt quyền truy cập.
4. Sau khi phê duyệt, cửa sổ sẽ tự động đóng lại. Máy chủ hiện đã hiển thị là đã kết nối và Your AI Connector sẽ tải các công cụ của nó.

Vậy là xong. Your AI Connector sẽ tự động duy trì kết nối ở chế độ nền, vì vậy thông thường bạn sẽ không bao giờ phải thao tác lại. Nếu máy chủ bị ngắt kết nối (ví dụ: phiên đăng nhập hết hạn hoặc ai đó thu hồi quyền truy cập ở phía máy chủ), nó sẽ hiển thị là đã ngắt kết nối — chỉ cần nhấp vào Kết nối lại và đăng nhập lần nữa.

Nếu máy chủ không thể thiết lập tự động khi bạn nhấp vào Connect, bạn sẽ được yêu cầu dán một vài thông tin chi tiết (địa chỉ đăng nhập và ID khách hàng) do tài liệu của chính máy chủ đó cung cấp, sau đó quá trình Connect sẽ hoàn tất việc đăng nhập.

Kiểm tra Kết nối #

Trước khi lưu, hãy nhấp vào Kiểm tra kết nối. Your AI Connector sẽ liên hệ với máy chủ và hiển thị cho bạn danh sách các công cụ mà nó cung cấp. Đây là cách nhanh nhất để xác nhận URL và khóa của bạn là chính xác — nếu kết nối thất bại, bạn sẽ thấy thông báo lỗi ngay tại đó thay vì phải đợi đến giữa cuộc trò chuyện mới phát hiện ra.

Khi kiểm tra thành công, hãy nhấp vào Lưu. Máy chủ của bạn sẽ xuất hiện trong danh sách với dấu chấm trạng thái màu xanh lá cây và số lượng công cụ mà nó cung cấp.

Đọc Danh sách Máy chủ #

Mỗi máy chủ trong danh sách hiển thị:

• Một dấu chấm trạng thái — màu xanh lá cây khi kết nối gần nhất thành công, màu đỏ khi lần thử gần nhất thất bại (di chuột để xem lỗi), màu xám trước khi có kết nối thành công đầu tiên.
• Địa chỉ của máy chủ và số lượng công cụ mà nó hiện đang cung cấp.
• Một công tắc bật/tắt để nhanh chóng kích hoạt hoặc vô hiệu hóa toàn bộ máy chủ mà không cần xóa nó.

Your AI Connector sẽ làm mới danh sách công cụ của mỗi máy chủ trong nền khoảng một lần mỗi ngày, vì vậy các công cụ mới sẽ tự động xuất hiện. Một máy chủ chậm hoặc tạm thời không thể truy cập sẽ không bao giờ làm gián đoạn cuộc trò chuyện — bot chỉ đơn giản là sử dụng danh sách công cụ được biết đến gần nhất và xử lý lỗi một cách linh hoạt nếu một lệnh gọi không thể thực hiện được.

Chọn các công cụ mà bot có thể sử dụng #

Một máy chủ thường cung cấp nhiều công cụ hơn mức bạn muốn bot can thiệp. Bạn có thể bật hoặc tắt từng công cụ riêng lẻ mà không cần ngắt kết nối toàn bộ máy chủ.

1. Nhấp vào biểu tượng bút chì (chỉnh sửa) trên máy chủ trong danh sách.
2. Cuộn xuống phần Công cụ (Tools) — mọi công cụ mà máy chủ cung cấp đều được liệt kê, mỗi công cụ đều có công tắc bật/tắt riêng.
3. Tắt bất kỳ công cụ nào bạn không muốn bot gọi, hoặc sử dụng Bật tất cả (Enable all) / Tắt tất cả (Disable all) để thiết lập chúng cùng một lúc.
4. Nhấp vào Lưu thay đổi (Save changes).

Chỉ những công cụ bạn để ở trạng thái bật mới được cung cấp cho bot. Một công cụ đã tắt sẽ hoàn toàn vô hình đối với bot — bot không thể gọi công cụ đó và nó sẽ không được tính vào giới hạn 40 công cụ.

Hai điều cần lưu ý:

• Các công cụ mới sẽ ở trạng thái tắt cho đến khi bạn bật chúng lên. Sau khi bạn đã quản lý các công cụ của một máy chủ, bất kỳ công cụ nào mà máy chủ thêm vào sau đó sẽ ở trạng thái tắt, vì vậy sẽ không có công cụ mới nào khả dụng cho bot cho đến khi bạn quyết định kích hoạt nó. (Các máy chủ mà bạn chưa từng quản lý sẽ giữ nguyên tất cả các công cụ ở trạng thái bật, giống như trước đây.)
• Điều này tách biệt với lựa chọn Agent bên dưới. Tại đây, bạn quyết định công cụ nào của máy chủ tồn tại trên toàn bộ tài khoản; trên Agent, bạn quyết định những máy chủ nào mà Agent đó có thể truy cập — và nếu muốn, bạn có thể thu hẹp các công cụ của nó chỉ dành riêng cho Agent đó.

Thiết lập giới hạn thực thi cho mỗi công cụ #

Bên cạnh công tắc bật/tắt của mỗi công cụ, bạn sẽ thấy một nút điều khiển Giới hạn. Nút này mở ra các giới hạn thực thi tương tự như những gì bạn có thể thiết lập trên một hàm tùy chỉnh, nhưng chỉ áp dụng cho riêng công cụ đó — rất hữu ích khi công cụ của máy chủ gọi đến một dịch vụ trả phí của bên thứ ba, hoặc khi một công cụ chỉ nên chạy một lần duy nhất trong mỗi cuộc hội thoại. Mọi thứ ở đây đều là tùy chọn; hãy để trống nếu bạn muốn công cụ hoạt động chính xác như trước đây.

• Chỉ đọc (Read-only). Một số máy chủ khai báo cho từng công cụ xem liệu nó có chỉ đọc dữ liệu hay không. Tự động (cài đặt máy chủ) sẽ tin tưởng vào khai báo đó; bạn có thể ghi đè theo cả hai hướng — đánh dấu một công cụ là Chỉ đọc khi bạn biết chắc nó không bao giờ tạo hoặc thay đổi bất cứ điều gì (điều này cho phép AI thử lại một cách an toàn khi phản hồi bị gián đoạn thay vì để khách hàng không nhận được câu trả lời), hoặc Không phải chỉ đọc khi bạn không tin tưởng vào tuyên bố của máy chủ.
• Phục vụ kết quả đã lưu vào bộ nhớ đệm khi gọi lặp lại. Khi AI gọi lại công cụ với cùng các đầu vào, kết quả trước đó sẽ được sử dụng lại (trong tối đa 24 giờ) thay vì gọi lại máy chủ.
• Số lần chạy tối đa mỗi cuộc hội thoại và số lần chạy tối đa mỗi khoảng thời gian hoạt động chính xác như trên các hàm tùy chỉnh: chỉ tính các lần chạy thành công, và khi giới hạn được kích hoạt, AI sẽ được thông báo lý do và trả lời bằng thông tin mà nó đã có — khách hàng sẽ không bao giờ bị bỏ mặc. Các cuộc hội thoại thử nghiệm được miễn trừ.

Một lưu ý trung thực về sự tin tưởng: các giới hạn kiểm soát việc chúng ta gọi máy chủ như thế nào và bao lâu một lần — chúng không thể thay đổi những gì máy chủ thực hiện bên trong sau khi đã được gọi. Và việc ghi đè một công cụ của bên thứ ba thành Chỉ đọc là một tuyên bố mạnh mẽ hơn so với hàm tùy chỉnh của riêng bạn, bởi vì đó là mã của người khác; chỉ thực hiện điều này đối với các công cụ mà bạn hiểu rõ.

Kích hoạt máy chủ trên một Agent #

Việc đăng ký máy chủ giúp nó trở nên khả dụng; bạn vẫn là người chọn Agent nào có thể sử dụng nó.

1. Mở Agent và đi đến tab AI Abilities của nó. (Đối với một chiến dịch vẫn giữ các cài đặt AI riêng thay vì thông qua một Agent riêng biệt, danh sách tương tự sẽ xuất hiện trên bước AI Abilities của chính chiến dịch đó.)
2. Tìm phần MCP servers.
3. Bật từng máy chủ mà bạn muốn bot của Agent này có thể sử dụng.
4. Nhấp vào Save changes — các lựa chọn chỉ có hiệu lực sau khi được lưu.

Bạn có thể kích hoạt tối đa 5 máy chủ cho mỗi Agent. Chỉ những máy chủ bạn kích hoạt mới khả dụng cho bot của Agent đó, giúp bot tập trung vào các công cụ phù hợp.

Chọn công cụ mà một Agent có thể sử dụng #

Sau khi một máy chủ được kích hoạt trên một Agent, bạn cũng có thể thu hẹp những công cụ nào của máy chủ đó mà Agent cụ thể này được phép gọi — rất hữu ích khi một Agent chỉ nên đọc dữ liệu trong khi một Agent khác có thể tạo bản ghi.

1. Trên tab Khả năng AI, bên dưới máy chủ đã kích hoạt, nhấp vào hàng “… công cụ được kích hoạt cho agent này” để mở rộng danh sách công cụ.
2. Tắt bất kỳ công cụ nào mà Agent này không nên sử dụng, sau đó nhấp vào Lưu thay đổi.

Hai quy tắc giúp việc này trở nên dễ dự đoán:

• Một Agent chỉ có thể thu hẹp, không bao giờ có thể mở rộng. Các công cụ bạn đã tắt trên toàn bộ tài khoản (trên trang Máy chủ MCP) sẽ không xuất hiện ở đây và không thể được kích hoạt lại cho một Agent riêng lẻ.
• Các Agent kế thừa theo mặc định. Một Agent mà bạn chưa can thiệp vào danh sách công cụ sẽ chỉ tuân theo lựa chọn trên toàn bộ tài khoản — bao gồm cả các công cụ bạn kích hoạt ở đó sau này. Khi bạn đã thu hẹp danh sách của một Agent, các công cụ mới sẽ vẫn ở trạng thái tắt đối với Agent đó cho đến khi bạn kích hoạt chúng.

Ví dụ có sẵn: Kết nối cửa hàng Shopify #

Mọi cửa hàng Shopify đều đi kèm với một máy chủ MCP tích hợp sẵn — không cần cài đặt ứng dụng, không cần tạo khóa. Shopify lưu trữ nó tại địa chỉ web của chính cửa hàng với /api/mcp được thêm vào cuối.

Những gì bot nhận được từ đó:

• Tìm kiếm sản phẩm — tìm sản phẩm bằng cách mô tả những gì khách hàng muốn (“áo khoác chạy bộ ấm áp dưới 100 đô la”), với giá cả, biến thể và hàng tồn kho trực tiếp.
• Chi tiết sản phẩm — thông tin đầy đủ về một sản phẩm cụ thể, bao gồm các tùy chọn và tình trạng còn hàng.
• Chính sách cửa hàng và Câu hỏi thường gặp (FAQ) — các câu hỏi về vận chuyển, đổi trả, hoàn tiền và quyền riêng tư, được trả lời từ chính các trang của cửa hàng.
• Giỏ hàng — tạo giỏ hàng cho khách hàng và cung cấp cho họ liên kết thanh toán.

Để kết nối, hãy thêm một máy chủ với:

Lưu, nhấp vào Test Connection (Kiểm tra kết nối) và bật máy chủ trên tác nhân của bạn — đó là toàn bộ quá trình thiết lập.

Hai điều cần biết:

• Đơn hàng không nằm trên máy chủ này. Shopify cố tình giữ dữ liệu đơn hàng bên ngoài điểm cuối công khai này. Đối với các câu hỏi “đơn hàng của tôi ở đâu?”, hãy kết hợp máy chủ này với một hàm tùy chỉnh — xem ví dụ về trạng thái đơn hàng Shopify.
• Nó hoạt động với bất kỳ cửa hàng Shopify nào — bao gồm cả cửa hàng của khách hàng nếu bạn quản lý tài khoản cho người khác. Tất cả những gì bạn cần là địa chỉ web của cửa hàng.

Bảo mật — Chỉ Kết nối các Máy chủ Bạn Tin tưởng #

Một máy chủ MCP mà bạn kết nối có thể được bot của bạn gọi và có thể trả về văn bản mà bot đọc và thực hiện theo. Hãy coi nó như bất kỳ tích hợp nào khác nắm giữ chìa khóa hệ thống của bạn:

• Chỉ đăng ký các máy chủ mà bạn kiểm soát hoặc hoàn toàn tin tưởng. Mô tả của một công cụ được viết bởi bất kỳ ai vận hành máy chủ đó, và bot sẽ đọc các mô tả đó để quyết định khi nào cần sử dụng công cụ.
• Sử dụng khóa API chuyên dụng, bị giới hạn quyền, không phải thông tin xác thực quản trị viên. Khóa của bạn được lưu trữ an toàn và không bao giờ hiển thị trong các tệp xuất dữ liệu. Điều tương tự cũng áp dụng cho đăng nhập OAuth — các mã truy cập được lưu trữ an toàn và bị ẩn đi trong bất kỳ tệp xuất nào.
• URL phải là địa chỉ https:// công khai. Các địa chỉ nội bộ, localhost và mạng riêng tư sẽ bị từ chối vì lý do bảo mật.
• Vô hiệu hóa máy chủ ngay khi bạn không còn tin tưởng nó nữa — hãy tắt hoặc xóa máy chủ đó, và nó sẽ biến mất khỏi mọi Tác nhân (Agent) ngay lập tức.

Khắc phục sự cố #

• Chấm trạng thái màu đỏ / kết nối thất bại: Mở lại máy chủ và nhấp vào Test Connection (Kiểm tra kết nối) để xem lỗi chính xác. Các nguyên nhân phổ biến nhất là khóa sai hoặc hết hạn, lỗi đánh máy trong URL hoặc máy chủ yêu cầu tên tiêu đề khác với Authorization.
• Máy chủ OAuth ngừng hoạt động / yêu cầu bạn kết nối lại: Các đăng nhập OAuth có thể bị thu hồi hoặc hết hạn ở phía máy chủ. Hãy mở máy chủ và nhấp vào Connect (Kết nối) một lần nữa để đăng nhập lại. Lưu ý rằng các đăng nhập OAuth không bao giờ được sao chép giữa các tài khoản, vì vậy các máy chủ của Agent hoặc chiến dịch đã sao chép phải được kết nối lại trong tài khoản mà bạn đã sao chép vào.
• Bot không sử dụng công cụ: Trước tiên, hãy kiểm tra xem công cụ đã được bật trong phần Tools (Công cụ) của máy chủ hay chưa (chỉnh sửa máy chủ để xem danh sách) — một công cụ bị tắt sẽ không hiển thị với bot. Sau đó, hãy đảm bảo máy chủ đã được bật trên Agent cụ thể đó và yêu cầu của khách hàng khớp rõ ràng với chức năng của công cụ. Giống như các hàm tùy chỉnh, tên và mô tả công cụ rõ ràng ở phía máy chủ sẽ giúp bot chọn đúng.
• Một công cụ mà máy chủ cung cấp không hiển thị cho bot: Nếu bạn đã quản lý các công cụ của máy chủ này, hãy nhớ rằng bất kỳ công cụ nào được thêm sau khi bạn quản lý đều sẽ ở trạng thái tắt. Hãy chỉnh sửa máy chủ, mở phần Tools (Công cụ) và bật nó lên.
• Trình kết nối có xử lý các phiên HTTP MCP không? Có. Nếu máy chủ của bạn cấp tiêu đề mcp-session-id khi kết nối được thiết lập, chúng tôi sẽ lưu trữ và gửi lại tiêu đề đó trong mọi yêu cầu tiếp theo, cùng với tiêu đề MCP-Protocol-Version. Các máy chủ có trạng thái (stateful) hoạt động mà không cần bất kỳ cấu hình bổ sung nào từ phía bạn.
• Một công cụ đã bị bỏ qua: Một Agent có thể sử dụng tối đa 5 máy chủ và 40 công cụ MCP cùng một lúc. Nếu một máy chủ cung cấp quá nhiều công cụ, một số công cụ có thể không được tải — hãy tắt các công cụ bạn không cần trong phần Tools (Công cụ) của máy chủ, hoặc giữ cho mỗi máy chủ tập trung vào các công cụ mà bạn thực sự sử dụng.

Yêu cầu về gói dịch vụ #

Các máy chủ MCP là một phần của bộ công cụ dành cho nhà phát triển, cùng với các hàm tùy chỉnh. Nếu bạn không thấy Máy chủ MCP (MCP Servers) trong phần AI Studio của thanh bên, gói hiện tại của bạn không bao gồm tính năng này — hãy nâng cấp lên gói có các công cụ dành cho nhà phát triển để bật tính năng đó.

Các bước tiếp theo #

• Hàm tùy chỉnh — thiết lập thủ công một công cụ thay vì kết nối toàn bộ máy chủ.
• Tác nhân AI — nơi các máy chủ MCP được kích hoạt cho một bot.
• Tác nhân AI — trang chính của nhóm AI Studio nơi chứa các Máy chủ MCP.