Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

เชื่อมต่อกับเซิร์ฟเวอร์ Developer Knowledge MCP

เซิร์ฟเวอร์ MCP ของ Google Developer Knowledge ช่วยให้เครื่องมือพัฒนาที่ทำงานด้วยระบบ AI เข้าถึง ค้นหาและดึงเอกสารประกอบอย่างเป็นทางการของ Google สำหรับนักพัฒนาซอฟต์แวร์สำหรับผลิตภัณฑ์ต่างๆ เช่น Firebase, Google Cloud, Android, Google Maps Platform และอื่นๆ ได้โดยตรง การเชื่อมต่อผู้ช่วยการเขียนโค้ดกับคลังเอกสารที่เชื่อถือได้ของ Google จะช่วยให้คุณไม่ต้องค้นหาเว็บด้วยตนเอง บริบทที่ล้าสมัย และการคัดลอกข้อมูล

ความสามารถของเซิร์ฟเวอร์ MCP

เซิร์ฟเวอร์ MCP ของ Google Developer Knowledge มีเครื่องมือหลัก 3 อย่างสำหรับผู้ช่วยการเขียนโค้ด AI ของคุณ ได้แก่

ชื่อเครื่องมือ	คำอธิบาย
`search_documents`	ค้นหาเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของ Google และแสดงตัวอย่างหน้าเว็บที่เกี่ยวข้องมากที่สุด พร้อมกับชื่อเอกสาร
`get_documents`	ดึงเนื้อหามาร์กดาวน์ทั้งหมดของเอกสารโดยใช้ชื่อที่ `search_documents` ส่งคืน
`answer_query`	สร้างคำตอบที่มีโครงสร้างซึ่งดึงมาจากคลังความรู้ของนักพัฒนาซอฟต์แวร์

search_documentsเครื่องมือนี้จะค้นหาเอกสารประกอบของ Google เพื่อค้นหาส่วนที่เกี่ยวข้องมากที่สุดซึ่งตรงกับคำค้นหาของคุณ เมื่อคุณถามคำถาม เครื่องมือ จะแสดงข้อความสั้นๆ หากเอเจนต์ต้องการบริบทของหน้าเว็บทั้งหมด ที่อยู่รอบๆ ข้อความ ก็สามารถส่งชื่อทรัพยากรของเอกสารไปยัง get_documents เพื่อดึงข้อมูลหน้าเว็บทั้งหมดได้

ใช้เครื่องมือ answer_query เมื่อต้องการคำตอบโดยตรงสำหรับคำถาม ที่ดึงมาจาก คลังความรู้สำหรับนักพัฒนาซอฟต์แวร์ แทนที่จะเป็นผลการค้นหาดิบหรือไฟล์ Markdown แบบเต็ม

เคล็ดลับ: จับคู่เซิร์ฟเวอร์ MCP ความรู้ของนักพัฒนาแอปกับทักษะเอเจนต์ของ retrieving-developer-knowledge ทักษะนี้จะให้คำสั่งในตัวแก่ผู้ช่วยการเขียนโค้ด AI เกี่ยวกับเครื่องมือที่จะเลือก วิธีจัดการข้อผิดพลาด และวิธีเรียก REST API หาก เซิร์ฟเวอร์ MCP ไม่พร้อมใช้งาน ดูข้อมูลเพิ่มเติมได้ที่ ใช้ทักษะเอเจนต์ความรู้สำหรับนักพัฒนาแอป

เลือกวิธีการตรวจสอบสิทธิ์

เซิร์ฟเวอร์ MCP ของ Developer Knowledge รองรับวิธีการตรวจสอบสิทธิ์ 2 วิธี ทั้งนี้ขึ้นอยู่กับสภาพแวดล้อมในการพัฒนาซอฟต์แวร์และผู้ช่วย AI ของคุณ

คีย์ API: เหมาะที่สุดสำหรับ IDE ของบุคคลที่สามและเอเจนต์ CLI เช่น Claude Code, Cursor, GitHub Copilot, Codex และไคลเอ็นต์ MCP ระยะไกลอื่นๆ ส่งคีย์ API ในส่วนหัว X-Goog-Api-Key ผ่าน HTTPS
OAuth และ ADC: เหมาะที่สุดสำหรับ Google Antigravity ซึ่งมีการรองรับในตัวสำหรับข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (ADC) หรือสำหรับเวิร์กโฟลว์ขององค์กรที่ต้องใช้โทเค็นสำหรับผู้ถือ OAuth 2.0 หรือรหัสไคลเอ็นต์ OAuth 2.0 แบบสแตนด์อโลนแทนคีย์ API

สร้างข้อมูลเข้าสู่ระบบที่จำเป็นสำหรับวิธีการตรวจสอบสิทธิ์ที่คุณเลือกเพื่อ อนุญาตให้ผู้ช่วย AI หรือเอเจนต์การเขียนโค้ดตรวจสอบสิทธิ์คำขอด้วย บริการเซิร์ฟเวอร์ MCP ของ Developer Knowledge

เลือกแท็บเพื่อสร้างข้อมูลเข้าสู่ระบบ

คีย์ API

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้ก่อนสร้างคีย์ API

โปรเจ็กต์ Google Cloud
ติดตั้ง gcloud CLI แล้ว (หากกำหนดค่าจากบรรทัดคำสั่ง)

เปิดใช้ API และสร้างคีย์ API

คุณสร้างคีย์ API ได้โดยใช้คอนโซล Google Cloud หรือ gcloud CLI

Google Cloud Console

เปิดหน้า Developer Knowledge API ในคอนโซล Google Cloud
เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google แล้วคลิกเปิดใช้
ไปที่หน้าข้อมูลเข้าสู่ระบบ
คลิกสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ API
คลิกการดำเนินการแก้ไขคีย์ API เพื่อกำหนดค่าข้อจำกัด
- ในส่วนข้อจำกัดของ API ให้เลือกจำกัดคีย์
- เลือก Developer Knowledge API
- หากคุณวางแผนที่จะใช้คีย์เดียวกันนี้สำหรับการเรียกโมเดล (เช่น GEMINI_API_KEY) ให้เลือก Generative Language API ด้วย
คลิกบันทึก แล้วคัดลอกคีย์ API

gcloud CLI

เปิดใช้ Developer Knowledge API ในโปรเจ็กต์ โดยแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
สร้างคีย์ API โดยทำดังนี้
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
คำสั่งนี้จะแสดงรายละเอียดข้อมูลเมตาเกี่ยวกับคีย์ใหม่ คัดลอกและ บันทึกค่าต่อไปนี้ทั้ง 2 ค่าจากเอาต์พุตจากคำสั่ง
- keyString: นี่คือคีย์ API ดิบ (เช่น AIzaSy...) คุณจะวางค่านี้ลงในการกำหนดค่า IDE
- name: นี่คือเส้นทางทรัพยากรของคีย์ (เช่น projects/PROJECT_ID/locations/global/keys/UNIQUE_ID) คุณ จะใช้เส้นทางนี้เพื่อจำกัดคีย์ในขั้นตอนถัดไป
จำกัดคีย์สำหรับ Developer Knowledge API เพื่อช่วยป้องกันการใช้งานที่ไม่ได้รับอนุญาต แทนที่ KEY_NAME ด้วยเส้นทาง name แบบเต็ม ที่คัดลอกจากขั้นตอนก่อนหน้า
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
สำคัญ: หากคุณวางแผนที่จะใช้คีย์เดียวกันนี้สำหรับการเรียกโมเดลทั่วไปของไคลเอ็นต์ AI (เช่น GEMINI_API_KEY) คุณต้อง
อนุญาต Generative Language API ด้วย
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth และ ADC

ข้อกำหนดเบื้องต้น

โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้ก่อนกำหนดค่า OAuth หรือ ADC

เปิดใช้ API

เรียกใช้คำสั่งต่อไปนี้เพื่อเปิดใช้ Developer Knowledge API ในโปรเจ็กต์

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

เลือกประเภทข้อมูลเข้าสู่ระบบ OAuth

เลือกแนวทางการรับรองที่เครื่องมือของคุณต้องการ

ADC

Google Antigravity มีการรองรับ ADC ในตัวและรีเฟรชโทเค็นโดยอัตโนมัติ ไคลเอ็นต์ MCP อื่นๆ สามารถใช้ ADC ได้โดยส่งโทเค็น Bearer ที่มีอายุสั้นในส่วนหัว Authorization

ตรวจสอบสิทธิ์ด้วยบัญชี Google และตั้งค่าโปรเจ็กต์โควต้าโดยทำดังนี้
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
เมื่อเบราว์เซอร์เปิดขึ้น ให้ลงชื่อเข้าใช้ด้วยบัญชี Google และให้สิทธิ์ที่ขอ
(ไม่บังคับ) หากกําลังกําหนดค่าไคลเอ็นต์ MCP ของบุคคลที่สามที่ ไม่มีการรองรับ ADC ในตัว ให้สร้างโทเค็นผู้ถือสิทธิ์ (มีอายุ 1 ชั่วโมง) เพื่อใช้ในส่วนหัว Authorization ของไคลเอ็นต์
```
gcloud auth application-default print-access-token
```

รหัสไคลเอ็นต์ OAuth

สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 หากผู้ช่วย AI ใช้ โฟลว์ OAuth แบบอินเทอร์แอกทีฟ เนื่องจากเซิร์ฟเวอร์ MCP ระยะไกลของ Google ไม่รองรับ การลงทะเบียนไคลเอ็นต์แบบไดนามิก (DCR) ของ OAuth

ไปที่หน้าการสร้างแบรนด์ แล้ว เลือกโปรเจ็กต์ ป้อนชื่อแอปและ อีเมลสำหรับการสนับสนุนผู้ใช้ แล้วคลิกบันทึก
ไปที่หน้ากลุ่มเป้าหมาย แล้วตั้งค่าประเภทผู้ใช้เป็นภายนอก
ในหน้าเดียวกัน ให้คลิกเพิ่มผู้ใช้ในส่วนผู้ใช้ทดสอบ ป้อน อีเมล Google ของคุณ แล้วคลิกบันทึก
ไปที่หน้าไคลเอ็นต์ คลิกสร้างไคลเอ็นต์ แล้วเลือกประเภทแอปพลิเคชันที่ไคลเอ็นต์ MCP ของคุณต้องการ
- เลือกแอปเดสก์ท็อปสำหรับไคลเอ็นต์เดสก์ท็อปที่แจ้งให้ระบุรหัสไคลเอ็นต์และข้อมูลลับ (เช่น VS Code)
- เลือกเว็บแอปพลิเคชัน แล้วเพิ่ม URI การเปลี่ยนเส้นทางของลูกค้า สำหรับลูกค้าที่ต้องใช้การเรียกกลับการเปลี่ยนเส้นทาง OAuth แบบคงที่ (เช่น ตัวเชื่อมต่อที่กำหนดเองของ Cursor หรือ Claude Code) ใช้ URI การเปลี่ยนเส้นทางที่ตรงกันทุกประการตามที่ไคลเอ็นต์ของคุณระบุไว้ ระบบไม่รองรับ URI การเปลี่ยนเส้นทางที่กำหนดเอง สำหรับ URI การเปลี่ยนเส้นทางที่เฉพาะเจาะจงของไคลเอ็นต์ โปรดดูที่ กำหนดค่า MCP ในแอปพลิเคชัน AI
คลิกสร้าง จากนั้นคัดลอกรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ (หรือดาวน์โหลดไฟล์ข้อมูลเข้าสู่ระบบไคลเอ็นต์ JSON)

กำหนดค่า IDE หรือ Agent การเขียนโค้ด

หลังจากได้รับข้อมูลเข้าสู่ระบบแล้ว ให้ทำตามวิธีการตั้งค่าสำหรับสภาพแวดล้อมการเขียนโค้ด วิธีการสำหรับสภาพแวดล้อมการเขียนโค้ดแต่ละรายการรองรับ วิธีการตรวจสอบสิทธิ์ต่อไปนี้

สภาพแวดล้อมการเขียนโค้ด	วิธีการตรวจสอบสิทธิ์
Google Antigravity	ข้อมูลเข้าสู่ระบบของ Google (ADC) หรือคีย์ API ในตัว
Claude Code, Cursor, GitHub Copilot, Codex	คีย์ API
อื่นๆ	คีย์ API, โทเค็นผู้ถือ ADC หรือรหัสไคลเอ็นต์ OAuth 2.0

หากต้องการใช้โทเค็นผู้ถือ ADC หรือรหัสไคลเอ็นต์ OAuth 2.0 กับ Claude Code, Cursor, GitHub Copilot หรือ Codex ให้ทำตามวิธีการในแท็บอื่นๆ

แทนที่ตัวยึดตำแหน่งต่อไปนี้ ทั้งนี้ขึ้นอยู่กับเทมเพลตที่คุณใช้

คีย์ API (YOUR_API_KEY): แทนที่ด้วยสตริงคีย์ API ดิบ
รหัสโปรเจ็กต์ (PROJECT_ID): แทนที่ด้วยรหัสโปรเจ็กต์ Google Cloud
โทเค็นเพื่อการเข้าถึง (ACCESS_TOKEN): แทนที่ด้วยโทเค็นผู้ถือจาก gcloud auth application-default print-access-token

Google Antigravity

Antigravity IDE และส่วนขยาย

หากต้องการกำหนดค่าเซิร์ฟเวอร์ MCP ใน Antigravity IDE หรือส่วนขยาย Antigravity (เช่น ใน VS Code) ให้เลือกวิธีการตรวจสอบสิทธิ์

ข้อมูลเข้าสู่ระบบของ Google

วิธีติดตั้งเซิร์ฟเวอร์ MCP โดยใช้การตั้งค่าในคลิกเดียว

ในแผงตัวแทน ให้คลิกเมนูตัวเลือกเพิ่มเติม () แล้วเลือก เซิร์ฟเวอร์ MCP
ค้นหา Google Developer Knowledge
คลิกไอคอนติดตั้ง () Antigravity จะกำหนดค่าเซิร์ฟเวอร์และเชื่อมต่อโดยอัตโนมัติ โดยใช้ข้อมูลเข้าสู่ระบบ Google ที่ใช้งานอยู่

คีย์ API

วิธีกำหนดค่าคีย์ API ใน Antigravity IDE หรือส่วนขยาย Antigravity

ในแผงตัวแทน ให้คลิกตัวเลือกเพิ่มเติม () เมนู > เซิร์ฟเวอร์ MCP > จัดการเซิร์ฟเวอร์ MCP > ดูการกำหนดค่าดิบ (หรือเปิด .agents/mcp_config.json)

เพิ่มการกำหนดค่าเซิร์ฟเวอร์ต่อไปนี้

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

Antigravity CLI

กำหนดค่าเซิร์ฟเวอร์ MCP ในไฟล์ .agents/mcp_config.json ของโปรเจ็กต์ (หรือทั่วโลกใน ~/.gemini/config/mcp_config.json) ดังนี้

ข้อมูลเข้าสู่ระบบของ 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"
      }
    }
  }
}

คีย์ API

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

Claude Code

เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

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

เคอร์เซอร์

หากต้องการกำหนดค่า Cursor ให้แก้ไข .cursor/mcp.json ในรูทของโปรเจ็กต์หรือ ~/.cursor/mcp.json เพื่อให้เข้าถึงได้ทั่วโลก

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

GitHub Copilot

การตั้งค่าพื้นที่ทำงาน

หากต้องการกำหนดค่า GitHub Copilot ใน VS Code สำหรับพื้นที่ทำงานที่เฉพาะเจาะจง ให้สร้างหรือ แก้ไข .vscode/mcp.json:

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

การตั้งค่าผู้ใช้ส่วนกลาง

หากต้องการทำให้เซิร์ฟเวอร์พร้อมใช้งานในพื้นที่ทํางาน VS Code ทั้งหมด ให้เปิด Command Palette เรียกใช้ MCP: Open User Configuration แล้วเพิ่มข้อมูลต่อไปนี้ ลงในไฟล์ mcp.json ในโปรไฟล์ผู้ใช้

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

Codex

หากต้องการกำหนดค่า Codex CLI หรือเอเจนต์ Codex ให้เพิ่มการกำหนดค่าเซิร์ฟเวอร์ลงใน ~/.codex/config.toml (หรือ .codex/config.toml ของโปรเจ็กต์):

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

อื่นๆ

หากต้องการกำหนดค่าไคลเอ็นต์ MCP ระยะไกลอื่นๆ (เช่น JetBrains AI Assistant, Windsurf, Cline, Zed, Continue หรือ Claude Desktop) หรือใช้โทเค็นผู้ถือ ADC หรือรหัสไคลเอ็นต์ OAuth 2.0 ในไคลเอ็นต์ของบุคคลที่สาม ให้เลือกวิธีการตรวจสอบสิทธิ์

คีย์ API

กำหนดค่าเซิร์ฟเวอร์การรับส่ง HTTP ด้วยการตั้งค่าต่อไปนี้

URL เซิร์ฟเวอร์: https://developerknowledge.googleapis.com/mcp
ส่วนหัว HTTP: X-Goog-Api-Key: YOUR_API_KEY

เทมเพลตการกำหนดค่า JSON มาตรฐาน

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

โทเค็นผู้ถือสิทธิ์ ADC

หากไคลเอ็นต์ MCP ไม่รองรับ ADC ในตัว คุณสามารถ ตรวจสอบสิทธิ์ด้วย ADC โดยส่งโทเค็นผู้ถือจาก gcloud auth application-default print-access-token และรหัสโปรเจ็กต์ Google Cloud ในส่วนหัวของคำขอได้ดังนี้

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

ส่วนหัว X-Goog-User-Project ต้องมีสิทธิ์ serviceusage.services.useในโปรเจ็กต์ เจ้าของโปรเจ็กต์ และเอดิเตอร์มีสิทธิ์นี้ ผู้ใช้รายอื่นต้องมีบทบาทที่มีสิทธิ์นี้ เช่น ผู้บริโภคการใช้บริการ (roles/serviceusage.serviceUsageConsumer)

รหัสไคลเอ็นต์ OAuth

หากต้องการตรวจสอบสิทธิ์โดยใช้รหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 แบบสแตนด์อโลน ให้ทำดังนี้

เพิ่มปลายทางของเซิร์ฟเวอร์ MCP ลงในการกำหนดค่าไคลเอ็นต์โดยไม่มีส่วนหัวของคีย์ API ดังนี้
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
หมายเหตุ: VS Code ใช้คีย์ระดับบนสุด servers แทน mcpServers เพิ่มเซิร์ฟเวอร์ลงใน .vscode/mcp.json ในโฟลเดอร์ ที่คุณเปิดเป็นพื้นที่ทำงาน หรือเรียกใช้ MCP: เปิดการกำหนดค่าผู้ใช้จาก Command Palette เพื่อให้ พร้อมใช้งานในพื้นที่ทำงานทั้งหมด สำหรับโครงสร้างไฟล์ VS Code โปรดดูแท็บ GitHub Copilot และละเว้นส่วน headers
ตั้งค่า OAuth ให้ลูกค้าจนเสร็จสมบูรณ์ โดยทำดังนี้
- พรอมต์แบบอินเทอร์แอกทีฟ (เช่น VS Code): ส่งพรอมต์ทดสอบไปยัง เอเจนต์ เมื่อได้รับข้อความแจ้งว่าไม่รองรับการลงทะเบียนไคลเอ็นต์แบบไดนามิก ให้ดำเนินการต่อและป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ จากนั้นลงชื่อเข้าใช้ด้วยบัญชี Google
- การกำหนดค่า OAuth แบบคงที่ (เช่น Cursor หรือ Claude Code): ระบุรหัสไคลเอ็นต์ OAuth, รหัสลับไคลเอ็นต์ และ URI การเปลี่ยนเส้นทางใน การตั้งค่า OAuth ของไคลเอ็นต์ ดูวิธีการสำหรับไคลเอ็นต์ที่เฉพาะเจาะจงได้ที่กำหนดค่า MCP ในแอปพลิเคชัน AI
หากลูกค้าขอให้คุณระบุขอบเขต OAuth ให้ใช้ https://www.googleapis.com/auth/devprofiles.full_control

คุณไม่จำเป็นต้องระบุรหัสโปรเจ็กต์ Google Cloud ในการกำหนดค่านี้ ระบบจะระบุแหล่งที่มาของคำขอไปยังโปรเจ็กต์ที่เป็นเจ้าของ รหัสไคลเอ็นต์ OAuth

ยืนยันการเชื่อมต่อ

เมื่อกำหนดค่าแล้ว ให้รีสตาร์ทผู้ช่วย AI หรือโหลดเซิร์ฟเวอร์ MCP ของผู้ช่วย AI อีกครั้ง จากนั้นส่งพรอมต์ทดสอบเพื่อยืนยันว่าการผสานรวมเครื่องมือทำงานได้ โดยทำดังนี้

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

หากตัวแทนเรียกใช้ search_documents หรือ answer_query และแสดงข้อมูลจากเอกสารประกอบของ Google แสดงว่าเซิร์ฟเวอร์ของคุณเชื่อมต่อและใช้งานได้

ใช้ทักษะของเอเจนต์ความรู้สำหรับนักพัฒนาซอฟต์แวร์

ติดตั้งทักษะเอเจนต์อย่างเป็นทางการของ retrieving-developer-knowledge เพื่อสอน Assistant ว่าเมื่อใดและอย่างไรจึงจะใช้เครื่องมือหลักที่เซิร์ฟเวอร์ MCP ความรู้สำหรับนักพัฒนาซอฟต์แวร์มีให้

ทักษะของเอเจนต์คือชุดคำสั่งที่ผู้ช่วยการเขียนโค้ด AI อ่าน ก่อนเริ่มงาน retrieving-developer-knowledge ทักษะนี้ใช้ได้กับผู้ช่วยทุกรายที่ รองรับมาตรฐานทักษะของเอเจนต์แบบเปิดและ ช่วยให้ผู้ช่วยทำสิ่งต่อไปนี้ได้

เลือกเครื่องมือที่เหมาะสม: แนะนำผู้ช่วยให้ใช้ answer_query สำหรับคำถามและคำถามเปรียบเทียบแบบกว้าง "วิธี" และ search_documents (โดยมีคีย์เวิร์ดที่เจาะจง 2-5 คำ) เมื่อค้นหาแฟล็ก CLI, สิทธิ์ IAM หรือไวยากรณ์ของโค้ดที่ตรงกัน
ตรวจสอบข้อผิดพลาดก่อนตอบ: บอกผู้ช่วยให้ตรวจสอบว่าการค้นหาเอกสารสำเร็จจริงก่อนที่จะเขียนคำตอบ เพื่อไม่ให้เข้าใจผิดว่าข้อผิดพลาดเกี่ยวกับคีย์ API หรือโควต้าเป็นเอกสารที่ขาดหายไป หรือกลับไปคาดเดาจากข้อมูลฝึกฝนเก่า
กลับไปใช้ REST API: ให้คำสั่งแก่ผู้ช่วยของคุณ curl เพื่อเรียกใช้ Developer Knowledge API โดยตรงหากเอดิเตอร์ไม่รองรับเซิร์ฟเวอร์ MCP หรือ การเชื่อมต่อ MCP ล้มเหลว

ติดตั้งทักษะของ Agent

เลือกผู้ช่วยเขียนโค้ดเพื่อติดตั้งretrieving-developer-knowledgeทักษะในไดเรกทอรีโปรเจ็กต์

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

เคอร์เซอร์

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

อื่นๆ

สำหรับผู้ช่วย AI อื่นๆ ที่รองรับมาตรฐานทักษะของเอเจนต์แบบเปิด ให้เรียกใช้คำสั่งต่อไปนี้

npx skills add google/skills --skill retrieving-developer-knowledge

หากต้องการอัปเดตทักษะที่ติดตั้งเป็นเวอร์ชันล่าสุด ให้เรียกใช้คำสั่งต่อไปนี้

npx skills update

ดูวิธีการและคู่มืออ้างอิงแบบเต็มของทักษะได้ที่ไดเรกทอรี retrieving-developer-knowledge ใน GitHub

เพิ่มประสิทธิภาพหน้าต่างบริบทและการใช้โทเค็น

การดึงหน้าเอกสารฉบับเต็มไปยังหน้าต่างบริบทของโมเดล AI จะใช้โทเค็นจำนวนมาก การส่งเอกสารขนาดใหญ่หลายรายการอาจทำให้มีค่าใช้จ่ายโทเค็นสูงขึ้น เวลาในการตอบสนองเพิ่มขึ้น และหน้าต่างบริบทเต็ม

โปรดทำตามแนวทางปฏิบัติแนะนำในการสร้างพรอมต์ต่อไปนี้เพื่อให้ได้รับการตอบกลับที่รวดเร็วและคุ้มค่า

ติดตั้งทักษะของเอเจนต์ (แนะนํา) ติดตั้งทักษะของเอเจนต์ retrieving-developer-knowledge เพื่อให้ผู้ช่วยของคุณ เลือกเครื่องมือค้นหาที่เหมาะสมโดยอัตโนมัติ (answer_query หรือ search_documents) ใช้การค้นหาคีย์เวิร์ดสั้นๆ และดาวน์โหลดเฉพาะหน้าเว็บแบบเต็ม เมื่อจําเป็นเท่านั้น
ใช้การดึงข้อมูลแบบ 2 ขั้นตอน: ให้ Agent เริ่มต้นด้วยการโทรหา search_documents ซึ่งจะแสดงตัวอย่าง (กลุ่ม) ที่โฟกัสซึ่งมักจะมีไวยากรณ์หรือลายเซ็น API ที่คุณต้องการโดยไม่ต้องใช้โทเค็นสำหรับทั้งหน้า สั่งให้ตัวแทน โทรหาget_documentsเฉพาะในกรณีที่จำเป็นอย่างยิ่งเท่านั้น
ใช้ answer_query สำหรับคำถามเชิงแนวคิด: เมื่อต้องการคำอธิบายที่สร้างขึ้นหรือการเปรียบเทียบการออกแบบ ให้ขอให้ ตัวแทนใช้ answer_query เครื่องมือนี้จะสร้างคำตอบจากคลังความรู้ของนักพัฒนาซอฟต์แวร์โดยตรง โดยไม่ต้องแสดงหน้า Markdown แบบดิบทั้งหมด
เขียนพรอมต์ที่เฉพาะเจาะจงและมีขอบเขต: หลีกเลี่ยงพรอมต์ที่กว้างเกินไป เช่น "อธิบาย Firebase ทั้งหมด" ให้ระบุผลิตภัณฑ์ แพลตฟอร์ม และภาษาเป้าหมายแทน
```
How do I write a Firestore transaction in Dart with error handling?
```
เพิ่มกฎของเอเจนต์ที่กำหนดเอง: หากไม่ได้ใช้retrieving-developer-knowledgeทักษะ ให้เพิ่มหลักเกณฑ์ระดับโปรเจ็กต์ ลงในไฟล์คำสั่งของผู้ช่วย (เช่น .cursorrules, CLAUDE.md หรือ .github/copilot-instructions.md) เพื่อจำกัดการดึงข้อมูลแบบเต็มหน้าอัตโนมัติ
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

การกำหนดค่าความปลอดภัยที่ไม่บังคับ

MCP ทำให้เกิดความเสี่ยงด้านความปลอดภัยและข้อควรพิจารณาใหม่ๆ เนื่องจากความหลากหลายของ การดำเนินการที่คุณทำได้ด้วยเครื่องมือ MCP Google Cloud มีการตั้งค่าเริ่มต้นและนโยบายที่ปรับแต่งได้เพื่อควบคุมการใช้เครื่องมือ MCP ในองค์กรหรือโปรเจ็กต์ Google Cloud เพื่อลดและจัดการความเสี่ยงเหล่านี้

ดูข้อมูลเพิ่มเติมเกี่ยวกับความปลอดภัยและการกำกับดูแล MCP ได้ที่ความปลอดภัยและความปลอดภัยของ AI

ใช้ Model Armor

Model Armor เป็นบริการของ Google Cloud ที่ออกแบบมาเพื่อเพิ่มความปลอดภัย ของแอปพลิเคชัน AI โดยจะทำงานด้วยการคัดกรองพรอมต์และคำตอบของ LLM ในเชิงรุก เพื่อป้องกันความเสี่ยงต่างๆ และสนับสนุนแนวทางปฏิบัติเกี่ยวกับ AI อย่างมีความรับผิดชอบ ไม่ว่าคุณจะติดตั้งใช้งาน AI ในสภาพแวดล้อมระบบคลาวด์หรือผู้ให้บริการระบบคลาวด์ภายนอก Model Armor ก็ช่วยป้องกันอินพุตที่เป็นอันตราย ยืนยันความปลอดภัยของเนื้อหา ปกป้องข้อมูลที่ละเอียดอ่อน รักษาการปฏิบัติตามข้อกำหนด และบังคับใช้นโยบายความปลอดภัยของ AI อย่างสม่ำเสมอในสภาพแวดล้อม AI ที่หลากหลาย

เมื่อเปิดใช้ Model Armor โดยเปิดใช้การบันทึก Model Armor จะบันทึกเพย์โหลดทั้งหมด ซึ่งอาจเปิดเผยข้อมูลที่ละเอียดอ่อนในบันทึก

การกำหนดเส้นทางการส่งคำขอ MCP ไปยัง Model Armor

Model Armor พร้อมให้บริการในบางภูมิภาค เมื่อเปิดใช้ Model Armor และคุณใช้เซิร์ฟเวอร์ MCP ในเขตอำนาจศาลที่ Model Armor ไม่รองรับ ลักษณะการกำหนดเส้นทางของการเรียกอาจแตกต่างกันสำหรับเซิร์ฟเวอร์ MCP ที่ต่างกัน และอาจละเมิดการปฏิบัติตามข้อกำหนดด้านการพำนักอาศัยของข้อมูลสำหรับข้อมูลที่ใช้งานและข้อมูลที่อยู่ระหว่างส่ง ดูข้อมูลเพิ่มเติมเกี่ยวกับลักษณะการทำงาน ของเซิร์ฟเวอร์ MCP แต่ละเครื่องได้ที่ ผลิตภัณฑ์ที่รองรับ Model Armor

เปิดใช้ Model Armor

ทำตามขั้นตอนใน ผสานรวมกับเซิร์ฟเวอร์ MCP ของ Google และ Google Cloud เพื่อเปิดใช้ Model Armor

กำหนดค่าการป้องกันสำหรับเซิร์ฟเวอร์ MCP ระยะไกล

คุณใช้ การตั้งค่าระดับต่ำสุดของ Model Armor เพื่อช่วยปกป้องการเรียกใช้และการตอบกลับของเครื่องมือ MCP ได้ การตั้งค่าระดับต่ำสุดจะกำหนดตัวกรองความปลอดภัยขั้นต่ำ ที่ใช้ในโปรเจ็กต์ การกำหนดค่านี้จะใช้ชุดตัวกรองที่สอดคล้องกันกับการเรียกใช้เครื่องมือ MCP และการตอบกลับทั้งหมดภายในโปรเจ็กต์

ตั้งค่าระดับต่ำสุดของ Model Armor โดยเปิดใช้การล้างข้อมูล MCP ดูข้อมูลเพิ่มเติมได้ที่กำหนดการตั้งค่า Model Armor floor

ดูตัวอย่างคำสั่งต่อไปนี้

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"}]'

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud

โปรดทราบการตั้งค่าต่อไปนี้

INSPECT_AND_BLOCK: ประเภทการบังคับใช้ที่ตรวจสอบเนื้อหาสำหรับเซิร์ฟเวอร์ MCP ของ Google และบล็อกพรอมต์และคำตอบที่ตรงกับตัวกรอง
ENABLED: การตั้งค่าที่เปิดใช้ตัวกรองหรือ การบังคับใช้
MEDIUM_AND_ABOVE: ระดับความเชื่อมั่นสำหรับการตั้งค่าตัวกรอง AI อย่างมีความรับผิดชอบ - อันตราย คุณสามารถแก้ไขการตั้งค่านี้ได้ แม้ว่าค่าที่ต่ำกว่าอาจทำให้เกิดผลบวกลวงมากขึ้นก็ตาม ดูข้อมูลเพิ่มเติมได้ที่ระดับความเชื่อมั่นของ Model Armor

ปิดใช้การสแกนการรับส่งข้อมูล MCP ด้วย Model Armor

หากต้องการหยุดไม่ให้ Model Armor สแกนการรับส่งข้อมูลไปยังและจากเซิร์ฟเวอร์ MCP ของ Google โดยอัตโนมัติตามการตั้งค่าพื้นฐานของโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

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

แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Model Armor จะไม่ใช้กฎที่กำหนดไว้ในการตั้งค่าราคาขั้นต่ำของโปรเจ็กต์นี้กับทราฟิกเซิร์ฟเวอร์ Google MCP โดยอัตโนมัติ

การตั้งค่าราคาต่ำสุดของโมเดล Armor และการกำหนดค่าทั่วไปอาจส่งผลต่อมากกว่าแค่ MCP เนื่องจาก Model Armor ผสานรวมกับบริการต่างๆ เช่น Vertex AI การเปลี่ยนแปลงใดๆ ที่คุณทําในการตั้งค่าขั้นต่ำอาจส่งผลต่อการสแกนการเข้าชมและลักษณะการทำงานด้านความปลอดภัยในบริการที่ผสานรวมทั้งหมด ไม่ใช่แค่ MCP

ปรับการตั้งค่า Model Armor

หากคุณใช้ Model Armor เพื่อปกป้องแอปพลิเคชัน คุณอาจพบ403 PERMISSION_DENIEDข้อผิดพลาด สำหรับการค้นหาบางรายการ เนื่องจากเซิร์ฟเวอร์ Developer Knowledge MCP จะแสดงเฉพาะเอกสารประกอบสาธารณะจากแหล่งที่มาของ Google ที่เชื่อถือได้ เราจึงขอแนะนำให้ตั้งค่าตัวกรองการแทรกพรอมต์และการหลบเลี่ยง (PIJB) เป็นระดับความเชื่อมั่น HIGH_AND_ABOVE เพื่อลดผลบวกลวง หากกรณีการใช้งานของคุณไม่เกี่ยวข้องกับเครื่องมืออื่นๆ ที่เข้าถึงข้อมูลส่วนตัวหรือข้อมูลที่ละเอียดอ่อน คุณก็อาจพิจารณาปิดใช้ตัวกรอง PIJB ได้เช่นกัน

การแก้ปัญหา

หากพบปัญหาในการเชื่อมต่อหรือการค้นหาเซิร์ฟเวอร์ MCP ของ Developer Knowledge ให้ค้นหาอาการหรือข้อความแสดงข้อผิดพลาดในตารางต่อไปนี้

ข้อผิดพลาดในการตั้งค่าและการเชื่อมต่อ

อาการหรือข้อผิดพลาด	สาเหตุที่น่าจะทำให้เกิดปัญหา	ความละเอียด
`404 NOT_FOUND` ในปลายทาง `/mcp`	ไม่ได้เปิดใช้ API สำหรับโปรเจ็กต์ของคุณ	เปิดใช้ Developer Knowledge API ในคอนโซล Google Cloud หรือเรียกใช้ `gcloud services enable developerknowledge.googleapis.com`
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	ไม่ได้เปิดใช้ Developer Knowledge API ในโปรเจ็กต์ Google Cloud	เปิดใช้ API ในคอนโซล Google Cloud หรือเรียกใช้ `gcloud services enable developerknowledge.googleapis.com`
ไม่มีเครื่องมือ MCP หรือเชื่อมต่อไม่สำเร็จ	เครื่องมือเขียนโค้ดของคุณไม่รองรับเซิร์ฟเวอร์ HTTP MCP ระยะไกลหรือเชื่อมต่อกับเซิร์ฟเวอร์ไม่ได้	ติดตั้ง`retrieving-developer-knowledge`เอเจนต์ ทักษะ ซึ่งจะบอกผู้ช่วยให้ทราบวิธีกลับไปใช้ ปลายทาง REST ของ Developer Knowledge API โดยใช้ `curl` เมื่อเครื่องมือ MCP ไม่พร้อมใช้งาน

ข้อผิดพลาดเกี่ยวกับคีย์ API

อาการหรือข้อผิดพลาด	สาเหตุที่น่าจะทำให้เกิดปัญหา	ความละเอียด
`400 Bad Request: API key not valid`	ไม่มีสตริงคีย์ API, สตริงไม่ถูกต้อง หรือมีรูปแบบไม่ถูกต้อง	ตรวจสอบว่าได้คัดลอกคีย์ API อย่างถูกต้องและกำหนดค่าในออบเจ็กต์ `headers` ที่มีคีย์ `X-Goog-Api-Key` อย่าส่งคีย์ API เป็นพารามิเตอร์การค้นหาใน URL
`403 PERMISSION_DENIED: API target restriction`	รายการข้อจํากัดของคีย์ API จะไม่รวม Developer Knowledge API	อัปเดตข้อจำกัดของคีย์ API ในหน้าข้อมูลเข้าสู่ระบบใน Google Cloud Console เพื่อรวม Developer Knowledge API

ข้อผิดพลาดเกี่ยวกับ OAuth และ ADC

อาการหรือข้อผิดพลาด	สาเหตุที่น่าจะทำให้เกิดปัญหา	ความละเอียด
`401 UNAUTHENTICATED` หรือไม่มีข้อมูลเข้าสู่ระบบ ADC	โทเค็นสำหรับผู้ถือข้อมูลรับรองเริ่มต้นของแอปพลิเคชันหรือ ADC หมดอายุหรือไม่ได้ เริ่มต้น	เรียกใช้ `gcloud auth application-default login --project=PROJECT_ID` เพื่อรีเฟรชข้อมูลเข้าสู่ระบบในเครื่อง หรือเรียกใช้ `gcloud auth application-default print-access-token` เพื่อ สร้างโทเค็นผู้ถือใหม่
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	คำขอใช้โทเค็นผู้ถือ ADC โดยไม่มีส่วนหัว `X-Goog-User-Project`	เพิ่มส่วนหัว `X-Goog-User-Project` พร้อมรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google Cloud ลงในการกำหนดค่าไคลเอ็นต์ MCP
`403 PERMISSION_DENIED` โดยมีส่วนหัว `X-Goog-User-Project`	บัญชีของคุณไม่มีสิทธิ์ `serviceusage.services.use` ในโปรเจ็กต์ในส่วนหัว	ขอให้ผู้ดูแลโปรเจ็กต์มอบบทบาทผู้บริโภคของการใช้บริการ (`roles/serviceusage.serviceUsageConsumer`) ให้คุณ
`403 access_denied` / "การเข้าถึงถูกบล็อก: เกิดข้อผิดพลาดในการให้สิทธิ์"	หน้าจอขอความยินยอม OAuth ของคุณใช้ประเภทผู้ใช้ภายนอกในโหมดทดสอบ และบัญชีของคุณไม่ได้อยู่ในรายชื่อผู้ใช้ทดสอบ	ใน Google Cloud Console > Auth Platform > Audience ให้เพิ่ม อีเมล Google ที่ใช้งานอยู่ภายใต้ผู้ใช้ทดสอบ
ข้อผิดพลาดของไคลเอ็นต์ OAuth หรือ URI การเปลี่ยนเส้นทางไม่ถูกต้อง	สร้างไคลเอ็นต์ OAuth ด้วยประเภทแอปพลิเคชันที่ไม่รองรับหรือ ไม่มี URI การเปลี่ยนเส้นทาง	ใช้แอปเดสก์ท็อปสำหรับไคลเอ็นต์ที่มีพรอมต์แบบอินเทอร์แอกทีฟ (เช่น VS Code) หรือเว็บแอปพลิเคชันที่มี URI เปลี่ยนเส้นทางที่ได้รับอนุญาตของไคลเอ็นต์ (เช่น Cursor หรือ Claude Code)

ข้อผิดพลาดเกี่ยวกับโควต้าและตัวกรองความปลอดภัย

อาการหรือข้อผิดพลาด	สาเหตุที่น่าจะทำให้เกิดปัญหา	ความละเอียด
`429 RESOURCE_EXHAUSTED`	คุณใช้งานถึงขีดจำกัดโควต้าของโปรเจ็กต์แล้ว	ตรวจสอบการใช้งานของคุณใน หน้าโควต้า Developer Knowledge API ในคอนโซล Google Cloud ดูข้อมูลเกี่ยวกับขีดจำกัดและขอเพิ่มได้ที่ โควต้า Developer Knowledge API
`403 PERMISSION_DENIED` ด้วย Model Armor	ผลบวกเท็จจากตัวกรอง PIJB ของ Model Armor บล็อกคำค้นหาที่ปลอดภัย	ตั้งค่าความเชื่อมั่นของตัวกรอง PIJB เป็น `HIGH_AND_ABOVE` ใน การตั้งค่าเทมเพลต Model Armor

เอกสารที่รวมอยู่ด้วย

ดูรายการผลิตภัณฑ์และที่เก็บเอกสารทั้งหมดของ Google ที่เซิร์ฟเวอร์จัดทำดัชนีได้ในการอ้างอิงคลังข้อความ

ข้อจำกัดที่ทราบ

เอกสารสาธารณะเท่านั้น: เซิร์ฟเวอร์จะจัดทำดัชนีเฉพาะเอกสารที่เผยแพร่ต่อสาธารณะ ซึ่งระบุไว้ใน การอ้างอิงคลังข้อมูล ระบบจะไม่รวมเอกสารภายใน ที่เก็บส่วนตัว และแหล่งข้อมูลของบุคคลที่สาม
ภาษาอังกฤษ: เซิร์ฟเวอร์จะจัดทำดัชนีและแสดงเอกสารประกอบเป็นภาษาอังกฤษเท่านั้น
การขึ้นอยู่กับเครือข่ายและการควบคุมบริการ VPC: เนื่องจากเซิร์ฟเวอร์ MCP ของ Developer Knowledge เป็นบริการที่โฮสต์จากระยะไกล ไคลเอ็นต์ของคุณจึงต้องมีการเชื่อมต่อเครือข่ายเพื่อเข้าถึง https://developerknowledge.googleapis.com
- ภายในเครือข่าย VPC ของ Google Cloud: ไม่จำเป็นต้องมีการส่งออกอินเทอร์เน็ตสาธารณะ คุณสามารถเข้าถึง developerknowledge.googleapis.com แบบส่วนตัว โดยไม่ต้องใช้ที่อยู่ IP ภายนอกหรือ Cloud NAT โดยการกำหนดเส้นทางการรับส่งข้อมูลโดยใช้ การเข้าถึง Google แบบส่วนตัว (private.googleapis.com / 199.36.153.8/30) หรือปลายทาง Private Service Connect (PSC) ที่กำหนดเป้าหมายไปยังแพ็กเกจ all-apis
- การควบคุมบริการ VPC (VPC-SC): developerknowledge.googleapis.com ไม่รองรับใน VIP ที่จำกัด (restricted.googleapis.com / 199.36.153.4/30) หรือปลายทาง PSC vpc-sc หาก VPC ของคุณกำหนดเส้นทาง *.googleapis.com ไปยัง restricted.googleapis.com ให้กำหนดค่านโยบายการตอบกลับของ Cloud DNS หรือระเบียน DNS ส่วนตัวสำหรับ developerknowledge.googleapis.com เพื่อแก้ไขเป็น private.googleapis.com (199.36.153.8/30)