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 ของ 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 แบบสแตนด์อโลน

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

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

คีย์ API

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

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

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

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

คุณสร้างคีย์ API ได้โดยใช้ Google Cloud Console หรือ 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

เปิดใช้ API

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

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

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

เลือกวิธีการใช้ข้อมูลเข้าสู่ระบบที่เครื่องมือของคุณกำหนด

ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน

หากผู้ช่วย AI รองรับ ADC (เช่น Google Antigravity) ให้ทำดังนี้

ตรวจสอบสิทธิ์ด้วยบัญชี Google และตั้งค่าโปรเจ็กต์โควต้า
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
เมื่อเบราว์เซอร์เปิดขึ้น ให้ลงชื่อเข้าใช้ด้วยบัญชี Google และให้สิทธิ์ที่ขอ

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

หากผู้ช่วย AI ของคุณต้องใช้รหัสไคลเอ็นต์และรหัสลับ OAuth แบบสแตนด์อโลน ให้ทำดังนี้

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

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

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

แทนที่ตัวยึดตำแหน่งในเทมเพลตการกำหนดค่าตามวิธีการตรวจสอบสิทธิ์ที่คุณเลือก ดังนี้

การตรวจสอบสิทธิ์ด้วยคีย์ API: แทนที่ YOUR_API_KEY ด้วย สตริงคีย์ API ดิบ
การตรวจสอบสิทธิ์ OAuth หรือ ADC: แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ Google Cloud ของคุณ

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 ทั้งหมด ให้เปิด การตั้งค่าผู้ใช้ (JSON) แล้วเพิ่มรายการต่อไปนี้ภายใต้คีย์ "mcp"

{
  "mcp": {
    "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) ให้กำหนดค่าเซิร์ฟเวอร์การรับส่ง 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"
      }
    }
  }
}

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

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

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

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

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

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

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

ใช้การดึงข้อมูลแบบ 2 ขั้นตอน ให้ตัวแทนเริ่มด้วยการโทรหา search_documents ซึ่งจะแสดงตัวอย่าง (กลุ่ม) ที่โฟกัสซึ่งมักจะมีไวยากรณ์หรือลายเซ็น API ที่คุณต้องการโดยไม่ต้องใช้โทเค็นสำหรับทั้งหน้า สั่งให้ตัวแทน เรียกใช้ get_documents เฉพาะเมื่อจำเป็นอย่างยิ่งในบริบทโดยรอบ
ใช้ answer_query สำหรับคำถามเชิงแนวคิด เมื่อต้องการคำอธิบายที่สังเคราะห์ขึ้นหรือการเปรียบเทียบการออกแบบ ให้ขอให้ ตัวแทนใช้ answer_query เครื่องมือนี้จะสังเคราะห์คำตอบจากคลังความรู้ของนักพัฒนาซอฟต์แวร์โดยตรง โดยไม่ต้องแสดงหน้า Markdown แบบดิบทั้งหมด
เขียนพรอมต์ที่เฉพาะเจาะจงและมีขอบเขต: หลีกเลี่ยงพรอมต์ที่กว้างเกินไป เช่น "อธิบาย Firebase ทั้งหมด" แต่ให้ระบุผลิตภัณฑ์ แพลตฟอร์ม และภาษาเป้าหมายแทน ดังนี้
```
How do I write a Firestore transaction in Dart with error handling?
```
เพิ่มกฎของเอเจนต์ที่กำหนดเอง เพิ่มหลักเกณฑ์ระดับโปรเจ็กต์ลงในไฟล์คำสั่งของผู้ช่วย (เช่น .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 ด้วย รหัสโปรเจ็กต์

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

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

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

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

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

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

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

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

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

การแก้ปัญหา

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

เมทริกซ์การแก้ปัญหา

อาการหรือข้อผิดพลาด	สาเหตุที่น่าจะทำให้เกิดปัญหา	ความละเอียด
`400 Bad Request: API key not valid`	สตริงคีย์ API ขาดหายไป ไม่ถูกต้อง หรือมีรูปแบบไม่ถูกต้อง	ตรวจสอบว่าได้คัดลอกคีย์ API อย่างถูกต้องและกำหนดค่าในออบเจ็กต์ `headers` ที่มีคีย์ `X-Goog-Api-Key`
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	ไม่ได้เปิดใช้ Developer Knowledge API ในโปรเจ็กต์ Google Cloud	เปิดใช้ API ในคอนโซล Google Cloud หรือเรียกใช้ `gcloud services enable developerknowledge.googleapis.com`
`403 PERMISSION_DENIED: API target restriction`	รายการข้อจำกัดของคีย์ API จะไม่รวม Developer Knowledge API	อัปเดตข้อจำกัดคีย์ API ในหน้าข้อมูลเข้าสู่ระบบในคอนโซล Google Cloud เพื่อรวม Developer Knowledge API
`401 UNAUTHENTICATED` หรือไม่มีข้อมูลเข้าสู่ระบบ ADC	ข้อมูลรับรองเริ่มต้นของแอปพลิเคชันหมดอายุหรือยังไม่ได้เริ่มต้น	เรียกใช้ `gcloud auth application-default login --project=PROJECT_ID` เพื่อรีเฟรชข้อมูลเข้าสู่ระบบในเครื่อง
`403 access_denied` / "การเข้าถึงถูกบล็อก: เกิดข้อผิดพลาดในการให้สิทธิ์"	บัญชีของคุณไม่ได้อยู่ในรายชื่อผู้ใช้ทดสอบที่ได้รับอนุญาตในความยินยอม OAuth	ใน Google Cloud Console > แพลตฟอร์มการตรวจสอบสิทธิ์ > ผู้ชม ให้เพิ่ม อีเมลในส่วนผู้ใช้ทดสอบ
ข้อผิดพลาดของไคลเอ็นต์ OAuth หรือ URI การเปลี่ยนเส้นทางที่ไม่ถูกต้อง	ไคลเอ็นต์ OAuth สร้างขึ้นด้วยประเภทแอปพลิเคชันที่ไม่รองรับ	สร้างรหัสไคลเอ็นต์ OAuth อีกครั้งโดยตั้งค่าประเภทเป็น แอปเดสก์ท็อป
`404 NOT_FOUND` ในอุปกรณ์ปลายทาง `/mcp`	ไม่ได้เปิดใช้ API สำหรับโปรเจ็กต์ของคุณ	เปิดใช้ Developer Knowledge API ในคอนโซล Google Cloud หรือเรียกใช้ `gcloud services enable developerknowledge.googleapis.com`
`429 RESOURCE_EXHAUSTED`	คุณใช้งานถึงขีดจำกัดโควต้าของโปรเจ็กต์แล้ว	ตรวจสอบการใช้โควต้า Developer Knowledge API ใน คอนโซลและขอเพิ่มโควต้าหากจำเป็น
`403 PERMISSION_DENIED` ที่มี Model Armor	ผลบวกเท็จจากตัวกรอง PIJB ของ Model Armor บล็อกคำค้นหาที่ปลอดภัย	ตั้งค่าความเชื่อมั่นของตัวกรอง PIJB เป็น `HIGH_AND_ABOVE` ในการตั้งค่าเทมเพลต Model Armor

แก้ไขข้อผิดพลาดในการตรวจสอบสิทธิ์และความยินยอม

การกำหนดค่าส่วนหัวของคีย์ API: ตรวจสอบว่าการกำหนดค่า JSON ของ MCP มีส่วน headers ที่มี "X-Goog-Api-Key" อย่าส่งคีย์ API เป็นพารามิเตอร์การค้นหาใน URL
ผู้ใช้ทดสอบหน้าจอขอความยินยอม OAuth เมื่อสร้างไคลเอ็นต์ OAuth บนเดสก์ท็อปในโปรเจ็กต์ที่มีผู้ใช้ภายนอก ประเภทในโหมดทดสอบ Google จะบล็อกการเข้าถึงสำหรับบัญชีที่ไม่ได้อยู่ในส่วน ผู้ใช้ทดสอบ ตรวจสอบว่าได้เพิ่มอีเมล Google ที่ใช้งานอยู่ไว้ในส่วน กลุ่มเป้าหมาย > ผู้ใช้ทดสอบในคอนโซล Google Cloud แล้ว
โควต้าและขีดจำกัดอัตรา: หากต้องการตรวจสอบการใช้งานรายวันและต่อนาที ให้ไปที่ IAM และผู้ดูแลระบบ > โควต้าและขีดจำกัดของระบบในคอนโซล Google Cloud แล้ว กรองตาม Developer Knowledge API

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

ดูรายการผลิตภัณฑ์และที่เก็บเอกสารของ 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)