实验这是一个实验性 API 版本，仅用于测试和反馈。

Kết nối với máy chủ MCP của Developer Knowledge

Máy chủ MCP của Google Developer Knowledge cung cấp cho các công cụ phát triển dựa trên AI khả năng tìm kiếm tài liệu chính thức dành cho nhà phát triển của Google và truy xuất thông tin về các sản phẩm của Google như Firebase, Google Cloud, Android, Maps và nhiều sản phẩm khác. Bằng cách kết nối ứng dụng AI của bạn trực tiếp với thư viện tài liệu chính thức của chúng tôi, bạn có thể đảm bảo mã và hướng dẫn mà bạn nhận được là mới nhất và dựa trên bối cảnh có thẩm quyền.

Sau khi bạn thiết lập máy chủ, các công cụ tích hợp có thể hỗ trợ các yêu cầu như:

Hướng dẫn triển khai
- Ví dụ: Cách tốt nhất để triển khai thông báo đẩy bằng Giải pháp gửi thông báo qua đám mây của Firebase trong một ứng dụng Android là gì?
Tạo và giải thích mã
- Ví dụ: Tìm trong tài liệu của Google một ví dụ về Python để liệt kê tất cả các vùng chứa trong một dự án Cloud Storage.
Khắc phục sự cố và gỡ lỗi
- Ví dụ: Vì sao khoá API Google Maps của tôi lại hiển thị hình mờ "Chỉ dành cho mục đích phát triển"?
Phân tích so sánh và tóm tắt
- Ví dụ: Giúp tôi chọn giữa Cloud Run và Cloud Functions cho một vi dịch vụ mới. Tạo một bảng Markdown so sánh các khía cạnh chính như trường hợp sử dụng chính, tính đồng thời và mô hình định giá.

Các chức năng của máy chủ MCP

Máy chủ MCP Google Developer Knowledge cung cấp các công cụ sau cho ứng dụng AI của bạn:

Tên công cụ	Mô tả
`search_documents`	Tìm kiếm tài liệu dành cho nhà phát triển của Google (Firebase, Google Cloud, Android, Maps và nhiều tài liệu khác) để tìm các trang và đoạn mã có liên quan cho câu hỏi của bạn. Sử dụng `get_documents` cùng với `parent` trong kết quả tìm kiếm để xem nội dung toàn trang.
`get_documents`	Lấy toàn bộ nội dung của nhiều tài liệu bằng cách sử dụng `parent` từ kết quả `search_documents`.

Công cụ search_documents chia tài liệu thành các đoạn văn bản nhỏ hơn được tối ưu hoá cho hoạt động tìm kiếm và truy xuất dựa trên AI. Khi bạn tìm kiếm, công cụ này sẽ trả về một hoặc nhiều đoạn trích trong tài liệu có liên quan đến cụm từ tìm kiếm của bạn. Nếu bạn cần xem toàn bộ nội dung trang xung quanh một đoạn trích, hãy dùng get_documents với parent được cung cấp trong kết quả tìm kiếm để truy xuất toàn bộ nội dung trang.

Cài đặt

Máy chủ MCP Developer Knowledge của Google là một máy chủ MCP từ xa sử dụng Developer Knowledge API để tìm kiếm và truy xuất tài liệu. Bạn có thể xác thực bằng OAuth hoặc khoá API.

Xác thực bằng OAuth

Phần này hướng dẫn bạn quy trình xác thực ứng dụng AI bằng máy chủ MCP Kiến thức dành cho nhà phát triển bằng OAuth.

Điều kiện tiên quyết: Thiết lập Google Cloud CLI

Trước khi tiếp tục, hãy đảm bảo bạn có:

Bước 1: Bật Developer Knowledge API trong một dự án

Mở trang Developer Knowledge API trong thư viện API của Google.
Kiểm tra để đảm bảo rằng bạn đã chọn đúng dự án mà bạn dự định sử dụng API.
Nhấp vào Bật. Bạn không cần có vai trò IAM cụ thể để bật hoặc sử dụng API này.

Bước 2: Chọn phương thức xác thực

Phương thức xác thực mà bạn chọn phụ thuộc vào việc trợ lý AI của bạn có hỗ trợ Thông tin xác thực mặc định của ứng dụng (ADC) bằng gcloud CLI hay yêu cầu mã ứng dụng khách OAuth độc lập hay không. Các trợ lý như Gemini CLI có thể sử dụng thông tin đăng nhập hiện có của bạn trên Google Cloud để thiết lập liền mạch, trong khi những trợ lý khác (chẳng hạn như Antigravity) yêu cầu bạn tự tạo và cung cấp thông tin đăng nhập của riêng mình để thiết lập một kết nối an toàn.

Chọn thẻ tương ứng với các yêu cầu thiết lập cụ thể của trợ lý AI.

ADC

Kết nối tài khoản của bạn

Để cấp cho máy chủ MCP quyền thay mặt bạn hành động, hãy chạy lệnh sau, thay thế PROJECT_ID bằng mã dự án Google Cloud của bạn:
```
gcloud auth application-default login
--project=PROJECT_ID
```
Khi được nhắc, hãy chọn một tài khoản rồi nhấp vào Tiếp tục.

Định cấu hình ứng dụng AI

Sau khi xác thực, bước cuối cùng là cung cấp cho ứng dụng AI của bạn thông tin chi tiết về cấu hình máy chủ. Mặc dù cấu trúc JSON chính xác sẽ khác nhau tuỳ theo ứng dụng, nhưng bạn có thể sử dụng ví dụ sau làm mẫu.

Để định cấu hình Gemini CLI hoặc Gemini Code Assist, hãy chỉnh sửa hoặc tạo một trong các tệp cấu hình sau:

Trong dự án của bạn: .gemini/settings.json
Trong thư mục gốc: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
     },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

Để kiểm tra xem máy chủ MCP có hoạt động như dự kiến hay không, hãy tiếp tục xác minh quá trình cài đặt.

Thông tin đăng nhập thủ công

Định cấu hình màn hình xin phép bằng OAuth

Định cấu hình màn hình xin phép bằng OAuth của dự án và thêm chính bạn làm người dùng thử nghiệm. Nếu bạn đã hoàn tất bước này cho dự án trên đám mây của Google Cloud, hãy chuyển sang bước tiếp theo.

Mở trang tổng quan về hoạt động xác thực của bảng điều khiển Cloud Google rồi nhấp vào Bắt đầu.
Nhập Tên ứng dụng, chọn Email hỗ trợ rồi nhấp vào Tiếp theo.
Trong phần Đối tượng, hãy chọn Bên ngoài rồi nhấp vào Tiếp theo.
Nhập địa chỉ email của bạn trong phần Thông tin liên hệ rồi nhấp vào Tiếp theo.
Đọc kỹ và đồ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, sau đó nhấp vào Tiếp tục.
Nhấp vào Tạo.

Thêm người dùng thử nghiệm

Trong Nền tảng xác thực của Google, hãy nhấp vào Đối tượng.
Trong phần Người dùng kiểm thử, hãy nhấp vào Thêm người dùng.
Nhập địa chỉ email của bạn và mọi người dùng kiểm thử được uỷ quyền khác, sau đó nhấp vào Lưu.

Tạo ứng dụng OAuth

Để xác thực với tư cách là người dùng cuối và truy cập vào dữ liệu người dùng trong ứng dụng của mình, bạn cần tạo một Mã ứng dụng khách OAuth 2.0. Mã ứng dụng khách được dùng để xác định một ứng dụng duy nhất cho các máy chủ OAuth của Google.

Trong Nền tảng xác thực của Google, hãy nhấp vào Ứng dụng khách.
Nhấp vào Tạo ứng dụng.
Trong bộ chọn Loại ứng dụng, hãy chọn Ứng dụng dành cho máy tính.
Trong trường Name (Tên), hãy nhập tên cho thông tin đăng nhập. Tên này chỉ xuất hiện trong bảng điều khiển Google Cloud.
Nhấp vào Tạo. Màn hình ứng dụng OAuth đã tạo sẽ xuất hiện, cho thấy Mã ứng dụng khách và Khoá bí mật của ứng dụng khách mới của bạn.
Nhấp vào OK. Thông tin xác thực mới tạo sẽ xuất hiện trong phần Mã ứng dụng khách OAuth 2.0.
Nhấp vào mã ứng dụng khách mới tạo. Trong mục Client secrets (Khoá bí mật của ứng dụng khách), hãy nhấp vào biểu tượng tải xuống để lưu tệp JSON. Bạn sẽ sử dụng các giá trị client_id và client_secret trong tệp này ở bước tiếp theo.

Định cấu hình ứng dụng AI

Tiếp theo, bạn cần cung cấp cho ứng dụng AI của mình thông tin chi tiết về cấu hình máy chủ. Mặc dù chuỗi các bước chính xác sẽ khác nhau tuỳ theo ứng dụng, nhưng bạn có thể sử dụng ví dụ sau làm mẫu.

Cách định cấu hình Antigravity để sử dụng máy chủ MCP:

Trong Antigravity, hãy nhấp vào trình đơn Tuỳ chọn khác trong ngăn Agent > MCP Servers (Máy chủ MCP) > Manage MCP Servers (Quản lý máy chủ MCP).

Ở đầu ngăn Quản lý máy chủ MCP mở ra, hãy nhấp vào Xem cấu hình thô để chỉnh sửa tệp mcp_config.json:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}

Quay lại phần Quản lý máy chủ MCP rồi nhấp vào Làm mới.

Thêm thông tin đăng nhập OAuth

Trong lần đầu tiên bạn cố gắng sử dụng máy chủ MCP Kiến thức dành cho nhà phát triển, trợ lý AI sẽ nhắc bạn hoàn tất quá trình thiết lập:

Yêu cầu tác nhân sử dụng máy chủ Developer Knowledge MCP bằng một câu lệnh như:
```
How do I list Cloud Storage buckets?
```
Nếu bạn thấy một thông báo yêu cầu bạn đăng ký một hoặc nhiều URI chuyển hướng, hãy nhấp vào lựa chọn để tiếp tục. Vì bạn thiết lập mã ứng dụng khách dưới dạng một ứng dụng dành cho máy tính, nên bạn không cần thêm các URI cụ thể này vào Nền tảng xác thực của Google.
Khi trợ lý AI nhắc bạn nhập Mã ứng dụng khách và Khoá bí mật của ứng dụng khách, hãy dán từng khoá tương ứng trong tệp JSON khoá bí mật của ứng dụng khách mà bạn đã lưu trước đó.
Khi được nhắc, hãy chọn một tài khoản rồi nhấp vào Tiếp tục.
Quay lại trợ lý AI. Giờ đây, tác nhân sẽ xử lý yêu cầu của bạn bằng máy chủ vừa được xác thực.

Xác thực bằng khoá API

Phần này hướng dẫn bạn quy trình xác thực ứng dụng AI của mình với máy chủ MCP của Developer Knowledge bằng khoá API.

Bước 1: Tạo khoá API

Bạn có thể tạo khoá API Developer Knowledge trong dự án Google Cloud bằng bảng điều khiển Google Cloud hoặc gcloud CLI:

Google Cloud Console

Bật API

Mở trang Developer Knowledge API trong thư viện API của Google.
Kiểm tra để đảm bảo rằng bạn đã chọn đúng dự án mà bạn dự định sử dụng API.
Nhấp vào Bật. Bạn không cần có vai trò IAM cụ thể để bật hoặc sử dụng API này.

Tạo và bảo mật khoá API

Trong bảng điều khiển Cloud cho dự án mà bạn đã bật API, hãy chuyển đến trang Thông tin đăng nhập.
Nhấp vào Tạo thông tin xác thực, rồi chọn Khoá API trong trình đơn. Hộp thoại khoá API đã tạo sẽ hiển thị chuỗi cho khoá mới tạo của bạn.
Nhấp vào Chỉnh sửa khoá API.
Trong trường Name (Tên), hãy nhập tên cho khoá.
Trong mục API restrictions (Hạn chế cho API), chọn Restrict key (Hạn chế cho khoá).
Trong danh sách Chọn API, hãy bật Developer Knowledge API (API Kiến thức dành cho nhà phát triển) rồi nhấp vào OK.
- Lưu ý: Nếu bạn vừa bật Developer Knowledge API, thì có thể sẽ có độ trễ trước khi API này xuất hiện trong danh sách Chọn API.
Nhấp vào Lưu.

Sau khi tạo khoá, hãy nhấp vào Hiện khoá để xem khoá. Hãy ghi lại thông tin này để sử dụng khi định cấu hình ứng dụng AI.

gcloud CLI

Nếu bạn chưa có, hãy tải xuống và cài đặt Giao diện dòng lệnh (CLI) gcloud.
Bật Developer Knowledge API, thay thế PROJECT_ID bằng mã dự án Google Cloud của bạn:
```
gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
```
Tạo khoá API bằng cùng một mã dự án trên đám mây của Google:
```
gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
```
Lệnh này trả về một chuỗi khoá API. Hãy ghi lại thông tin này để sử dụng khi định cấu hình ứng dụng AI.
Bảo mật khoá API bằng cách thêm các quy tắc hạn chế đối với khoá API. Để tăng cường bảo mật, hãy hạn chế khoá API cho Developer Knowledge API.

Bước 2: Bật máy chủ MCP Kiến thức dành cho nhà phát triển trong một dự án

Để bật máy chủ MCP Kiến thức dành cho nhà phát triển trong dự án Google Cloud, hãy tải xuống và cài đặt gcloud CLI, sau đó chạy lệnh sau, thay thế PROJECT_ID bằng mã dự án Google Cloud của bạn:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Nếu dịch vụ Kiến thức dành cho nhà phát triển chưa được bật cho dự án Google Cloud của bạn, thì bạn sẽ được nhắc bật dịch vụ này trước khi bật máy chủ MCP từ xa.

Theo phương pháp hay nhất về bảo mật, bạn chỉ nên bật các máy chủ MCP cho những dịch vụ cần thiết để ứng dụng AI của bạn hoạt động.

Bước 3: Định cấu hình ứng dụng AI

Định cấu hình các ứng dụng AI phổ biến theo hướng dẫn này. Thay thế YOUR_API_KEY bằng khoá Developer Knowledge API mà bạn đã tạo ở bước trước:

Gemini CLI

Để định cấu hình Gemini CLI, hãy chạy lệnh sau:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

Hoặc chỉnh sửa hoặc tạo một trong các tệp cấu hình sau:

Trong dự án của bạn: .gemini/settings.json
Trong thư mục gốc: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Để định cấu hình Gemini Code Assist, hãy chỉnh sửa hoặc tạo một trong các tệp cấu hình sau:

Trong dự án của bạn: .gemini/settings.json
Trong thư mục gốc: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Để định cấu hình Claude Code, hãy chạy lệnh sau trong thư mục ứng dụng của bạn.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

Con trỏ

Để định cấu hình Cursor, hãy chỉnh sửa .cursor/mcp.json (cho một dự án cụ thể) hoặc ~/.cursor/mcp.json (cho tất cả dự án).

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

Để định cấu hình GitHub Copilot trong VS Code cho một dự án duy nhất, hãy chỉnh sửa tệp .vscode/mcp.json trong không gian làm việc của bạn.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Để cung cấp máy chủ trong mọi dự án, hãy chỉnh sửa chế độ cài đặt người dùng. Nhấp vào nút Open Settings (JSON) (Mở phần Cài đặt (JSON)).

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Lướt ván buồm

Để định cấu hình Windsurf Editor, hãy chỉnh sửa tệp ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Xác minh cài đặt

Sau khi định cấu hình, hãy mở ứng dụng AI và nhập một câu lệnh, chẳng hạn như:

How do I list Cloud Storage buckets?

Nếu bạn thấy một lệnh gọi công cụ đến search_documents hoặc một công cụ khác của máy chủ MCP Kiến thức dành cho nhà phát triển, thì máy chủ đang hoạt động bình thường.

Quản lý mức sử dụng mã thông báo

Việc truy xuất nội dung tài liệu (đặc biệt là khi sử dụng batch_get_documents) sẽ tiêu tốn mã thông báo trong cửa sổ ngữ cảnh của ứng dụng AI. Vì một số trang tài liệu dành cho nhà phát triển của Google có kích thước khá lớn, nên việc tìm nạp nhiều tài liệu có thể nhanh chóng dẫn đến chi phí cao hơn, thời gian phản hồi của mô hình chậm hơn và tràn cửa sổ ngữ cảnh.

Để tối ưu hoá hiệu suất và tránh hoá đơn ngoài dự kiến, hãy tạo các câu lệnh cụ thể chỉ nhắm đến thông tin bạn cần. Tránh các yêu cầu chung chung (ví dụ: "So sánh tất cả các sản phẩm của Firebase") buộc tác nhân phải xử lý một lượng lớn dữ liệu cùng một lúc.

Tài liệu đi kèm

Hãy xem Tài liệu tham khảo về ngữ liệu để biết thông tin về những tài liệu mà máy chủ tìm kiếm.

Các hạn chế đã biết

Phạm vi nội dung: Chỉ những trang hiển thị công khai trên Tài liệu tham khảo về kho ngữ liệu mới được đưa vào. Nội dung từ các nguồn khác như GitHub, các trang web OSS, blog hoặc YouTube không được đưa vào.
Chỉ kết quả bằng tiếng Anh: Máy chủ chỉ hỗ trợ kết quả bằng tiếng Anh.
Phụ thuộc vào mạng: Các công cụ của máy chủ dựa vào các dịch vụ đang hoạt động của Google Cloud. Nếu bạn gặp phải lỗi liên tục, hãy kiểm tra kết nối Internet và cấu hình khoá API Developer Knowledge.

Khắc phục sự cố

Nếu bạn gặp vấn đề, hãy xác minh những điều sau:

Tệp cấu hình MCP cho công cụ AI của bạn có định dạng chính xác.
Nếu sử dụng phương thức xác thực API, bạn đã sử dụng một khoá API Developer Knowledge hợp lệ trong tệp cấu hình đó đã bật API Developer Knowledge.
Bạn chưa dùng hết hạn mức API Kiến thức dành cho nhà phát triển.

Model Armor

Nếu đang sử dụng Model Armor để bảo vệ ứng dụng, bạn có thể gặp phải lỗi 403 PERMISSION_DENIED đối với một số truy vấn. Vì máy chủ MCP Kiến thức dành cho nhà phát triển chỉ trả về tài liệu công khai từ các nguồn đáng tin cậy của Google, nên bạn nên đặt bộ lọc Tiêm câu lệnh và vượt qua các biện pháp bảo vệ (PIJB) ở mức độ tin cậy HIGH_AND_ABOVE để giảm kết quả dương tính giả. Nếu trường hợp sử dụng của bạn không liên quan đến các công cụ khác truy cập vào dữ liệu riêng tư hoặc nhạy cảm, bạn cũng có thể cân nhắc việc tắt bộ lọc PIJB.

Kết nối với máy chủ MCP của Developer Knowledge Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Các chức năng của máy chủ MCP

Cài đặt

Xác thực bằng OAuth

Điều kiện tiên quyết: Thiết lập Google Cloud CLI

Bước 1: Bật Developer Knowledge API trong một dự án

Bước 2: Chọn phương thức xác thực

ADC

Kết nối tài khoản của bạn

Định cấu hình ứng dụng AI

Thông tin đăng nhập thủ công

Định cấu hình màn hình xin phép bằng OAuth

Thêm người dùng thử nghiệm

Tạo ứng dụng OAuth

Định cấu hình ứng dụng AI

Thêm thông tin đăng nhập OAuth

Xác thực bằng khoá API

Bước 1: Tạo khoá API

Google Cloud Console

Bật API

Tạo và bảo mật khoá API

gcloud CLI

Bước 2: Bật máy chủ MCP Kiến thức dành cho nhà phát triển trong một dự án

Bước 3: Định cấu hình ứng dụng AI

Gemini CLI

Gemini Code Assist

Claude Code

Con trỏ

GitHub Copilot

Lướt ván buồm

Xác minh cài đặt

Quản lý mức sử dụng mã thông báo

Tài liệu đi kèm

Các hạn chế đã biết

Khắc phục sự cố

Model Armor

Kết nối với máy chủ MCP của Developer Knowledge