ตั้งค่าเทมเพลตแอป Snowflake ใน ChatGPT

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

การตั้งค่าส่วนใหญ่ทำใน Snowflake เมื่อ Snowflake พร้อมแล้ว ให้เชื่อมต่อเทมเพลต Snowflake ใน ChatGPT ให้เสร็จ จากนั้นเปิดใช้งานปลั๊กอิน Snowflake ที่ใช้เทมเพลตนั้น

• OAuth ในตัว: หากบัญชี Snowflake ของคุณและ ChatGPT รองรับ ให้ใช้แอปพลิเคชันพาร์ทเนอร์ ChatGPT ที่ผู้ดูแล Snowflake เปิดใช้งานไว้ ลงชื่อเข้าใช้ Snowflake โดยใช้ SSO ขององค์กรหากตั้งค่าไว้ คุณไม่จำเป็นต้องป้อน ID ไคลเอนต์หรือข้อมูลลับของไคลเอนต์ใน ChatGPT ทำตามหัวข้อ OAuth ในตัวด้านล่าง

• ไคลเอนต์ OAuth แบบกำหนดเอง: ใช้วิธีนี้หากองค์กรของคุณกำหนดให้ใช้ไคลเอนต์ OAuth ของตนเอง หรือไม่มี OAuth ในตัวให้ใช้งาน ทำตามหัวข้อไคลเอนต์ OAuth แบบกำหนดเองด้านล่าง

OAuth ทั้งสองวิธีต้องตั้งค่าเซิร์ฟเวอร์ MCP ส่วนที่ใช้ร่วมกัน กำหนดสิทธิ์ในออบเจ็กต์ที่เกี่ยวข้อง และอนุญาตการเข้าถึงเครือข่ายตามที่อธิบายด้านล่าง ตั้งค่าส่วนที่ใช้ร่วมกันให้เสร็จจนถึงหัวข้อป้อนรายละเอียดเซิร์ฟเวอร์ Snowflake ใน ChatGPT ก่อนกำหนดค่า OAuth

สิ่งที่คุณกำลังตั้งค่า

คุณกำลังสร้างเซิร์ฟเวอร์ MCP ที่จัดการโดย Snowflake เพื่อทำหน้าที่เป็น endpoint ของตัวเชื่อมต่อสำหรับ ChatGPT เซิร์ฟเวอร์ MCP กำหนดว่า:

• ChatGPT ใช้การดำเนินการใดได้บ้าง

• เครื่องมือเหล่านั้นเข้าถึงข้อมูลหรือออบเจ็กต์ใดใน Snowflake ได้บ้าง

• ผู้ใช้แต่ละคนใช้บทบาท Snowflake ใดในการอนุญาต

• ใช้ฐานข้อมูล, Schema และชื่อเซิร์ฟเวอร์ MCP ใดใน Snowflake เพื่อระบุ endpoint

จากนั้นให้กำหนดค่า Snowflake - เทมเพลตอย่างเป็นทางการ ใน ChatGPT ด้วย URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่มีการจัดการ หน้าจอตั้งค่าเทมเพลตอาจแสดง URL แยกเป็นสี่ช่อง:

• คำนำหน้าชื่อโฮสต์ Snowflake

• ฐานข้อมูล

• Schema

• ชื่อเซิร์ฟเวอร์ MCP

ChatGPT จะค้นพบและใช้ได้เฉพาะเครื่องมือที่เซิร์ฟเวอร์ MCP เปิดให้ใช้งาน และบทบาท Snowflake ที่ผู้ใช้ใช้ในการอนุญาตมีสิทธิ์ใช้งานเท่านั้น

ก่อนเริ่มต้น

คุณต้องมี:

• สิทธิ์ผู้ดูแลหรือเจ้าของเวิร์กสเปซ ChatGPT หรือสิทธิ์ใช้งาน ChatGPT Plus หรือ Pro

• สิทธิ์ใน Snowflake ที่สร้างออบเจ็กต์เซิร์ฟเวอร์ MCP และให้สิทธิ์ได้

• ฐานข้อมูลและ Schema ของ Snowflake ที่จะใช้เก็บเซิร์ฟเวอร์ MCP

• ข้อสรุปว่าจะอนุญาตให้ ChatGPT ทำอะไรได้บ้าง เช่น ใช้ Cortex Search, Cortex Analyst, SQL แบบอ่านอย่างเดียว หรือโพรซีเยอร์หรือฟังก์ชันเฉพาะ

• บทบาท Snowflake ที่มีสิทธิ์เท่าที่จำเป็น สำหรับให้ผู้ใช้ใช้ในการอนุญาตแอป

• คำนำหน้าชื่อโฮสต์ของบัญชี Snowflake รวมถึงส่วนต่อท้ายที่ระบุภูมิภาคหรือคลาวด์ หากมี

หากบัญชี Snowflake ของคุณจำกัดการเข้าถึงด้วยนโยบายเครือข่ายหรือรายการ IP ที่อนุญาต ให้ขอให้ผู้ดูแล Snowflake อนุญาตการเชื่อมต่อขาเข้าจากช่วง IP ขาออกของตัวเชื่อมต่อ ChatGPT ตามรายการปัจจุบัน รายการนี้เปลี่ยนแปลงได้และควรอัปเดตให้เป็นปัจจุบันอยู่เสมอ

ค่าที่ต้องเตรียม

• คำนำหน้าชื่อโฮสต์ Snowflake: ส่วนทั้งหมดก่อน .snowflakecomputing.com ใน URL ของบัญชี Snowflake

• ฐานข้อมูล: ฐานข้อมูลที่มีเซิร์ฟเวอร์ MCP อยู่

• Schema: Schema ที่มีเซิร์ฟเวอร์ MCP อยู่

• ชื่อเซิร์ฟเวอร์ MCP: ชื่อออบเจ็กต์เซิร์ฟเวอร์ MCP ของ Snowflake

• URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่มีการจัดการ หากหน้าจอตั้งค่า ChatGPT ขอให้ป้อน URL

• บทบาท Snowflake: บทบาทที่ผู้ใช้ควรใช้ในการอนุญาตแอป

• รายการเครื่องมือ: ออบเจ็กต์และการดำเนินการของ Snowflake ที่ต้องการให้ ChatGPT ใช้

กำหนดว่า ChatGPT ทำอะไรได้บ้าง

เลือกเฉพาะความสามารถที่ต้องการเปิดให้ใช้งาน ตัวเลือกที่ใช้กันทั่วไป ได้แก่:

• ค้นหาด้วย Cortex Search เพื่อหาคำตอบจากข้อมูลหรือเนื้อหาใน Snowflake ที่จัดทำดัชนีไว้

• ถามตอบด้วย Cortex Analyst ผ่านวิวเชิงความหมายที่ได้รับอนุมัติ

• SQL แบบอ่านอย่างเดียว เพื่อควบคุมสิทธิ์ในการสืบค้น

• เอเจนต์ Snowflake, Stored Procedure หรือ UDF สำหรับเวิร์กโฟลว์เฉพาะ

หากเปิดใช้งาน SQL ให้คงไว้เป็นแบบอ่านอย่างเดียว เว้นแต่องค์กรของคุณจะตรวจสอบและอนุมัติสิทธิ์เขียนข้อมูลแล้ว

เปิดเวิร์กชีต Snowflake

1. ลงชื่อเข้าใช้แอป Snowflake

2. สลับไปใช้บทบาทที่สร้างเซิร์ฟเวอร์ MCP และให้สิทธิ์เข้าถึงได้

3. ไปที่ เวิร์กสเปซ

   

4. สร้างเวิร์กสเปซพร้อมไฟล์ SQL

   

5. ตั้งค่าบริบทของเวิร์กสเปซเป็นฐานข้อมูลและ Schema ที่จะสร้างเซิร์ฟเวอร์ MCP

   

สร้างเซิร์ฟเวอร์ MCP ของ Snowflake

ลงชื่อเข้าใช้ Snowflake ด้วยบทบาทที่สามารถสร้างเซิร์ฟเวอร์ MCP และให้สิทธิ์เข้าถึงได้ เปิดเวิร์กชีตในฐานข้อมูลและ Schema ที่ต้องการสร้างเซิร์ฟเวอร์ MCP

เรียกใช้คำสั่งตามตัวอย่างต่อไปนี้ แทนที่ชื่อต่างๆ ด้วยชื่อฐานข้อมูล, Schema, บริการ, วิว, คลังประมวลผล และเซิร์ฟเวอร์ Snowflake ของคุณ

CREATE MCP SERVER CHATGPT_SNOWFLAKE_MCP
FROM SPECIFICATION $$
tools:
- name: "support-search"
type: "CORTEX_SEARCH_SERVICE_QUERY"
identifier: "CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE"
title: "Support Search"
description: "Search support content for relevant customer issues."
- name: "revenue-analyst"
type: "CORTEX_ANALYST_MESSAGE"
identifier: "CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW"
title: "Revenue Analyst"
description: "Answer revenue questions using the approved semantic view."
- name: "sql-readonly"
type: "SYSTEM_EXECUTE_SQL"
title: "Read-only SQL"
description: "Run read-only SQL queries against approved Snowflake data."
config:
read_only: true
query_timeout: 600
warehouse: "CHATGPT_WH"
$$;

ชื่อเครื่องมือและออบเจ็กต์ Snowflake ในคำสั่งนี้เป็นเพียงตัวอย่าง:

• support-search เปิดให้ใช้งานบริการ Cortex Search ที่ระบุ

• revenue-analyst เปิดให้ใช้งานวิวเชิงความหมายที่ระบุ เพิ่มเครื่องมือสำหรับวิวอื่นๆ ได้ตามต้องการ

• sql-readonly เปิดให้ใช้งาน SQL แบบอ่านอย่างเดียวกับคลังประมวลผลที่ระบุ

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

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

ให้สิทธิ์ Snowflake ที่เหมาะสม

เลือกบทบาท Snowflake ที่ผู้ใช้จะใช้ในการอนุญาต แล้วให้บทบาทนั้นมีสิทธิ์เข้าถึง:

1. ฐานข้อมูลและ Schema

2. เซิร์ฟเวอร์ MCP

3. ออบเจ็กต์ทั้งหมดที่เครื่องมือใช้ เช่น บริการค้นหา วิวเชิงความหมาย หรือคลังประมวลผล

ตัวอย่าง:

GRANT USAGE ON DATABASE CHATGPT_APPS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON SCHEMA CHATGPT_APPS.TOOLS TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP TO ROLE CHATGPT_CONNECTOR_ROLE;

GRANT USAGE ON CORTEX SEARCH SERVICE CHATGPT_APPS.TOOLS.SUPPORT_SEARCH_SERVICE TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT SELECT ON SEMANTIC VIEW CHATGPT_APPS.TOOLS.REVENUE_SEMANTIC_VIEW TO ROLE CHATGPT_CONNECTOR_ROLE;
GRANT USAGE ON WAREHOUSE CHATGPT_WH TO ROLE CHATGPT_CONNECTOR_ROLE;

หากเซิร์ฟเวอร์ MCP เปิดให้ใช้งาน UDF, Stored Procedure หรือ Cortex Agent ให้กำหนดสิทธิ์ที่จำเป็นสำหรับออบเจ็กต์นั้นด้วย

ตรวจสอบว่า Snowflake พร้อมใช้งาน

เรียกใช้:

SHOW MCP SERVERS IN SCHEMA CHATGPT_APPS.TOOLS;

จากนั้นเรียกใช้:

DESCRIBE MCP SERVER CHATGPT_APPS.TOOLS.CHATGPT_SNOWFLAKE_MCP;

ตรวจสอบว่า:

• เซิร์ฟเวอร์อยู่ในฐานข้อมูลและ Schema ที่ต้องการ

• รายการเครื่องมือตรงตามที่ตั้งใจไว้

• identifier ของเครื่องมือแต่ละรายการชี้ไปยังออบเจ็กต์ Snowflake ที่ถูกต้อง

• บทบาทที่ใช้เชื่อมต่อมีสิทธิ์ USAGE ในเซิร์ฟเวอร์ MCP

• บทบาทที่ใช้เชื่อมต่อมีสิทธิ์ที่จำเป็นในออบเจ็กต์ที่เกี่ยวข้องแต่ละรายการ

ป้อนรายละเอียดเซิร์ฟเวอร์ Snowflake ใน ChatGPT

หากตั้งค่าสำหรับเวิร์กสเปซ ให้เปิด admin.openai.com เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ แล้วเปิดปลั๊กอิน ดูวิธีไปยังส่วนต่างๆ ของเวิร์กสเปซและเข้าถึงแอปรุ่นเดิมได้ที่ การควบคุมของผู้ดูแล ความปลอดภัย และการปฏิบัติตามข้อกำหนดสำหรับปลั๊กอินและแอป

1. ใน ChatGPT ให้สลับไปยังบัญชีหรือเวิร์กสเปซที่ต้องการให้ใช้งานแอปได้

2. ไปที่ การตั้งค่า > ปลั๊กอิน หากตั้งค่าสำหรับใช้ส่วนตัว หรือไปที่ คอนโซลผู้ดูแล > ปลั๊กอิน ในฐานะผู้ดูแลเวิร์กสเปซ หากตั้งค่าสำหรับเวิร์กสเปซ

3. ค้นหา Snowflake

4. เปิดใช้งาน Snowflake - เทมเพลตอย่างเป็นทางการ

5. เปิด Snowflake - เทมเพลตอย่างเป็นทางการ ป้อนชื่อการเชื่อมต่อที่สื่อความหมายชัดเจน แล้วเลือก เชื่อมต่อ

6. ป้อน URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่มีการจัดการ:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

ตัวอย่าง:

https://myorg-myaccount.azure.snowflakecomputing.com/api/v2/databases/CHATGPT_APPS/schemas/TOOLS/mcp-servers/CHATGPT_SNOWFLAKE_MCP

หากหน้าจอตั้งค่าแสดงการกำหนดค่า Snowflake เป็นช่องแยกกัน ให้ใช้ค่าเดียวกันกับใน URL:

คำนำหน้าชื่อโฮสต์ Snowflake

ใช้ส่วนทั้งหมดก่อน .snowflakecomputing.com ใน URL ของบัญชี Snowflake รวมถึงส่วนต่อท้ายที่ระบุภูมิภาคหรือคลาวด์ หากมี

ตัวอย่างเช่น หาก URL ของบัญชีขึ้นต้นด้วย:

https://myorg-myaccount.azure.snowflakecomputing.com

คำนำหน้าชื่อโฮสต์คือ:

myorg-myaccount.azure

ฐานข้อมูล

ป้อนฐานข้อมูลที่มีเซิร์ฟเวอร์ MCP อยู่ เช่น:

CHATGPT_APPS

Schema

ป้อน Schema ที่มีเซิร์ฟเวอร์ MCP อยู่ เช่น:

TOOLS

ชื่อเซิร์ฟเวอร์ MCP

ป้อนชื่อออบเจ็กต์เซิร์ฟเวอร์ MCP ของ Snowflake เช่น:

CHATGPT_SNOWFLAKE_MCP

กำหนดค่า OAuth

เลือกวิธี OAuth ที่บัญชีของคุณรองรับและตรงตามข้อกำหนดขององค์กร ทั้งสองวิธีใช้การตั้งค่าเซิร์ฟเวอร์ MCP ส่วนที่ใช้ร่วมกันด้านบน รวมถึงการทดสอบการเชื่อมต่อและการควบคุมสิทธิ์เข้าถึงด้านล่าง

ไม่ว่าจะใช้ OAuth วิธีใด เมื่อใช้ session:role:all Snowflake จะใช้บทบาทเริ่มต้นของผู้ใช้แต่ละคน บทบาทเริ่มต้นต้องอยู่ในรายการบทบาทที่อนุญาตของการผสานรวม OAuth หากตั้งค่าไว้ และต้องไม่ถูกบล็อก แม้จะมีบทบาทอื่นที่ได้รับอนุมัติ ระบบก็จะไม่เลือกบทบาทนั้นโดยอัตโนมัติ

OAuth ในตัว

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

ใช้วิธีนี้เฉพาะเมื่อบัญชี Snowflake ของคุณรองรับแอปพลิเคชันพาร์ทเนอร์ ChatGPT และมี OAuth ในตัวให้ใช้งานในหน้าต่างตั้งค่า ChatGPT

1. ขอให้ผู้ดูแล Snowflake เปิดใช้งานการผสานรวมพาร์ทเนอร์ ChatGPT ในบัญชี Snowflake เดียวกับที่โฮสต์เซิร์ฟเวอร์ MCP ใช้การผสานรวมพาร์ทเนอร์ ChatGPT ที่มีอยู่และเปิดใช้งานแล้วได้เลย

2. ในหน้าต่างตั้งค่า ChatGPT ให้ใช้ OAuth ในตัว คุณไม่จำเป็นต้องป้อน ID ไคลเอนต์หรือข้อมูลลับของไคลเอนต์ หรือลงทะเบียน URL เรียกกลับ

3. ทำตามหัวข้อเชื่อมต่อและจัดการ Snowflake ด้านล่างต่อ เพื่อลงชื่อเข้าใช้ ให้ความยินยอม และกำหนดสิทธิ์เข้าถึง จากนั้นทำตามหัวข้อทดสอบแอปให้เสร็จ รวมถึงทดสอบกับสมาชิกที่ได้รับอนุญาตซึ่งไม่ใช่ผู้ดูแล

การทำงานของบทบาทเริ่มต้น รายการที่อนุญาต และบทบาทที่ถูกบล็อกตามที่อธิบายด้านบนมีผลกับวิธีนี้ด้วย

ไคลเอนต์ OAuth แบบกำหนดเอง

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

สำหรับไคลเอนต์ OAuth แบบกำหนดเอง คุณต้องมี ID ไคลเอนต์และข้อมูลลับของไคลเอนต์จาก Snowflake การทำงานของบทบาทเริ่มต้น รายการที่อนุญาต และบทบาทที่ถูกบล็อกตามที่อธิบายด้านบนมีผลกับวิธีนี้ด้วย

1. ในหน้าต่างตั้งค่า ChatGPT ให้เลือก การตั้งค่า OAuth ขั้นสูง > ไคลเอนต์ OAuth ที่ผู้ใช้กำหนด แล้วคัดลอก URL เรียกกลับ ที่แสดงใน ChatGPT ให้ตรงทุกอักขระ

2. สร้างการผสานรวมความปลอดภัย OAuth แบบกำหนดเอง โดยใช้ OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' และตั้งค่า OAUTH_REDIRECT_URI ให้ตรงกับ URL เรียกกลับนั้นทุกประการ

3. เรียกใช้คำสั่งต่อไปนี้ใน Snowflake โดยใช้ชื่อการผสานรวมเป็นตัวพิมพ์ใหญ่:

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('YOUR_INTEGRATION_NAME');

4. จากผลลัพธ์ JSON ให้วาง oauth_client_id ในช่อง ID ไคลเอนต์ OAuth และ oauth_client_secret ในช่อง ข้อมูลลับของไคลเอนต์ OAuth ใน ChatGPT

5. ตั้งค่า วิธียืนยันตัวตนของ endpoint โทเค็น เป็น client_secret_basic

หลังจากป้อนข้อมูลรับรองของไคลเอนต์แบบกำหนดเองแล้ว ให้ทำตามหัวข้อเชื่อมต่อและจัดการ Snowflake และทดสอบแอปด้านล่างต่อ

เชื่อมต่อและจัดการ Snowflake

1. ไม่ว่าจะใช้ OAuth วิธีใด ให้เลือก ดำเนินการต่อ ในหน้าต่างตั้งค่า ChatGPT เดิม ลงชื่อเข้าใช้ Snowflake แล้วอนุญาตการเชื่อมต่อ คุณใช้ SSO ขององค์กรได้หากตั้งค่าไว้

2. หากตั้งค่าสำหรับเวิร์กสเปซ ให้กำหนดนโยบายการติดตั้งปลั๊กอินและสิทธิ์เข้าถึงตามบทบาทหรือกลุ่มให้กับสมาชิกที่ควรใช้งาน ตรวจสอบว่าเปิดใช้งานทั้ง Snowflake และ Snowflake - เทมเพลตอย่างเป็นทางการ แล้ว

3. ผู้ดูแลเวิร์กสเปซมีหน้าที่กำหนดค่า สิทธิ์เข้าถึงของผู้ใช้ สำหรับบทบาทที่ควรใช้งาน Snowflake

4. ผู้ดูแลเวิร์กสเปซมีหน้าที่ตรวจสอบ การควบคุมการดำเนินการ สำหรับเครื่องมือที่เปิดให้ใช้งาน

5. ผู้ดูแลเวิร์กสเปซมีหน้าที่ตรวจสอบ สิทธิ์ของแอป เพื่อเลือกว่ากรณีใดบ้างที่ ChatGPT ต้องถามสมาชิกก่อนใช้แอป

สิทธิ์ของแอปเหล่านี้มีผลกับการสนทนาใน ChatGPT เอเจนต์ในเวิร์กสเปซใช้การควบคุมรายเอเจนต์ที่ผู้สร้างเอเจนต์กำหนดไว้ เพื่อระบุว่าแอปดำเนินการใดได้บ้าง และต้องขออนุมัติจากผู้ใช้ปลายทางเมื่อใด ดูการทำงานของเอเจนต์ได้ที่: เอเจนต์ในเวิร์กสเปซ ChatGPT สำหรับ Enterprise และ Business

ทดสอบแอป

1. เปิดแชต เลือก Snowflake แล้วทดสอบการเชื่อมต่อ

2. ตรวจสอบว่า ChatGPT ค้นพบเครื่องมือที่คุณกำหนดค่าไว้

3. เริ่มจากการอ่านข้อมูลที่มีความเสี่ยงต่ำ เช่น ค้นหาหรือสืบค้นแบบอ่านอย่างเดียวจากข้อมูลที่ได้รับอนุมัติ

4. ตรวจสอบว่าสิทธิ์ใน Snowflake ป้องกันการเข้าถึงนอกเหนือจากบทบาทและออบเจ็กต์ที่ได้รับอนุมัติ

5. หากตั้งค่าสำหรับเวิร์กสเปซ ให้ทดสอบกับสมาชิกที่ได้รับอนุญาตซึ่งไม่ใช่ผู้ดูแล และมีบทบาทเริ่มต้นใน Snowflake ต่างกัน การที่ผู้ดูแลเชื่อมต่อสำเร็จไม่ได้ยืนยันว่าสมาชิกทุกคนจะเชื่อมต่อได้

สำหรับผู้ดูแลเวิร์กสเปซ การเปิดใช้งานเฉพาะ Snowflake ยังไม่เพียงพอ หากยังไม่ได้เปิดใช้งานและเชื่อมต่อ Snowflake - เทมเพลตอย่างเป็นทางการ สมาชิกอาจเห็นปลั๊กอินในสถานะปิดใช้งาน

URL ของเซิร์ฟเวอร์ MCP และการทำงานของ OAuth

ChatGPT เชื่อมต่อกับ URL แบบเต็มของเซิร์ฟเวอร์ MCP ที่จัดการโดย Snowflake:

https://<snowflake_host_prefix>.snowflakecomputing.com/api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server}

ChatGPT ใช้คำนำหน้าชื่อโฮสต์ Snowflake จาก URL นั้นเพื่อระบุ endpoint ของ Snowflake OAuth ต่อไปนี้:

• การอนุญาต: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/authorize

• โทเค็น: https://<snowflake_host_prefix>.snowflakecomputing.com/oauth/token-request

อย่าวาง URL ของ Snowsight, URL รากของบัญชี Snowflake เพียงอย่างเดียว หรือ URL ที่มีส่วนของพาธเกินมา URL ของ MCP ต้องมี /api/v2/databases/{database}/schemas/{schema}/mcp-servers/{server} และตรงกับออบเจ็กต์ Snowflake ของคุณทุกประการ

การแก้ไขปัญหา

Snowflake เปิดใช้งานสำหรับผู้ดูแล แต่ปิดใช้งานสำหรับสมาชิก

• ตรวจสอบว่าเปิดใช้งานทั้ง Snowflake และ Snowflake - เทมเพลตอย่างเป็นทางการ ใน คอนโซลผู้ดูแล > ปลั๊กอิน แล้ว

• เปิด Snowflake - เทมเพลตอย่างเป็นทางการ แล้วทำขั้นตอน เชื่อมต่อ ให้เสร็จ การเปิดใช้งานเทมเพลตโดยไม่เชื่อมต่อยังไม่เพียงพอ

• เปิด Snowflake แล้วตรวจสอบว่ามีเทมเพลตแสดงเป็นแอปที่จำเป็นต้องใช้

• ตรวจสอบว่านโยบายการติดตั้งปลั๊กอินอนุญาตบทบาทหรือกลุ่มของสมาชิกที่พบปัญหา

ไม่พบเซิร์ฟเวอร์ MCP

• ตรวจสอบ URL แบบเต็มของเซิร์ฟเวอร์ MCP อีกครั้ง หรือค่าทั้งสี่ช่องของเทมเพลต หากหน้าจอตั้งค่าขอให้ป้อนแยกกัน

• ตรวจสอบว่าเซิร์ฟเวอร์ MCP อยู่ในฐานข้อมูลและ Schema ที่ระบุนั้นจริง

ไม่มีเครื่องมือปรากฏใน ChatGPT

• ตรวจสอบว่าข้อกำหนดของเซิร์ฟเวอร์ MCP มีเครื่องมืออยู่

• ตรวจสอบว่าบทบาทมีสิทธิ์ USAGE ในเซิร์ฟเวอร์ MCP

เครื่องมือปรากฏขึ้นแต่ทำงานไม่สำเร็จเมื่อใช้งาน

• ตรวจสอบว่าบทบาทมีสิทธิ์ที่จำเป็นในออบเจ็กต์ Snowflake ที่เกี่ยวข้อง เช่น บริการค้นหา วิวเชิงความหมาย คลังประมวลผล โพรซีเยอร์ หรือ UDF

เครื่องมือ SQL ทำงานไม่สำเร็จ

• ตรวจสอบว่าชื่อคลังประมวลผลถูกต้องและคลังประมวลผลกำลังทำงานอยู่

• ตรวจสอบว่าบทบาทมีสิทธิ์ USAGE ในคลังประมวลผล

• ตรวจสอบว่าตั้งค่า read_only: true แล้ว หากต้องการให้เข้าถึงแบบอ่านอย่างเดียว

บทบาท ALL ที่ร้องขอถูกบล็อกไว้อย่างชัดเจน

ขอให้ผู้ดูแล Snowflake เปรียบเทียบบทบาทเริ่มต้นของคุณกับบทบาทที่อนุญาตและที่ถูกบล็อกในการผสานรวม OAuth แม้จะมีบทบาทอื่นที่ได้รับอนุญาต ระบบก็จะไม่เลือกบทบาทนั้นโดยอัตโนมัติ หากเหมาะสม ให้เปลี่ยนบทบาทเริ่มต้นเป็นบทบาทที่ได้รับอนุมัติ แล้วเชื่อมต่อใหม่ การเปลี่ยนบทบาทเริ่มต้นจะมีผลกับเซสชัน Snowflake นอก ChatGPT ของคุณด้วย

การอนุญาตไม่สำเร็จ

• ตรวจสอบว่าผู้ใช้ลงชื่อเข้าใช้ Snowflake ได้

• เมื่อใช้ session:role:all ให้ตรวจสอบว่าการผสานรวม OAuth อนุญาตบทบาทเริ่มต้นของผู้ใช้

• ตรวจสอบว่าการตั้งค่านี้ใช้ขั้นตอน OAuth สำหรับ MCP ที่จัดการโดย Snowflake

• หากใช้ไคลเอนต์ OAuth แบบกำหนดเอง ให้ตรวจสอบว่า ID ไคลเอนต์ และ ข้อมูลลับของไคลเอนต์ ตรงกับการผสานรวม OAuth ของ Snowflake และ URI เปลี่ยนเส้นทางตรงกับ URL เรียกกลับ ที่แสดงใน ChatGPT ทุกประการ

  หากใช้ OAuth ในตัว ให้ขอให้ผู้ดูแล Snowflake ตรวจสอบว่าการผสานรวมพาร์ทเนอร์ ChatGPT พร้อมใช้งานและเปิดใช้งานอยู่ในบัญชีที่โฮสต์เซิร์ฟเวอร์ MCP

นโยบายเครือข่ายหรือรายการ IP ที่อนุญาตของ Snowflake บล็อกตัวเชื่อมต่อ

• ขอให้ผู้ดูแล Snowflake อัปเดตนโยบายเครือข่ายหรือกฎการเข้าถึงของ Snowflake

• อนุญาตการเชื่อมต่อขาเข้าจากช่วง IP ขาออกของตัวเชื่อมต่อ ChatGPT ตามรายการปัจจุบัน

• ตั้งค่ารายการที่อนุญาตนี้ใน Snowflake รายการนี้แยกจากรายการ IP ที่อนุญาตของเวิร์กสเปซ ChatGPT

• หากทำได้ ให้ตั้งค่าอัปเดตอัตโนมัติจาก JSON ที่เผยแพร่ไว้ เพราะช่วง IP อาจเปลี่ยนแปลงได้

ปัญหาการเชื่อมต่อจากชื่อโฮสต์

ใช้คำนำหน้าชื่อโฮสต์ Snowflake ที่ถูกต้อง ชื่อโฮสต์ Snowflake ที่มีขีดล่างอาจทำให้เกิดปัญหาได้ ควรใช้ยัติภังค์แทน

เอกสารอ้างอิง

• เซิร์ฟเวอร์ MCP ที่จัดการโดย Snowflake

• CREATE MCP SERVER

• DESCRIBE MCP SERVER

• SHOW MCP SERVERS