Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

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

Máy chủ MCP của Google Developer Knowledge cho phép các công cụ phát triển dựa trên AI truy cập trực tiếp vào tài liệu chính thức của Google dành cho nhà phát triển đối với các sản phẩm như Firebase, Google Cloud, Android, Google Maps Platform và nhiều sản phẩm khác. Bằng cách kết nối trợ lý lập trình với thư viện tài liệu chính thức của Google, bạn sẽ không phải tìm kiếm trên web theo cách thủ công, tránh được ngữ cảnh lỗi thời và việc trích xuất dữ liệu.

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

Máy chủ MCP của Google Developer Knowledge cung cấp 3 công cụ cốt lõi cho trợ lý lập trình 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 và trả về các đoạn trích trang phù hợp nhất cùng với tên tài liệu của chúng.
`get_documents`	Truy xuất toàn bộ nội dung Markdown của tài liệu bằng cách sử dụng tên do `search_documents` trả về.
`answer_query`	Tạo câu trả lời có cấu trúc, tổng hợp dựa trên Kho kiến thức dành cho nhà phát triển.

Công cụ search_documents này tìm kiếm trong tài liệu của Google để tìm những phần phù hợp nhất với cụm từ tìm kiếm của bạn. Khi bạn đặt câu hỏi, công cụ này sẽ trả về các đoạn văn bản ngắn. Nếu cần ngữ cảnh đầy đủ của trang xung quanh một đoạn văn, thì tác nhân của bạn có thể truyền tên tài nguyên của tài liệu đến get_documents để truy xuất toàn bộ trang.

Sử dụng công cụ answer_query khi bạn muốn nhận được câu trả lời trực tiếp cho một câu hỏi được tổng hợp từ Kho kiến thức dành cho nhà phát triển thay vì kết quả tìm kiếm thô hoặc tệp Markdown đầy đủ.

Chọn phương thức xác thực

Máy chủ MCP Kiến thức dành cho nhà phát triển hỗ trợ 2 phương thức xác thực, tuỳ thuộc vào môi trường phát triển và trợ lý AI của bạn:

Khoá API: Phù hợp nhất với các IDE và tác nhân CLI của bên thứ ba như Claude Code, Cursor, GitHub Copilot, Codex và các ứng dụng MCP từ xa khác. Truyền khoá API trong tiêu đề X-Goog-Api-Key qua HTTPS.
OAuth và ADC: Phù hợp nhất với Google Antigravity hoặc quy trình làm việc của doanh nghiệp sử dụng Thông tin xác thực mặc định của ứng dụng (ADC) hoặc Mã ứng dụng OAuth 2.0 độc lập.

Tạo thông tin đăng nhập cần thiết cho phương thức xác thực mà bạn đã chọn để cho phép trợ lý AI hoặc tác nhân lập trình xác thực các yêu cầu bằng dịch vụ máy chủ MCP Kiến thức dành cho nhà phát triển.

Chọn một thẻ để tạo thông tin đăng nhập:

Khóa API

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

Trước khi tạo khoá API, hãy đảm bảo bạn có:

Một dự án trên Google Cloud.
Đã cài đặt gcloud CLI (nếu định cấu hình từ dòng lệnh).

Bật API và tạo khoá API

Bạn có thể tạo khoá API bằng Google Cloud Console hoặc gcloud CLI:

Google Cloud Console

Mở trang Developer Knowledge API trong Google Cloud Console.
Chọn dự án trên Google Cloud rồi nhấp vào Bật.
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.
Nhấp vào thao tác Chỉnh sửa khoá API để định cấu hình các quy tắc hạn chế:
- Trong mục API restrictions (Hạn chế cho API), hãy chọn Restrict key (Hạn chế cho khoá).
- Chọn Developer Knowledge API.
- Nếu bạn dự định sử dụng cùng một khoá này cho các lệnh gọi mô hình (chẳng hạn như GEMINI_API_KEY), hãy chọn Generative Language API.
Nhấp vào Lưu, sau đó sao chép khoá API.

gcloud CLI

Bật Developer Knowledge API trong dự án của bạn, thay thế PROJECT_ID bằng mã dự án:
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
Tạo khoá API:
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
Lệnh này trả về thông tin chi tiết về siêu dữ liệu của khoá mới. Sao chép và lưu cả hai giá trị sau đây từ đầu ra của lệnh:
- keyString: đây là khoá API thô (ví dụ: AIzaSy...). Bạn sẽ dán giá trị này vào cấu hình IDE.
- name: đây là đường dẫn tài nguyên của khoá (ví dụ: projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Bạn sẽ sử dụng đường dẫn này để hạn chế khoá ở bước tiếp theo.
Hạn chế khoá cho Developer Knowledge API để giúp ngăn chặn việc sử dụng trái phép. Thay thế KEY_NAME bằng đường dẫn name đầy đủ mà bạn đã sao chép ở bước trước:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
Lưu ý quan trọng: Nếu dự định dùng cùng một khoá này cho các lệnh gọi mô hình chung của ứng dụng AI (ví dụ: GEMINI_API_KEY), bạn cũng phải cho phép Generative Language API:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth và ADC

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

Trước khi định cấu hình OAuth, hãy đảm bảo rằng bạn có:

Bật API

Chạy lệnh sau để bật Developer Knowledge API trong dự án của bạn:

gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID

Chọn loại thông tin đăng nhập OAuth

Chọn phương pháp xác thực mà công cụ của bạn yêu cầu:

Thông tin xác thực mặc định của ứng dụng

Nếu trợ lý AI của bạn hỗ trợ ADC (chẳng hạn như Google Antigravity):

Xác thực bằng Tài khoản Google và đặt dự án hạn mức:

gcloud auth application-default login \
  --project=PROJECT_ID

Khi trình duyệt mở ra, hãy đăng nhập bằng Tài khoản Google của bạn và cấp các quyền được yêu cầu.

Mã ứng dụng khách OAuth

Nếu trợ lý AI của bạn yêu cầu khoá bí mật và mã ứng dụng OAuth độc lập:

Mở màn hình xin phép bằng OAuth.
Đặt loại người dùng thành Bên ngoài, điền tên ứng dụng và email hỗ trợ bắt buộc, rồi nhấp vào Lưu và tiếp tục.
Trên trang Đối tượng, hãy nhấp vào Thêm người dùng trong mục Người dùng kiểm thử, nhập địa chỉ email Google của bạn rồi nhấp vào Lưu.
Chuyển đến trang Ứng dụng, nhấp vào Tạo ứng dụng và đặt Loại ứng dụng thành Ứng dụng dành cho máy tính.
Nhấp vào Tạo, sau đó tải tệp thông tin đăng nhập ứng dụng JSON xuống.

Định cấu hình IDE hoặc tác nhân lập trình

Sau khi lấy thông tin đăng nhập, hãy chọn môi trường lập trình mà bạn muốn để xem hướng dẫn thiết lập.

Tuỳ thuộc vào phương thức xác thực mà bạn chọn, hãy thay thế các phần giữ chỗ trong mẫu cấu hình như sau:

Xác thực bằng khoá API: Thay thế YOUR_API_KEY bằng chuỗi khoá API thô của bạn.
Xác thực OAuth hoặc ADC: Thay thế PROJECT_ID bằng mã dự án trên đám mây của bạn trên Google Cloud:

Google Antigravity

Antigravity IDE và các tiện ích

Để định cấu hình máy chủ MCP trong Antigravity IDE hoặc tiện ích Antigravity (chẳng hạn như trong VS Code), hãy chọn phương thức xác thực của bạn:

Thông tin đăng nhập Google

Cách cài đặt máy chủ MCP bằng chế độ thiết lập chỉ bằng một cú nhấp chuột:

Trong bảng điều khiển Agent, hãy nhấp vào trình đơn Tuỳ chọn khác () rồi chọn Máy chủ MCP.
Tìm kiếm Kiến thức dành cho nhà phát triển của Google.
Nhấp vào biểu tượng Cài đặt (). Antigravity tự động định cấu hình máy chủ và kết nối bằng thông tin đăng nhập Google đang hoạt động của bạn.

Khóa API

Cách định cấu hình khoá API trong Antigravity IDE hoặc tiện ích Antigravity:

Trong bảng điều khiển Agent, hãy nhấp vào trình đơn Tuỳ chọn khác () > Máy chủ MCP > Quản lý máy chủ MCP > Xem cấu hình thô (hoặc mở .agents/mcp_config.json).

Thêm cấu hình máy chủ sau:

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

Antigravity CLI

Định cấu hình máy chủ MCP trong tệp .agents/mcp_config.json của dự án (hoặc trên toàn cục trong ~/.gemini/config/mcp_config.json):

Thông tin đăng nhập Google

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

Khóa API

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

Claude Code

Chạy lệnh sau trong cửa sổ dòng lệnh:

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 trong thư mục gốc của dự án hoặc ~/.cursor/mcp.json để truy cập chung:

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

GitHub Copilot

Chế độ cài đặt Workspace

Để định cấu hình GitHub Copilot trong VS Code cho một không gian làm việc cụ thể, hãy tạo hoặc chỉnh sửa .vscode/mcp.json:

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

Chế độ cài đặt chung cho người dùng

Để cung cấp máy chủ trên tất cả các không gian làm việc của VS Code, hãy mở User Settings (JSON) (Cài đặt người dùng (JSON)) rồi thêm nội dung sau vào khoá "mcp":

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

Codex

Để định cấu hình Codex CLI hoặc tác nhân Codex, hãy thêm cấu hình máy chủ vào ~/.codex/config.json (hoặc .codex/config.json của dự án):

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

Khác

Để định cấu hình bất kỳ ứng dụng MCP từ xa nào khác (chẳng hạn như Trợ lý AI của JetBrains, Windsurf, Cline, Zed, Continue hoặc Claude Desktop), hãy định cấu hình một máy chủ truyền tải HTTP với các chế độ cài đặt sau:

URL của máy chủ: https://developerknowledge.googleapis.com/mcp
Tiêu đề HTTP: X-Goog-Api-Key: YOUR_API_KEY

Mẫu cấu hình JSON tiêu chuẩn:

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

Xác minh kết nối

Sau khi định cấu hình, hãy khởi động lại trợ lý AI hoặc tải lại các máy chủ MCP của trợ lý. Sau đó, hãy gửi một câu lệnh kiểm thử để xác minh rằng tính năng tích hợp công cụ hoạt động:

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

Nếu tác nhân gọi search_documents hoặc answer_query và trả về thông tin từ tài liệu của Google, thì máy chủ của bạn đã được kết nối và đang hoạt động.

Tối ưu hoá cửa sổ ngữ cảnh và mức sử dụng mã thông báo

Việc truy xuất toàn bộ các trang tài liệu vào cửa sổ ngữ cảnh của mô hình AI sẽ tiêu tốn một lượng lớn token. Việc nhập nhiều tài liệu lớn có thể khiến chi phí mã thông báo cao, độ trễ tăng lên và tràn cửa sổ ngữ cảnh.

Để đảm bảo nhận được phản hồi nhanh chóng và tiết kiệm chi phí, hãy làm theo các phương pháp hay nhất về thiết kế câu lệnh sau:

Dựa vào quy trình truy xuất hai bước: Cho phép tác nhân bắt đầu bằng cách gọi search_documents. Điều này trả về các đoạn mã (phần) được lấy tiêu điểm, thường chứa cú pháp hoặc chữ ký API chính xác mà bạn cần mà không tiêu thụ mã thông báo cho toàn bộ trang. Hướng dẫn tác nhân của bạn chỉ gọi get_documents khi ngữ cảnh xung quanh là thực sự cần thiết.
Ưu tiên sử dụng answer_query cho các câu hỏi mang tính khái niệm: Khi bạn cần một lời giải thích tổng hợp hoặc so sánh thiết kế, hãy hướng dẫn đặc vụ sử dụng answer_query. Công cụ này tổng hợp câu trả lời trực tiếp từ kho kiến thức dành cho nhà phát triển mà không trả về toàn bộ các trang Markdown thô.
Viết câu lệnh cụ thể, có phạm vi: Tránh các câu lệnh quá chung chung, chẳng hạn như "Giải thích tất cả về Firebase". Thay vào đó, hãy chỉ định sản phẩm, nền tảng và ngôn ngữ mục tiêu:
```
How do I write a Firestore transaction in Dart with error handling?
```
Thêm quy tắc tuỳ chỉnh cho tác nhân: Thêm các nguyên tắc ở cấp dự án vào tệp hướng dẫn của trợ lý (ví dụ: .cursorrules, CLAUDE.md hoặc .github/copilot-instructions.md) để hạn chế việc tìm nạp tự động toàn trang:
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

Cấu hình bảo mật và an toàn không bắt buộc

MCP mang đến những rủi ro và điểm cần cân nhắc mới về bảo mật do bạn có thể thực hiện nhiều hành động bằng các công cụ MCP. Để giảm thiểu và quản lý những rủi ro này, Google Cloud cung cấp các chế độ cài đặt mặc định và chính sách có thể tuỳ chỉnh để kiểm soát việc sử dụng các công cụ MCP trong tổ chức hoặc dự án Google Cloud của bạn.

Để biết thêm thông tin về tính bảo mật và hoạt động quản trị của MCP, hãy xem phần Tính bảo mật và an toàn của AI.

Sử dụng Model Armor

Model Armor là một dịch vụ của Google Cloud được thiết kế để tăng cường tính bảo mật và an toàn cho các ứng dụng AI của bạn. Tính năng này hoạt động bằng cách chủ động sàng lọc các câu lệnh và câu trả lời của LLM, bảo vệ người dùng khỏi nhiều rủi ro và hỗ trợ các hoạt động AI có trách nhiệm. Cho dù bạn đang triển khai AI trong môi trường đám mây của mình hay trên các nhà cung cấp đám mây bên ngoài, Model Armor đều có thể giúp bạn ngăn chặn dữ liệu đầu vào độc hại, xác minh độ an toàn của nội dung, bảo vệ dữ liệu nhạy cảm, duy trì việc tuân thủ và thực thi nhất quán các chính sách an toàn và bảo mật AI trên toàn bộ hệ sinh thái AI đa dạng của bạn.

Khi Model Armor được bật cùng với tính năng ghi nhật ký được bật, Model Armor sẽ ghi nhật ký toàn bộ tải trọng. Điều này có thể làm lộ thông tin nhạy cảm trong nhật ký của bạn.

Định tuyến yêu cầu MCP đến Model Armor

Model Armor chỉ có ở một số khu vực. Khi bạn bật Model Armor và sử dụng máy chủ MCP ở một khu vực tài phán mà Model Armor không hỗ trợ, hành vi định tuyến của lệnh gọi có thể khác nhau đối với các máy chủ MCP khác nhau và có thể vi phạm quy định về việc lưu trữ dữ liệu đối với dữ liệu đang sử dụng và dữ liệu đang truyền. Để biết thêm thông tin về hành vi của từng máy chủ MCP, hãy xem bài viết Các sản phẩm được hỗ trợ của Model Armor.

Bật Model Armor

Làm theo các bước trong phần Tích hợp với máy chủ MCP của Google và Google Cloud để bật Model Armor.

Định cấu hình tính năng bảo vệ cho các máy chủ MCP từ xa

Để giúp bảo vệ các lệnh gọi và phản hồi của công cụ MCP, bạn có thể sử dụng chế độ cài đặt Model Armor floor. Chế độ cài đặt cơ bản xác định các bộ lọc bảo mật tối thiểu áp dụng trên toàn dự án. Cấu hình này áp dụng một bộ lọc nhất quán cho tất cả các lệnh gọi và phản hồi của công cụ MCP trong dự án.

Thiết lập chế độ cài đặt giá sàn Model Armor khi bật tính năng dọn dẹp MCP. Để biết thêm thông tin, hãy xem phần Định cấu hình chế độ cài đặt sàn Model Armor.

Hãy xem ví dụ về lệnh sau:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Thay PROJECT_ID bằng mã dự án của bạn.

Lưu ý các chế độ cài đặt sau:

INSPECT_AND_BLOCK: Loại thực thi kiểm tra nội dung cho máy chủ MCP của Google và chặn những câu lệnh và câu trả lời khớp với bộ lọc.
ENABLED: Chế độ cài đặt cho phép bộ lọc hoặc chế độ thực thi.
MEDIUM_AND_ABOVE: Mức độ tin cậy cho chế độ cài đặt bộ lọc AI có trách nhiệm – Nguy hiểm. Bạn có thể sửa đổi chế độ cài đặt này, mặc dù các giá trị thấp hơn có thể dẫn đến nhiều kết quả dương tính giả hơn. Để biết thêm thông tin, hãy xem phần Các mức độ tin cậy của Model Armor.

Tắt tính năng quét lưu lượng truy cập MCP bằng Model Armor

Để ngăn Model Armor tự động quét lưu lượng truy cập đến và đi từ các máy chủ MCP của Google dựa trên chế độ cài đặt sàn của dự án, hãy chạy lệnh sau:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Thay thế PROJECT_ID bằng mã dự án . Model Armor không tự động áp dụng các quy tắc được xác định trong chế độ cài đặt sàn của dự án này cho bất kỳ lưu lượng truy cập nào của máy chủ MCP của Google.

Chế độ cài đặt sàn Giáp mô hình và cấu hình chung có thể ảnh hưởng đến nhiều thứ hơn là chỉ MCP. Vì Model Armor tích hợp với các dịch vụ như Vertex AI, nên mọi thay đổi bạn thực hiện đối với chế độ cài đặt sàn có thể ảnh hưởng đến hoạt động quét lưu lượng truy cập và hành vi an toàn trên tất cả các dịch vụ tích hợp, chứ không chỉ MCP.

Điều chỉnh chế độ cài đặt 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.

Khắc phục sự cố

Nếu bạn gặp vấn đề khi kết nối hoặc truy vấn máy chủ MCP Kiến thức dành cho nhà phát triển, hãy tham khảo ma trận khắc phục sự cố và các bước giải quyết sau đây:

Ma trận khắc phục sự cố

Dấu hiệu hoặc lỗi	Nguyên nhân có thể xảy ra	Độ phân giải
`400 Bad Request: API key not valid`	Chuỗi khoá API bị thiếu, không hợp lệ hoặc sai định dạng.	Xác minh rằng bạn đã sao chép chính xác khoá API và định cấu hình khoá này trong đối tượng `headers` bằng khoá `X-Goog-Api-Key`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	Developer Knowledge API chưa được bật trong dự án Google Cloud.	Bật API trong Google Cloud Console hoặc chạy `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED: API target restriction`	Danh sách hạn chế khoá API không bao gồm Developer Knowledge API.	Cập nhật các chế độ hạn chế khoá API trên trang Thông tin xác thực trong Google Cloud Console để thêm Developer Knowledge API.
`401 UNAUTHENTICATED` hoặc thiếu thông tin đăng nhập ADC	Thông tin xác thực mặc định của ứng dụng đã hết hạn hoặc chưa được khởi tạo.	Chạy `gcloud auth application-default login --project=PROJECT_ID` để làm mới thông tin đăng nhập cục bộ.
`403 access_denied` / "Đã chặn quyền truy cập: lỗi uỷ quyền"	Tài khoản của bạn không được liệt kê là người dùng thử nghiệm được uỷ quyền trong quy trình đồng ý OAuth.	Trong Cloud Console > Xác thực > Đối tượng, hãy thêm địa chỉ email của bạn trong mục Người dùng thử nghiệm.
Lỗi ứng dụng OAuth hoặc URI chuyển hướng không hợp lệ	Ứng dụng OAuth được tạo bằng một loại ứng dụng không được hỗ trợ.	Tạo lại mã ứng dụng OAuth với loại được đặt thành Ứng dụng dành cho máy tính.
Điểm cuối `404 NOT_FOUND` trên `/mcp`	API này chưa được bật cho dự án của bạn.	Bật Developer Knowledge API trong Google Cloud Console hoặc chạy `gcloud services enable developerknowledge.googleapis.com`.
`429 RESOURCE_EXHAUSTED`	Bạn đã đạt đến hạn mức dự án.	Kiểm tra mức sử dụng hạn mức Developer Knowledge API trong bảng điều khiển và yêu cầu tăng hạn mức nếu cần.
`403 PERMISSION_DENIED` có Model Armor	Một kết quả dương tính giả từ bộ lọc PIJB của Model Armor đã chặn một truy vấn an toàn.	Đặt độ tin cậy của bộ lọc PIJB thành `HIGH_AND_ABOVE` trong phần cài đặt mẫu Model Armor.

Giải quyết lỗi xác thực và lỗi đồng ý

Cấu hình tiêu đề khoá API: Xác minh rằng cấu hình JSON MCP của bạn có phần headers với "X-Goog-Api-Key". Đừng truyền khoá API dưới dạng tham số truy vấn trong URL.
Người dùng kiểm thử trên màn hình xin phép OAuth: Khi bạn tạo một ứng dụng OAuth dành cho máy tính trong một dự án có loại người dùng bên ngoài ở chế độ kiểm thử, Google sẽ chặn quyền truy cập đối với những tài khoản không có trong danh sách người dùng kiểm thử. Đảm bảo bạn đã thêm địa chỉ email đang hoạt động của mình trên Google vào mục Đối tượng > Người dùng kiểm thử trong Cloud Console.
Hạn mức và giới hạn về tốc độ: Để theo dõi mức sử dụng hằng ngày và hằng phút, hãy chuyển đến phần IAM & Admin (IAM và Quản trị) > Quotas & System Limits (Hạn mức và giới hạn hệ thống) trong Bảng điều khiển Google Cloud rồi lọc theo Developer Knowledge API (API Kiến thức dành cho nhà phát triển).

Tài liệu đi kèm

Hãy xem Tài liệu tham khảo về ngữ liệu để biết danh sách đầy đủ các sản phẩm của Google và kho tài liệu được máy chủ lập chỉ mục.

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

Chỉ tài liệu công khai: Máy chủ chỉ lập chỉ mục tài liệu công khai có trong Tài liệu tham khảo về ngữ liệu. Không bao gồm các tài liệu nội bộ, kho lưu trữ riêng tư và tài nguyên của bên thứ ba.
Ngôn ngữ tiếng Anh: Máy chủ chỉ lập chỉ mục và trả về tài liệu bằng tiếng Anh.
Phần phụ thuộc mạng: Máy chủ cần có kết nối Internet đang hoạt động để truy cập vào https://developerknowledge.googleapis.com.

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

Chọn phương thức xác thực

Khóa API

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

Bật API và tạo khoá API

Google Cloud Console

gcloud CLI

OAuth và ADC

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

Bật API

Chọn loại thông tin đăng nhập OAuth

Thông tin xác thực mặc định của ứng dụng

Mã ứng dụng khách OAuth

Định cấu hình IDE hoặc tác nhân lập trình

Google Antigravity

Antigravity IDE và các tiện ích

Thông tin đăng nhập Google

Khóa API

Antigravity CLI

Thông tin đăng nhập Google

Khóa API

Claude Code

Con trỏ

GitHub Copilot

Chế độ cài đặt Workspace

Chế độ cài đặt chung cho người dùng

Codex

Khác

Xác minh kết nối

Tối ưu hoá cửa sổ ngữ cảnh và mức sử dụng mã thông báo

Cấu hình bảo mật và an toàn không bắt buộc

Sử dụng Model Armor

Định tuyến yêu cầu MCP đến Model Armor

Bật Model Armor

Định cấu hình tính năng bảo vệ cho các máy chủ MCP từ xa

Tắt tính năng quét lưu lượng truy cập MCP bằng Model Armor

Điều chỉnh chế độ cài đặt Model Armor

Khắc phục sự cố

Ma trận khắc phục sự cố

Giải quyết lỗi xác thực và lỗi đồng ý

Tài liệu đi kèm

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

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