กำหนดค่าเซิร์ฟเวอร์ MCP ของ Chat

Google Chat มีเซิร์ฟเวอร์ Model Context Protocol (MCP) ระยะไกลที่ช่วยให้ Agent AI โต้ตอบกับข้อมูล Google Chat ได้อย่างปลอดภัย การกำหนดค่าเซิร์ฟเวอร์ Google Chat MCP จะช่วยให้แอปพลิเคชัน AI เช่น Gemini CLI, Claude หรือ IDE ดำเนินการใน Google Chat ได้

เซิร์ฟเวอร์ Google Chat MCP มีวิธีมาตรฐานสำหรับ Agent AI ในการดำเนินการต่อไปนี้

  • อ่านข้อมูล: แสดงรายการและค้นหาการสนทนา รวมถึงอ่านข้อความ
  • เคารพการรักษาความปลอดภัย: รับสิทธิ์และการควบคุมการกำกับดูแลข้อมูล แบบเดียวกับผู้ใช้

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

  • โปรเจ็กต์ Google Cloud หากต้องการสร้างโปรเจ็กต์ โปรดดู สร้างโปรเจ็กต์

  • ไคลเอ็นต์ MCP เช่น Gemini CLI

  • หากต้องการเรียกใช้คำสั่งในหน้านี้ ให้ตั้งค่า gcloud CLI ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ในเครื่องโดยทำตามขั้นตอนต่อไปนี้

    1. ติดตั้ง Google Cloud CLI หากคุณติดตั้ง gcloud CLI ไว้ก่อนหน้านี้แล้ว ให้ตรวจสอบว่าเครื่องมือเป็นเวอร์ชันล่าสุดโดยเรียกใช้ gcloud components update
    2. หากคุณใช้ผู้ให้บริการข้อมูลประจำตัว (IdP) ภายนอก ให้ลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวภายนอก ดูข้อมูลเพิ่มเติมได้ที่ หัวข้อลงชื่อเข้าใช้ gcloud CLI ด้วยข้อมูลประจำตัวภายนอก
    3. เริ่มต้น gcloud CLI

กำหนดค่าเซิร์ฟเวอร์ Google Chat MCP

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

เปิดใช้ API

หากต้องการใช้เซิร์ฟเวอร์ Google Chat MCP คุณต้องเปิดใช้ API ต่อไปนี้ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

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

คอนโซล

เปิดใช้ API ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้ API

เปิดใช้บริการ MCP

หากต้องการเปิดใช้คอมโพเนนต์ MCP สำหรับ Google Chat คุณต้องเปิดใช้บริการต่อไปนี้ในโปรเจ็กต์ Google Cloud

  • Google Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

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

คอนโซล

เปิดใช้บริการ MCP ในคอนโซล Google Cloud โดยทำดังนี้

เปิดใช้บริการ MCP

กำหนดค่าแอป Chat

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

  1. ในคอนโซล Google Cloud ให้ค้นหา Google Chat API แล้วคลิก Google Chat API > Manage > Configuration

    ไปที่ Google Chat API

  2. ตั้งค่าแอป Chat โดยทำดังนี้

    1. ป้อน Chat MCP ในช่องชื่อแอป
    2. ป้อน https://developers.google.com/chat/images/quickstart-app-avatar.png ในช่อง URL รูปโปรไฟล์
    3. ป้อน Chat MCP server ใน คำอธิบาย
    4. ในส่วนฟังก์ชันการทำงาน ให้ปิดฟีเจอร์แบบอินเทอร์แอกทีฟโดยสลับ เปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ เป็นปิด
    5. ในส่วนบันทึก ให้เลือกบันทึกข้อผิดพลาดลงใน Logging
  3. คลิกบันทึก

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างแอป Chat ได้ที่ หัวข้อเลือกสถาปัตยกรรมแอป Google Chat

เซิร์ฟเวอร์ Google Chat MCP ใช้ OAuth 2.0 ในการตรวจสอบสิทธิ์และการให้สิทธิ์ คุณต้องกำหนดค่าหน้าจอขอความยินยอม OAuth ก่อนจึงจะสร้างรหัสไคลเอ็นต์ OAuth ได้

  1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Branding

    ไปที่การสร้างแบรนด์

  2. หากคุณกำหนดค่า Google Auth Platform ไว้แล้ว คุณสามารถ กำหนดค่าการตั้งค่าหน้าจอขอความยินยอม OAuth ต่อไปนี้ในการ สร้างแบรนด์, กลุ่มเป้าหมาย, และ การเข้าถึงข้อมูล หากเห็นข้อความที่ระบุว่า Google Auth Platform not configured yet ให้คลิก Get Started โดยทำดังนี้

    1. ในส่วนข้อมูลแอป ให้พิมพ์ Chat MCP Server ในชื่อแอป
    2. ในส่วนอีเมลสำหรับติดต่อขอรับความช่วยเหลือจากผู้ใช้ ให้เลือกอีเมลหรือ Google Group ที่เหมาะสม
    3. คลิกถัดไป
    4. ในส่วนกลุ่มเป้าหมาย ให้เลือกภายใน หากเลือก ภายใน ไม่ได้ ให้เลือก ภายนอก
    5. คลิกถัดไป
    6. ในส่วนข้อมูลติดต่อ ให้ป้อนอีเมล ที่คุณต้องการรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลงในโปรเจ็กต์
    7. คลิกถัดไป
    8. ในส่วนเสร็จสิ้น ให้ตรวจสอบนโยบายข้อมูลผู้ใช้สำหรับบริการ Google API และหากยอมรับ ให้เลือกฉันยอมรับบริการ Google API: นโยบาย ข้อมูลผู้ใช้
    9. คลิกต่อไป
    10. คลิกสร้าง
    11. หากเลือกภายนอก สำหรับประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบโดยทำดังนี้
      1. คลิกกลุ่มเป้าหมาย
      2. ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
      3. ป้อนอีเมลของคุณและอีเมลของผู้ใช้ทดสอบที่ได้รับอนุญาตรายอื่นๆ แล้วคลิกบันทึก
  3. คลิกการเข้าถึงข้อมูล > เพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตสำหรับแต่ละ API ที่คุณเปิดใช้ในโปรเจ็กต์ Google Cloud

    1. ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตสำหรับ เซิร์ฟเวอร์ Google Chat MCP ดังนี้

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.users.readstate.readonly
    2. คลิกเพิ่มลงในตาราง

    3. คลิกอัปเดต

    4. หลังจากเลือกขอบเขตที่แอปกำหนดแล้ว ให้คลิกบันทึก ในหน้าการเข้าถึงข้อมูล

กำหนดค่าไคลเอ็นต์ MCP

หากต้องการเพิ่มเซิร์ฟเวอร์ Google Chat MCP ระยะไกลลงในไคลเอ็นต์ MCP ให้ทำตามวิธีการสำหรับไคลเอ็นต์

Gemini CLI

หากต้องการเพิ่มเซิร์ฟเวอร์ Google Chat MCP ระยะไกลลงใน Gemini CLI ให้เพิ่มการกำหนดค่าเซิร์ฟเวอร์ลงในไฟล์ settings.json

  1. สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 โดยทำดังนี้

    1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

    2. เลือกแอปเดสก์ท็อป เป็นประเภทแอปพลิเคชัน

    3. ป้อนชื่อ

    4. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์ และรหัสลับไคลเอ็นต์

  2. เปิดหรือสร้างไฟล์การกำหนดค่า ~/.gemini/settings.json

  3. เพิ่มการกำหนดค่า mcpServers ลงใน settings.json ดังนี้

    {
      "mcpServers": {
        "chat": {
          "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
          "oauth": {
            "enabled": true,
            "clientId": "OAUTH_CLIENT_ID",
            "clientSecret": "OAUTH_CLIENT_SECRET",
            "scopes": [
              "https://www.googleapis.com/auth/chat.spaces.readonly",
              "https://www.googleapis.com/auth/chat.memberships.readonly",
              "https://www.googleapis.com/auth/chat.messages.readonly",
              "https://www.googleapis.com/auth/chat.users.readstate.readonly"
            ]
          }
        }
      }
    }
    

    แทนที่ค่าต่อไปนี้

    • OAUTH_CLIENT_ID: รหัสไคลเอ็นต์ที่คุณสร้างขึ้น
    • OAUTH_CLIENT_SECRET: รหัสลับไคลเอ็นต์ที่คุณสร้างขึ้น
  4. บันทึก settings.json

  5. เริ่ม Gemini CLI โดยทำดังนี้

    gemini
    
  6. ใน Gemini CLI ให้ตรวจสอบสิทธิ์กับเซิร์ฟเวอร์ MCP โดยเรียกใช้คำสั่งต่อไปนี้

    /mcp auth chat
    
    1. เมื่อได้รับข้อความแจ้ง ให้กด 1 เพื่อเปิดหน้าการตรวจสอบสิทธิ์ใน เบราว์เซอร์ หากคุณทำงานผ่าน SSH ให้ทำตามวิธีการใน CLI
    2. ลงชื่อเข้าใช้บัญชี Google
    3. ตรวจสอบขอบเขต OAuth ที่ขอ แล้วคลิกอนุญาต
    4. ข้อความจะปรากฏขึ้นเพื่อยืนยันว่าการตรวจสอบสิทธิ์สำเร็จ
  7. ใน Gemini CLI ให้เรียกใช้ /mcp list เพื่อดูเซิร์ฟเวอร์ MCP ที่กำหนดค่าไว้และเครื่องมือของเซิร์ฟเวอร์

    การตอบกลับจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

    🟢 chat - Ready (2 tools)
      Tools:
      - search_conversations
      - list_messages
    

เซิร์ฟเวอร์ MCP ระยะไกลพร้อมใช้งานใน Gemini CLI แล้ว

Claude

หากต้องการใช้เซิร์ฟเวอร์ Google Chat MCP ระยะไกลกับ Claude.ai หรือ Claude Desktop คุณต้องมีแพ็กเกจ Claude Enterprise, Pro, Max หรือ Team

หากต้องการเพิ่มเซิร์ฟเวอร์ Google Chat MCP ระยะไกลลงใน Claude ให้กำหนดค่าตัวเชื่อมต่อที่กำหนดเองด้วยรหัสไคลเอ็นต์ OAuth และรหัสลับ

  1. สร้างรหัสไคลเอ็นต์และรหัสลับ OAuth 2.0 โดยทำดังนี้

    1. ในคอนโซล Google Cloud ให้ไปที่ Google Auth Platform > Clients > Create Client

      ไปที่สร้างไคลเอ็นต์

    2. เลือกเว็บแอปพลิเคชัน เป็นประเภทแอปพลิเคชัน

    3. ป้อนชื่อ

    4. ในส่วน Authorized redirect URIs ให้คลิก + Add URI, แล้วเพิ่ม https://claude.ai/api/mcp/auth_callback ในช่อง URIs

    5. คลิกสร้าง แล้วคัดลอกรหัสไคลเอ็นต์ และรหัสลับไคลเอ็นต์

  2. กำหนดค่าเซิร์ฟเวอร์ MCP ใน Claude โดยทำดังนี้

    1. ใน Claude.ai หรือ Claude Desktop ให้ไปที่การตั้งค่า (หรือการตั้งค่าของผู้ดูแลระบบ) > ตัวเชื่อมต่อ
    2. คลิกเพิ่มตัวเชื่อมต่อที่กำหนดเอง
    3. ป้อนรายละเอียดการเชื่อมต่อสำหรับผลิตภัณฑ์ Google Chat ดังนี้
      • ชื่อเซิร์ฟเวอร์: Google Chat.
      • URL เซิร์ฟเวอร์ MCP ระยะไกล: https://chatmcp.googleapis.com/mcp/v1
    4. ในการตั้งค่าขั้นสูง ให้ป้อนรหัสไคลเอ็นต์ OAuth และรหัสลับไคลเอ็นต์ OAuth
    5. คลิกเพิ่ม

อื่นๆ

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

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

ทดสอบเซิร์ฟเวอร์ Google Chat MCP

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

ลองถามคำถามต่อไปนี้กับไคลเอ็นต์ MCP

  • "ข้อความล่าสุดในพื้นที่ทำงาน 'โปรเจ็กต์ X' คืออะไร"

    ไคลเอ็นต์จะค้นหาพื้นที่ทำงานโดยใช้ search_conversations แล้วดึงข้อมูลข้อความโดยใช้ list_messages

หากเครื่องมือทำงานสำเร็จและคุณได้รับการตอบกลับที่เกี่ยวข้อง แสดงว่าเซิร์ฟเวอร์ Google Chat MCP ได้รับการกำหนดค่าอย่างถูกต้อง

การแก้ปัญหา

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

ข้อมูลอ้างอิงเครื่องมือ

เครื่องมือต่อไปนี้พร้อมใช้งานสำหรับเซิร์ฟเวอร์ Google Chat MCP

  • search_conversations
  • list_messages

ข้อควรพิจารณาด้านความปลอดภัยที่สำคัญ: การแทรกพรอมต์โดยอ้อม

เมื่อคุณเปิดเผยโมเดลภาษาต่อข้อมูลที่ไม่น่าเชื่อถือ จะมีความเสี่ยงที่จะเกิดการโจมตีแบบการแทรกพรอมต์โดยอ้อม เนื่องจากไคลเอ็นต์ MCP เช่น Gemini CLI มีสิทธิ์เข้าถึงเครื่องมือและ API ที่มีประสิทธิภาพผ่านเซิร์ฟเวอร์ Google Chat MCP จึงสามารถอ่าน แก้ไข และลบข้อมูลในบัญชี Google ได้

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

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