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

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

หากต้องการเชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ Developer Knowledge จากแอปพลิเคชันหรือโค้ด Agent ของคุณเองแทน IDE โปรดดูหัวข้อเชื่อมต่อโดยใช้ MCP SDK

ความสามารถของเซิร์ฟเวอร์ 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 หรือรหัสไคลเอ็นต์ OAuth 2.0 แบบสแตนด์อโลนแทนคีย์ API

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

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

คีย์ API

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

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

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

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

Google Cloud Console

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

gcloud CLI

  1. เปิดใช้ Developer Knowledge API ในโปรเจ็กต์ โดยแทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ของคุณ

    gcloud services enable developerknowledge.googleapis.com \
      --project=PROJECT_ID
    
  2. สร้างคีย์ 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) คุณจะใช้เส้นทางนี้เพื่อจำกัดคีย์ในขั้นตอนถัดไป
  3. จำกัดคีย์สำหรับ Developer Knowledge API เพื่อช่วยป้องกันการใช้งานที่ไม่ได้รับอนุญาต แทนที่ KEY_NAME ด้วยเส้นทาง name แบบเต็มที่คัดลอกมาจากขั้นตอนก่อนหน้า

    gcloud services api-keys update KEY_NAME \
      --api-target=service=developerknowledge.googleapis.com
    
    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 ได้โดยส่งโทเค็นสำหรับผู้ถือที่มีอายุสั้นในส่วนหัว Authorization

  1. ตรวจสอบสิทธิ์ด้วยบัญชี Google และตั้งค่าโปรเจ็กต์โควต้าโดยทำดังนี้

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

  3. (ไม่บังคับ) หากคุณกำลังกำหนดค่าไคลเอ็นต์ MCP ของบุคคลที่สามที่ไม่มีการรองรับ ADC ในตัว ให้สร้างโทเค็นสำหรับผู้ถือ (ใช้ได้ 1 ชั่วโมง) เพื่อใช้ในส่วนหัว Authorization ของไคลเอ็นต์ ดังนี้

    gcloud auth application-default print-access-token
    

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

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

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

ขอบเขต OAuth

เซิร์ฟเวอร์ MCP ของ Developer Knowledge ยอมรับขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/cloud-platform: ขอบเขตเริ่มต้นที่ใช้โดยข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (ADC) และ gcloud CLI
  • https://www.googleapis.com/auth/devprofiles.full_control: ขอบเขตที่ใช้สำหรับขั้นตอนความยินยอมของรหัสไคลเอ็นต์ OAuth 2.0 และการค้นหาเซิร์ฟเวอร์ MCP
  • https://www.googleapis.com/auth/developerprofiles.readonly: ขอบเขตแบบอ่านอย่างเดียวที่รองรับสำหรับบัญชีบริการและข้อมูลเข้าสู่ระบบที่ไม่ต้องใช้หน้าจอขอความยินยอม OAuth ของผู้ใช้ปลายทาง

กำหนดค่า 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 โดยใช้การตั้งค่าในคลิกเดียว

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

คีย์ API

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

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

    {
      "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 หรือ Agent ของ 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 ในส่วนหัวของคำขอได้ ดังนี้

{
  "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 แบบสแตนด์อโลน ให้ทำดังนี้

  1. เพิ่มอุปกรณ์ปลายทางของเซิร์ฟเวอร์ MCP ลงในการกำหนดค่าไคลเอ็นต์โดยไม่มีส่วนหัวของคีย์ API ดังนี้

    {
      "mcpServers": {
        "google-developer-knowledge": {
          "url": "https://developerknowledge.googleapis.com/mcp"
        }
      }
    }
    
  2. ตั้งค่า OAuth ให้ลูกค้าจนเสร็จสมบูรณ์ โดยทำดังนี้

    • พรอมต์แบบอินเทอร์แอกทีฟ (เช่น VS Code): ส่งพรอมต์ทดสอบไปยัง Agent เมื่อได้รับข้อความแจ้งว่าระบบไม่รองรับ Dynamic Client Registration ให้ดำเนินการต่อและป้อนรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ จากนั้นลงชื่อเข้าใช้ด้วยบัญชี 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?

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

ใช้ทักษะ Agent ของ Developer Knowledge

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

ทักษะของ Agent คือชุดคำสั่งที่ผู้ช่วยเขียนโค้ด 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 อื่นๆ ที่รองรับมาตรฐาน Agent Skills แบบเปิด ให้เรียกใช้คำสั่งต่อไปนี้

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

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

npx skills update

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

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

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

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

  • ติดตั้งทักษะของ Agent (แนะนำ): ติดตั้งทักษะของ Agent 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

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

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 สแกนการเข้าชมไปยังและจากเซิร์ฟเวอร์ Google MCP โดยอัตโนมัติตามการตั้งค่าขั้นต่ำของโปรเจ็กต์ ให้เรียกใช้คำสั่งต่อไปนี้

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

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

การตั้งค่าพื้นและกำหนดค่าทั่วไปของ Model 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 ระยะไกลหรือเชื่อมต่อกับเซิร์ฟเวอร์ไม่ได้ ติดตั้งความสามารถของ Agent retrieving-developer-knowledge ซึ่งจะบอก Assistant ถึงวิธีสำรองข้อมูลไปยังปลายทาง 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 เพื่อรวม 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)