Sử dụng máy chủ MCP của Google Ad Manager

Google Ad Manager cung cấp một máy chủ Giao thức ngữ cảnh mô hình (MCP) từ xa, cho phép các tác nhân AI tương tác một cách an toàn với các mạng, khoảng không quảng cáo, đơn đặt hàng và dữ liệu người dùng của Google Ad Manager. Bằng cách định cấu hình máy chủ MCP của Ad Manager, bạn cho phép các ứng dụng AI như Google Antigravity, Claude và ChatGPT thực hiện các hành động với tư cách là người dùng Ad Manager của bạn.

Máy chủ MCP có ở https://admanager.googleapis.com/mcp.

Điều kiện tiên quyết

• Có quyền tạo dự án trên Google Cloud hoặc có quyền xem một dự án hiện có trên Google Cloud.
• Quyền chỉnh sửa các mối kết nối hoặc Ứng dụng trong các ứng dụng AI của bạn (ví dụ: ChatGPT hoặc Claude).

Định cấu hình máy chủ MCP Ad Manager

Để sử dụng máy chủ MCP của Ad Manager, bạn phải hoàn tất các bước sau:

• Bật Ad Manager API trong dự án Google Cloud của bạn.
• Định cấu hình quy trình xác thực người dùng cuối OAuth 2.0.
• Thêm máy chủ MCP vào ứng dụng AI của bạn.

Bật API Ad Manager

Để sử dụng máy chủ MCP của Ad Manager, bạn phải bật API Ad Manager trong dự án trên đám mây của Google Cloud. Nếu bạn cần tạo một dự án trên Google Cloud, hãy xem phần Dự án mới.

Bật API

Định cấu hình quy trình xác thực

Máy chủ MCP của Ad Manager sử dụng OAuth 2.0 để xác thực và uỷ quyền cho người dùng cuối. Khi kết nối với máy chủ MCP, ứng dụng AI sẽ xác thực với tư cách là người dùng đang chạy ứng dụng AI. Tác nhân AI sẽ kế thừa chính xác vai trò người dùng, tư cách thành viên mạng và quyền của người dùng trong Google Ad Manager.

1. Trong Cloud Console của Google, hãy chuyển đến Google Auth Platform > Branding (Nền tảng xác thực của Google > Thương hiệu).

   Chuyển đến phần Thương hiệu

2. Nếu đã định cấu hình Nền tảng xác thực của Google, bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình xin phép bằng OAuth trong phần Thương hiệu, Đối tượng và Quyền truy cập dữ liệu. Nếu bạn thấy thông báo cho biết Google Auth Platform chưa được định cấu hình, hãy nhấp vào Bắt đầu:

   1. Trong mục Thông tin về ứng dụng, đối với Tên ứng dụng, hãy nhập Ad Manager MCP Server hoặc tên bạn muốn.
   2. Trong phần Email hỗ trợ người dùng, hãy chọn địa chỉ email của bạn hoặc một nhóm phù hợp.
   3. Nhấp vào Tiếp theo.
   4. Đối với Đối tượng, hãy chọn Nội bộ.
   5. Nhấp vào Tiếp theo.
   6. Đối với Thông tin liên hệ, hãy nhập Địa chỉ email mà bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
   7. Nhấp vào Tiếp theo.
   8. Trong phần Hoàn tất, hãy xem Chính sách dữ liệu người dùng của các dịch vụ API của Google. Nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của các dịch vụ API của Google.
   9. Nhấp vào Tiếp tục.
   10. Nhấp vào Tạo.

3. Nhấp vào Quyền truy cập vào dữ liệu > Thêm hoặc xoá phạm vi. Một bảng điều khiển sẽ xuất hiện cùng danh sách các phạm vi cho từng API mà bạn đã bật trong dự án Google Cloud.

   1. Trong phần Thêm phạm vi theo cách thủ công, hãy nhập các phạm vi OAuth cần thiết cho máy chủ MCP của Ad Manager:
      • https://www.googleapis.com/auth/admanager (Toàn quyền truy cập để xem và quản lý chiến dịch)
   2. Nhấp vào Thêm vào bảng.
   3. Nhấp vào Cập nhật.
   4. Sau khi chọn các phạm vi mà ứng dụng của bạn yêu cầu, trên trang Quyền truy cập vào dữ liệu, hãy nhấp vào Lưu.

Thêm máy chủ MCP vào ứng dụng AI

Để thêm máy chủ MCP Ad Manager vào ứng dụng AI, hãy làm theo hướng dẫn cho ứng dụng của bạn:

Antigravity

Để thêm máy chủ MCP của Ad Manager vào Antigravity, hãy hoàn tất các bước sau:

1. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://antigravity.google/oauth-callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.

2. Để thêm máy chủ MCP Ad Manager vào Antigravity, hãy cập nhật tệp ~/.gemini/config/mcp_config.json của bạn:

   {
     "mcpServers": {
       "AdManager-MCP": {
         // Use your chosen MCP server URL.
         "serverUrl": "https://admanager.googleapis.com/mcp",
         "oauth": {
           "clientId": "CLIENT_ID",
           "clientSecret": "CLIENT_SECRET"
         }
       }
     }
   }

   Thay thế CLIENT_ID và CLIENT_SECRET bằng thông tin xác thực ứng dụng OAuth 2.0 của bạn.

3. Để xác thực máy chủ MCP Ad Manager, hãy xem phần Antigravity: Xác thực bằng OAuth.

Claude.ai

Để thêm máy chủ MCP của Ad Manager vào Claude.ai, hãy định cấu hình một trình kết nối tuỳ chỉnh bằng mã ứng dụng OAuth và khoá bí mật của ứng dụng OAuth:

1. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://claude.ai/api/mcp/auth_callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.
2. Làm theo hướng dẫn để tạo một trình kết nối tuỳ chỉnh. Nhập mã ứng dụng khách và khoá bí mật của bạn trong trình đơn Cài đặt nâng cao.

Claude Code

Để thêm máy chủ MCP Ad Manager vào Claude Code, hãy định cấu hình một trình kết nối tuỳ chỉnh bằng mã ứng dụng khách OAuth và khoá bí mật của ứng dụng khách OAuth:

1. Cài đặt Claude Code.

2. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://claude.ai/api/mcp/auth_callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.
3. Làm theo hướng dẫn để tạo một trình kết nối tuỳ chỉnh. Nhập mã ứng dụng khách và khoá bí mật của bạn trong trình đơn Cài đặt nâng cao.

Claude Desktop

Để thêm máy chủ MCP Ad Manager vào Claude Desktop, hãy định cấu hình một trình kết nối tuỳ chỉnh bằng mã ứng dụng OAuth và khoá bí mật của ứng dụng OAuth:

1. Cài đặt Claude Desktop.

2. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://claude.ai/api/mcp/auth_callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.
3. Làm theo hướng dẫn để tạo một trình kết nối tuỳ chỉnh. Nhập mã ứng dụng khách và khoá bí mật của bạn trong trình đơn Cài đặt nâng cao.

ChatGPT

Bạn phải có gói thuê bao ChatGPT Business để sử dụng máy chủ MCP của Ad Manager với ChatGPT.

Để thêm máy chủ MCP vào ChatGPT, hãy tạo một mã ứng dụng khách và khoá bí mật OAuth 2.0 của Google, sau đó thêm máy chủ MCP làm Ứng dụng trong ChatGPT.

Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0

1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

   Chuyển đến phần Tạo ứng dụng

   Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://chatgpt.com/connector_platform_oauth_redirect vào trường URI.

5. Nhấp vào Tạo. Ứng dụng đã được tạo.

   Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

   Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.

Thêm máy chủ MCP làm ứng dụng trong ChatGPT

1. Đăng nhập vào ChatGPT.
2. Bật Chế độ nhà phát triển.
3. Mở phần Cài đặt ứng dụng ChatGPT.
4. Nhấp vào Tạo ứng dụng rồi tạo một ứng dụng cho máy chủ MCP từ xa.
5. Trong phần OAuth, hãy cung cấp mã ứng dụng khách và khoá bí mật của bạn.
6. Xác nhận rằng bạn hiểu rõ rủi ro liên quan đến việc sử dụng máy chủ MCP, rồi nhấp vào Tạo.

Máy chủ MCP xuất hiện trong trình đơn Ứng dụng và sẵn sàng sử dụng thông qua câu lệnh trò chuyện.

Con trỏ

Để thêm máy chủ MCP Ad Manager vào Cursor, hãy tạo mã ứng dụng khách và khoá bí mật. Định cấu hình máy chủ MCP bằng OAuth tĩnh. Cursor sử dụng URI chuyển hướng tuỳ thuộc vào cách bạn truy cập vào Cursor, chẳng hạn như thông qua web hoặc ứng dụng dành cho máy tính.

1. Tạo mã ứng dụng khách và khoá bí mật OAuth 2.0:

   Web hoặc tác nhân Cursor

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập https://www.cursor.com/agents/mcp/oauth/callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.

   Máy tính

   1. Trong Google API Console, hãy chuyển đến Google Auth Platform > Clients > Create client (Nền tảng xác thực của Google > Ứng dụng > Tạo ứng dụng).

      Chuyển đến phần Tạo ứng dụng

      Bạn sẽ được nhắc tạo một dự án nếu chưa chọn dự án nào.

   2. Trong danh sách Loại ứng dụng, hãy chọn Ứng dụng web.

   3. Trong trường Name (Tên), hãy nhập tên cho ứng dụng của bạn.

   4. Trong mục URI chuyển hướng được uỷ quyền, hãy nhấp vào + Thêm URI, rồi nhập http://localhost:8787/callback vào trường URI.

   5. Nhấp vào Tạo. Ứng dụng đã được tạo.

      Hộp thoại Đã tạo ứng dụng OAuth 2.0 sẽ mở ra.

   6. Trong phần Client secrets (Khoá bí mật của ứng dụng khách), hãy sao chép Client secret (Khoá bí mật của ứng dụng khách) rồi lưu vào một nơi an toàn. Bạn chỉ có thể sao chép một lần. Nếu bạn mất khoá bí mật, hãy xoá khoá đó và tạo một khoá mới.

      Thận trọng: Hãy coi khoá bí mật của ứng dụng khách như mật khẩu và lưu trữ chúng ở một nơi an toàn.
2. Làm theo hướng dẫn để Định cấu hình máy chủ MCP bằng OAuth tĩnh.
3. Sử dụng máy chủ MCP trong Chat.

Kiểm thử máy chủ MCP của Ad Manager

Sau khi định cấu hình và xác thực ứng dụng MCP, bạn có thể xác minh kết nối bằng cách chạy các câu lệnh kiểm thử trong giao diện trò chuyện với AI.

Hãy thử hỏi khách hàng AI của bạn những câu hỏi sau:

• "Liệt kê những mạng Google Ad Manager mà tôi có quyền truy cập."

  Ứng dụng gọi list_networks để truy xuất và hiển thị mã mạng Ad Manager cũng như tên hiển thị được liên kết với tài khoản người dùng của bạn.

• "Tìm thông tin chi tiết về mã mạng NETWORK_CODE."

  Ứng dụng sử dụng get_network để tìm nạp siêu dữ liệu cho mạng đã chỉ định.

• "Hiện 5 đơn đặt hàng đầu tiên trong mạng NETWORK_CODE."

  Máy khách gọi list_orders để truy vấn các đơn đặt hàng trong mạng của bạn và tóm tắt các đơn đặt hàng đó.

Nếu các công cụ chạy thành công và trả về dữ liệu Google Ad Manager, thì có nghĩa là bạn đã định cấu hình chính xác kết nối máy chủ MCP.