Honeydew Semantic Layer

ทางการ

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

ดูบน honeydew.aiลองใช้ MCP นี้ผู้สนับสนุน

คุณทำอะไรได้บ้างด้วย Honeydew Semantic Layer MCP?

  • สำรวจข้อมูลเมตาของคลังข้อมูล — ให้ผู้ช่วยของคุณค้นหาตาราง สคีมา และคำจำกัดความของโมเดลเชิงความหมายทั่วทั้งคลังข้อมูลของคุณ
  • จัดการโมเดลเชิงความหมาย — สร้างและดูแลรักษาโมเดลเชิงความหมายของคุณผ่านการสนทนาด้วยภาษาธรรมชาติ รวมถึงการสร้างสาขาในเวิร์กสเปซด้วย create_workspace_branch
  • สอบถามข้อมูลเชิงสนทนา — ใช้ภาษาธรรมชาติเพื่อสอบถามข้อมูลของคุณจากผู้ช่วยที่รองรับ MCP ใดก็ได้
  • กำหนดค่าบริบทของเซสชัน — ตั้งค่าเวิร์กสเปซและสาขาที่ใช้งานอยู่ของคุณด้วย set_session_workspace_and_branch หลังจากแสดงรายการตัวเลือกที่มีด้วย list_workspaces และ list_workspace_branches
  • เข้าถึงเอกสาร Honeydew — ค้นหาและอ่านเอกสารของ Honeydew ได้โดยตรงผ่านเครื่องมือเอกสารในตัวของเซิร์ฟเวอร์ MCP

เอกสาร

MCP Server

MCP คืออะไร?

Model Context Protocol (MCP) เป็นมาตรฐานโอเพนซอร์สสำหรับการเชื่อมต่อ แอปพลิเคชัน AI กับระบบและเครื่องมือภายนอกอย่างปลอดภัย Honeydew มี MCP server ที่เชื่อมต่อ AI coding assistant ของคุณเข้ากับ Honeydew Semantic Layer

เมื่อใดที่ควรใช้

  • สำรวจและค้นพบตาราง สคีมา และนิยาม semantic model ในคลังข้อมูลของคุณ
  • สร้างและดูแลรักษา semantic model ของคุณ ผ่านการสนทนาด้วยภาษาธรรมชาติ
  • ค้นหาข้อมูลของคุณด้วยภาษาธรรมชาติ จาก assistant ที่รองรับ MCP ใดก็ได้
  • ค้นหาและอ่านเอกสารประกอบของ Honeydew

การติดตั้ง

Server URL

Honeydew เปิดเผย MCP Server API ที่ https://mcp.honeydew.cloud/mcp

หมายเหตุ

หากองค์กรของคุณใช้ hostname ของ Honeydew ที่กำหนดเอง ให้แทนที่ URL เริ่มต้นด้วย hostname ของ tenant ของคุณ คุณสามารถค้นหา hostname ได้ใน UI ของ Honeydew ภายใต้ Settings > MCP Server

การรับรองความถูกต้อง

มีสองวิธีในการรับรองความถูกต้องกับ Honeydew MCP Server: OAuth หรือ HTTP Basic authentication

การรับรองความถูกต้องแบบ OAuth (แนะนำ)

ไคลเอนต์ส่วนใหญ่รองรับการรับรองความถูกต้องแบบ OAuth เมื่อคุณเชื่อมต่อครั้งแรก คุณจะได้รับแจ้งให้:

  1. ลงชื่อเข้าด้วยบัญชี Honeydew ของคุณ
  2. ยอมรับการอนุญาต OAuth

จากนั้นไคลเอนต์จะให้ access token สำหรับคำขอที่ตามมาอย่างปลอดภัย

การรับรองความถูกต้องแบบ HTTP Basic

MCP Server ในโหมด HTTP Basic authentication ต้องใช้ API Key สำหรับการรับรองความถูกต้อง

คุณต้องระบุสตริงที่เข้ารหัสแบบ Base64 ของ API Key และ API Secret ในรูปแบบ API_KEY:API_SECRET

เคล็ดลับ

หากสร้าง API Key ใหม่สำหรับการเข้าถึง MCP Server คุณสามารถคัดลอกสตริงที่เข้ารหัสแบบ Base64 จาก UI ของ Honeydew Studio ในเวลาที่สร้างได้

คุณสามารถใช้คำสั่งต่อไปนี้ เพื่อสร้างสตริงที่เข้ารหัสแบบ Base64:

```bash theme={null} echo -n ':' | base64 ``` ใช้ PowerShell: 
```powershell theme={null}
[Convert]::ToBase64String(
  [Text.Encoding]::UTF8.GetBytes(
    "<API_KEY>:<API_SECRET>"
  )
)
```

ระบุสตริงที่เข้ารหัส ในส่วนหัว Authorization ดังนี้:

Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>

การกำหนดค่า

workspace และ branch ถูกกำหนดที่ระดับเซสชัน โดยใช้เครื่องมือ list_workspaces, list_workspace_branches และ set_session_workspace_and_branch คุณยังสามารถสร้าง branch ใหม่ได้ด้วย create_workspace_branch เรียกใช้เครื่องมือเหล่านี้จาก AI assistant ของคุณ หลังจากเชื่อมต่อกับ MCP server แล้ว

คุณสามารถระบุส่วนหัวเหล่านี้ในไฟล์กำหนดค่า MCP server ของคุณได้ตามต้องการ:

  • Workspace: กำหนด workspace สำหรับคำขอทั้งหมด (ไม่บังคับ)
  • Branch: กำหนด branch เฉพาะของ workspace สำหรับคำขอทั้งหมด (ไม่บังคับ ค่าเริ่มต้นคือ prod หากตั้งค่า workspace ไว้)
  • Honeydew-Client: ระบุ MCP client (ไม่บังคับ ตรวจจับอัตโนมัติจากเครื่องมือที่เชื่อมต่อ) ส่งส่วนหัวนี้เพื่อระบุตัวระบุไคลเอนต์เฉพาะ
  • ReadonlyToolsOnly: ตั้งค่าเป็น true เพื่อเปิดเผยเฉพาะเครื่องมือแบบอ่านอย่างเดียว (ไม่บังคับ)

หมายเหตุ

MCP server ใช้ส่วนหัวการตอบสนอง Mcp-Session-Id เพื่อรักษาสถานะเซสชัน รวมถึง workspace และ branch ที่ใช้งานอยู่ ดู ข้อกำหนดการจัดการเซสชัน MCP สำหรับรายละเอียด

ไคลเอนต์ที่รองรับ

Claude Code CLI

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

Honeydew มี ที่เก็บปลั๊กอิน พร้อมทักษะและเครื่องมือสำหรับการสร้าง semantic models และวิเคราะห์ข้อมูลผ่านการสนทนาด้วยภาษาธรรมชาติ การติดตั้งปลั๊กอินจะตั้งค่า Honeydew MCP servers โดยอัตโนมัติ

เปิดใช้ Claude Code ด้วย claude จากนั้นเพิ่ม marketplace:

/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

จากนั้นติดตั้งปลั๊กอิน Honeydew จาก marketplace:

/plugin install honeydew-ai@honeydew-ai-claude-plugins

จากนั้นโหลดปลั๊กอินใหม่เพื่อเปิดใช้งาน:

/reload-plugins

การอัปเดตปลั๊กอิน

หากต้องการอัปเดตปลั๊กอิน Honeydew marketplace ให้เปิดใช้ Claude Code ด้วย claude จากนั้น:

  1. พิมพ์ /plugin และเลือก Marketplaces ในตัวเลือกที่ด้านบน
  2. เลือก honeydew-ai-coding-agents-plugins
  3. คลิก Update marketplace

หากต้องการรับการอัปเดตอัตโนมัติ ให้เลือก Enable auto-update ในการตั้งค่า marketplace

การตั้งค่า MCP

ใช้ส่วนนี้หากองค์กรของคุณใช้ Honeydew endpoint ที่กำหนดเอง หรือหากคุณต้องการกำหนดค่า MCP servers โดยไม่ต้องติดตั้งปลั๊กอิน ปิดการเชื่อมต่อ Honeydew MCP ที่เพิ่มโดยปลั๊กอิน จากนั้นเพิ่ม endpoint ที่กำหนดเองของคุณโดยใช้คำแนะนำด้านล่าง

Honeydew MCP server เชื่อมต่อ Claude Code กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การค้นหาข้อมูล การจัดการโมเดล และการเข้าถึงเอกสารประกอบ

ใช้วิธีใดวิธีหนึ่งต่อไปนี้เพื่อเพิ่ม Honeydew MCP server:

หมายเหตุ

หากองค์กรของคุณใช้ hostname ของ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วย hostname ของ tenant ของคุณ คุณสามารถค้นหา hostname ได้ใน Settings > MCP Server ใน Honeydew Studio

```bash theme={null} claude mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
      เปิดใช้ Claude Code ด้วย `claude`
      คุณจะได้รับแจ้งให้รับรองความถูกต้องด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```bash theme={null}
      claude mcp add --transport http honeydew \
          https://mcp.honeydew.cloud/mcp \
          --header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON configuration">
  บันทึกสิ่งต่อไปนี้ไปยัง `honeydew-mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp"
      }
      ```

      จากนั้นลงทะเบียนด้วย:

      ```bash theme={null}
      claude mcp add honeydew ./honeydew-mcp.json
      ```

      เปิดใช้ Claude Code ด้วย `claude`
      คุณจะได้รับแจ้งให้รับรองความถูกต้องด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp",
        "headers": {
          "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
        }
      }
      ```

      จากนั้นลงทะเบียนด้วย:

      ```bash theme={null}
      claude mcp add honeydew ./honeydew-mcp.json
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title=".mcp.json">
  เพิ่มสิ่งต่อไปนี้ลงในไฟล์ `.mcp.json` ของคุณ:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp"
          }
        }
      }
      ```

      เปิดใช้ Claude Code ด้วย `claude`
      คุณจะได้รับแจ้งให้รับรองความถูกต้องด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp",
            "headers": {
              "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
            }
          }
        }
      }
      ```
    </Tab>
  </Tabs>
</Tab>

เคล็ดลับ

การใช้ตัวแปรสภาพแวดล้อมสำหรับการรับรองความถูกต้องด้วย API Key

เพื่อหลีกเลี่ยงการจัดเก็บค่าที่ละเอียดอ่อนโดยตรงในไฟล์กำหนดค่า Claude Code รองรับ การขยายตัวแปรสภาพแวดล้อม โดยใช้ไวยากรณ์ ${VAR_NAME}

ตั้งค่าตัวแปรสภาพแวดล้อม HONEYDEW_API_KEY จากนั้นอ้างอิงในไฟล์กำหนดค่าของคุณ:

claude mcp add --transport http honeydew \
    https://mcp.honeydew.cloud/mcp \
    --header "Authorization: Basic ${HONEYDEW_API_KEY}"

Claude Code แก้ไขการอ้างอิง ${VAR_NAME} ในขณะรันไทม์จากสภาพแวดล้อมของคุณ

Honeydew Documentation MCP (ไม่บังคับ)

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

claude mcp add --transport http honeydew-docs \
    https://honeydew.ai/docs/mcp

การลบ MCP server

หากต้องการลบ Honeydew MCP server:

claude mcp remove honeydew

หากต้องการลบ Honeydew Documentation MCP server:

claude mcp remove honeydew-docs

Claude Desktop

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

Honeydew มี ที่เก็บปลั๊กอิน พร้อมทักษะและเครื่องมือสำหรับการสร้าง semantic models และวิเคราะห์ข้อมูลผ่านการสนทนาด้วยภาษาธรรมชาติ การติดตั้งปลั๊กอินจะตั้งค่า Honeydew MCP servers โดยอัตโนมัติ

  1. ไปที่ Settings -> Customize
  2. คลิก Browse Plugins
  3. ไปที่แท็บ Personal
  4. คลิกไอคอน + และเลือก Add marketplace from GitHub
  5. ป้อน honeydew-ai/honeydew-ai-coding-agents-plugins ในช่องป้อนข้อมูล
  6. ปลั๊กอิน Honeydew AI ปรากฏขึ้น ติดตั้งได้เลย

การตั้งค่า MCP

ใช้ส่วนนี้หากองค์กรของคุณใช้ Honeydew endpoint ที่กำหนดเอง หรือหากคุณต้องการกำหนดค่า MCP servers โดยไม่ต้องติดตั้งปลั๊กอิน ปิดการเชื่อมต่อ Honeydew MCP ที่เพิ่มโดยปลั๊กอิน จากนั้นเพิ่ม endpoint ที่กำหนดเองของคุณโดยใช้คำแนะนำด้านล่าง

Honeydew MCP server เชื่อมต่อ Claude Desktop กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การค้นหาข้อมูล การจัดการโมเดล และการเข้าถึงเอกสารประกอบ

โหมด Claude Code

เมื่อใช้ Claude Desktop ในโหมด Claude Code ให้ปฏิบัติตามคำแนะนำ Claude Code CLI แทน

หมายเหตุ

หากองค์กรของคุณใช้ hostname ของ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วย hostname ของ tenant ของคุณ คุณสามารถค้นหา hostname ได้ใน Settings > MCP Server ใน Honeydew Studio

หากต้องการเพิ่ม Honeydew MCP ในโหมด Cowork:

  1. ไปที่ Settings -> Connectors -> Add custom connector
  2. ป้อน honeydew ในช่อง Name
  3. ป้อน https://mcp.honeydew.cloud/mcp ในช่อง Remote MCP server URL
  4. คลิก Add

คุณจะได้รับแจ้งให้รับรองความถูกต้องด้วย OAuth กับ Honeydew เมื่อเชื่อมต่อครั้งแรก

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. ไปที่ Settings -> Connectors -> Add custom connector
  2. ป้อน honeydew-docs ในช่อง Name
  3. ป้อน https://honeydew.ai/docs/mcp ในช่อง Remote MCP server URL
  4. คลิก Add

การลบ MCP server

หากต้องการลบ Honeydew MCP server ในโหมด Cowork:

  1. ไปที่ Settings -> Connectors
  2. ค้นหาตัวเชื่อมต่อ honeydew และคลิกไอคอนลบ

หากต้องการลบ Honeydew Documentation MCP server:

  1. ไปที่ Settings -> Connectors
  2. ค้นหาตัวเชื่อมต่อ honeydew-docs และคลิกไอคอนลบ

Claude.ai

#### การติดตั้งปลั๊กอิน

Honeydew มี ที่เก็บปลั๊กอิน พร้อมทักษะและเครื่องมือสำหรับการสร้าง semantic models และวิเคราะห์ข้อมูลผ่านการสนทนาด้วยภาษาธรรมชาติ การติดตั้งปลั๊กอินจะตั้งค่าทั้ง Honeydew MCP server และ Honeydew Documentation MCP server โดยอัตโนมัติ

  1. ดาวน์โหลด zip ปลั๊กอิน: honeydew-ai-claude.zip
  2. ใน Claude.ai ไปที่ Settings -> Plugins -> Add plugin -> Upload zip
  3. อัปโหลด zip — ปลั๊กอินจะปรากฏใน private marketplace ของคุณ

การตั้งค่า MCP

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

Honeydew MCP server เชื่อมต่อ Claude.ai กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การค้นหาข้อมูล การจัดการโมเดล และการเข้าถึงเอกสารประกอบ

หมายเหตุ

หากองค์กรของคุณใช้ hostname ของ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วย hostname ของ tenant ของคุณ คุณสามารถค้นหา hostname ได้ใน Settings > MCP Server ใน Honeydew Studio

หากต้องการเพิ่ม Honeydew MCP server:

  1. ไปที่ การตั้งค่า -> ตัวเชื่อมต่อ -> เพิ่มตัวเชื่อมต่อแบบกำหนดเอง
  2. ป้อน honeydew ในช่อง ชื่อ
  3. ป้อน https://mcp.honeydew.cloud/mcp ในช่อง URL เซิร์ฟเวอร์ MCP ระยะไกล
  4. คลิก เพิ่ม

คุณจะได้รับแจ้งให้ยืนยันตัวตนด้วย OAuth กับ Honeydew เมื่อเชื่อมต่อครั้งแรก

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. ไปที่ การตั้งค่า -> ตัวเชื่อมต่อ -> เพิ่มตัวเชื่อมต่อแบบกำหนดเอง
  2. ป้อน honeydew-docs ในช่อง ชื่อ
  3. ป้อน https://honeydew.ai/docs/mcp ในช่อง URL เซิร์ฟเวอร์ MCP ระยะไกล
  4. คลิก เพิ่ม

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ Honeydew MCP:

  1. ไปที่ การตั้งค่า -> ตัวเชื่อมต่อ
  2. ค้นหาตัวเชื่อมต่อ honeydew แล้วคลิกไอคอนลบ

หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP:

  1. ไปที่ การตั้งค่า -> ตัวเชื่อมต่อ
  2. ค้นหาตัวเชื่อมต่อ honeydew-docs แล้วคลิกไอคอนลบ

Cortex Code CLI

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

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

เปิด Cortex Code CLI ด้วย cortex จากนั้นติดตั้งปลั๊กอิน:

/plugin install honeydew-ai/honeydew-ai-coding-agents-plugins

การตั้งค่า MCP

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

เซิร์ฟเวอร์ Honeydew MCP เชื่อมต่อ Cortex Code CLI เข้ากับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

```bash theme={null} cortex mcp add honeydew \ https://mcp.honeydew.cloud/mcp \ --type http ``` 
      เปิด Cortex Code CLI ด้วย `cortex`
      คุณจะได้รับแจ้งให้ยืนยันตัวตน
      ด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```bash theme={null}
      cortex mcp add honeydew \
          https://mcp.honeydew.cloud/mcp \
          --type http \
          -H "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON configuration">
  บันทึกสิ่งต่อไปนี้ไปยัง `honeydew-mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp"
      }
      ```

      จากนั้นลงทะเบียนด้วย:

      ```bash theme={null}
      cortex mcp add honeydew ./honeydew-mcp.json --type http
      ```

      เปิด Cortex Code CLI ด้วย `cortex`
      คุณจะได้รับแจ้งให้ยืนยันตัวตน
      ด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp",
        "headers": {
          "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
        }
      }
      ```

      จากนั้นลงทะเบียนด้วย:

      ```bash theme={null}
      cortex mcp add honeydew ./honeydew-mcp.json --type http
      ```
    </Tab>
  </Tabs>
</Tab>

<Tab title="mcp.json">
  เพิ่มสิ่งต่อไปนี้ไปยัง
  `~/.snowflake/cortex/mcp.json`:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp"
          }
        }
      }
      ```

      เปิด Cortex Code CLI ด้วย `cortex`
      คุณจะได้รับแจ้งให้ยืนยันตัวตน
      ด้วย OAuth กับ Honeydew
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "mcpServers": {
          "honeydew": {
            "type": "http",
            "url": "https://mcp.honeydew.cloud/mcp",
            "headers": {
              "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
            }
          }
        }
      }
      ```
    </Tab>
  </Tabs>
</Tab>

Honeydew Documentation MCP (ไม่บังคับ)

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

cortex mcp add honeydew-docs \
    https://honeydew.ai/docs/mcp \
    --type http

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ Honeydew MCP:

cortex mcp remove honeydew

หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP:

cortex mcp remove honeydew-docs

Cortex Code Desktop

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

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

  1. ไปที่ การตั้งค่า -> ปลั๊กอิน
  2. คลิก เพิ่มปลั๊กอิน เลือก เพิ่มจาก GitHub และวาง ที่เก็บปลั๊กอิน Honeydew: honeydew-ai/honeydew-ai-coding-agents-plugins
  3. ทำตามขั้นตอนและอนุมัติขั้นตอนใน การตั้งค่าตัวติดตั้งปลั๊กอิน GitHub

การตั้งค่า MCP

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

เซิร์ฟเวอร์ Honeydew MCP เชื่อมต่อ Cortex Code Desktop เข้ากับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หากต้องการเพิ่มเซิร์ฟเวอร์ ไปที่ MCP -> ใหม่ เลือก ขอบเขตการกำหนดค่า (ตัวอย่างเช่น ~/.snowflake/cortex/mcp.json สำหรับระดับโลก) กรอกแบบฟอร์ม จากนั้นคลิก บันทึก ใช้แท็บ ฟอร์ม หรือ JSON เพื่อป้อนการกำหนดค่า

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

เพิ่มเซิร์ฟเวอร์ Honeydew MCP:

1. **ชื่อเซิร์ฟเวอร์**: `honeydew` 2. **ประเภทเซิร์ฟเวอร์**: **ระยะไกล (HTTP)** 3. **URL เซิร์ฟเวอร์**: `https://mcp.honeydew.cloud/mcp` 4. คลิก **บันทึก** 
      คุณจะได้รับแจ้งให้ยืนยันตัวตนด้วย OAuth กับ Honeydew
      เมื่อเชื่อมต่อครั้งแรก
    </Tab>

    <Tab title="API Key">
      1. **ชื่อเซิร์ฟเวอร์**: `honeydew`
      2. **ประเภทเซิร์ฟเวอร์**: **ระยะไกล (HTTP)**
      3. **URL เซิร์ฟเวอร์**: `https://mcp.honeydew.cloud/mcp`
      4. ภายใต้ **ส่วนหัว** คลิก **เพิ่มส่วนหัว** และตั้งชื่อเป็น
         `Authorization` และค่าเป็น
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. คลิก **บันทึก**
    </Tab>
  </Tabs>
</Tab>

<Tab title="JSON">
  สลับไปที่แท็บ **JSON** และวางการกำหนดค่า:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "honeydew": {
          "type": "http",
          "url": "https://mcp.honeydew.cloud/mcp"
        }
      }
      ```

      คุณจะได้รับแจ้งให้ยืนยันตัวตนด้วย OAuth กับ Honeydew
      เมื่อเชื่อมต่อครั้งแรก
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "honeydew": {
          "type": "http",
          "url": "https://mcp.honeydew.cloud/mcp",
          "headers": {
            "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
          }
        }
      }
      ```
    </Tab>
  </Tabs>
</Tab>

Honeydew Documentation MCP (ไม่บังคับ)

เซิร์ฟเวอร์ Honeydew MCP มีเครื่องมือเข้าถึงเอกสารอยู่แล้ว จึงไม่จำเป็นต้องใช้เซิร์ฟเวอร์เอกสารแยกต่างหาก หากคุณต้องการเข้าถึงเอกสารโดยไม่ต้องเชื่อมต่อกับ Honeydew ให้เพิ่มเซิร์ฟเวอร์ Honeydew Documentation MCP ในลักษณะเดียวกัน โดยใช้ ชื่อเซิร์ฟเวอร์ honeydew-docs, ประเภทเซิร์ฟเวอร์ ระยะไกล (HTTP) และ URL เซิร์ฟเวอร์ https://honeydew.ai/docs/mcp ไม่จำเป็นต้องมีการยืนยันตัวตน

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ ไปที่ MCP ค้นหาเซิร์ฟเวอร์ honeydew (หรือ honeydew-docs) แล้วลบออก

Cursor

#### การติดตั้งปลั๊กอิน

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

  1. ในการตั้งค่าทีมหรือองค์กรของคุณ ไปที่ cursor.com/dashboard/plugins (หรือคลิก ปลั๊กอิน ในเมนูด้านซ้าย)
  2. เลื่อนลงไปที่ ตลาดของทีม และคลิกที่ตลาดที่มีอยู่ หรือคลิก เพิ่มตลาด เพื่อสร้างใหม่ หากสร้างใหม่ ให้ป้อนชื่อและสร้าง
  3. ภายในตลาด คลิก เพิ่มปลั๊กอิน วางเส้นทางที่เก็บปลั๊กอิน GitHub ของ Honeydew: https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins และคลิก เพิ่ม 1 ปลั๊กอิน
  4. คุณสามารถเปิดใช้ รีเฟรชอัตโนมัติ ในหน้าตลาดได้ เพื่อให้ปลั๊กอินอัปเดตโดยอัตโนมัติเมื่อมีเวอร์ชันใหม่
  5. กลับไปที่หน้าปลั๊กอิน (cursor.com/dashboard/plugins), ค้นหาปลั๊กอิน Honeydew แล้วคลิก เพิ่ม

การตั้งค่า MCP

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

เซิร์ฟเวอร์ Honeydew MCP เชื่อมต่อ Cursor เข้ากับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

หากต้องการเพิ่ม Honeydew MCP:

  1. เปิดแอปพลิเคชัน Cursor

  2. ไปที่ การตั้งค่า -> การตั้งค่า Cursor -> เครื่องมือและ MCP

  3. คลิก เซิร์ฟเวอร์ MCP ใหม่

  4. เพิ่มการกำหนดค่าต่อไปนี้:

    ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` 
    <Tab title="API Key">
  ```json theme={null}
  {
    "name": "honeydew",
    "type": "http",
    "url": "https://mcp.honeydew.cloud/mcp",
    "headers": {
      "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
    }
  }
  ```
</Tab>

  5. คลิก บันทึก

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. ไปที่ การตั้งค่า -> การตั้งค่า Cursor -> เครื่องมือและ MCP
  2. คลิก เซิร์ฟเวอร์ MCP ใหม่
  3. เพิ่มการกำหนดค่าต่อไปนี้: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. คลิก บันทึก

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ Honeydew MCP:

  1. ไปที่ การตั้งค่า -> การตั้งค่า Cursor -> เครื่องมือและ MCP
  2. ค้นหา honeydew ในรายการแล้วคลิกไอคอนลบ

หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP:

  1. ไปที่ การตั้งค่า -> การตั้งค่า Cursor -> เครื่องมือและ MCP
  2. ค้นหา honeydew-docs ในรายการแล้วคลิกไอคอนลบ

Databricks Genie Code

> **หมายเหตุ** > > เซิร์ฟเวอร์ MCP รองรับเฉพาะในโหมด Genie Code Agent เท่านั้น > สำหรับรายละเอียดเพิ่มเติม โปรดดู > [เอกสาร MCP ของ Databricks](https://docs.databricks.com/aws/en/generative-ai/mcp/)

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

  • เปิดใช้ Genie Code ในพื้นที่ทำงาน Databricks ของคุณ

  • สิทธิ์ CREATE CONNECTION บน Unity Catalog metastore

    1. ไปที่ **Catalog** → **Connections** → **Create a connection** 2. บนหน้าจอ **Connection basics**: * ตั้งค่า **Connection name** เป็น `honeydew-mcp` * ตั้งค่า **Connection type** เป็น **HTTP** * ตั้งค่า **Auth type** เป็น **Dynamic Client Registration** * คลิก **Next** 3. บนหน้าจอ **Authentication**: * ตั้งค่า **Host** เป็น `https://mcp.honeydew.cloud` * ปล่อย **Port** ไว้เป็น `443` * ตั้งค่า **OAuth scope** เป็น `openid` * คลิก **Next** 4. บนหน้าจอ **Connection details**: * ทำเครื่องหมาย **Is MCP connection** * ตั้งค่า **Base path** เป็น `/mcp` * คลิก **Create connection** 
    <Tab title="SQL">
  รัน SQL ต่อไปนี้ใน Databricks notebook หรือ SQL editor:

  ```sql theme={null}
  CREATE OR REPLACE CONNECTION `honeydew-mcp` TYPE HTTP
  OPTIONS (
    host 'https://mcp.honeydew.cloud',
    base_path '/mcp',
    is_mcp_connection 'true',
    oauth_scope 'openid'
  );

  DESCRIBE CONNECTION `honeydew-mcp`;
  ```
</Tab>

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud ด้วยชื่อโฮสต์ของผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน Settings > MCP Server ใน Honeydew Studio 

<Step title="Log in to the connection">
  ไปที่ **Catalog** → **Connections** → `honeydew-mcp`
  และคลิก **Login** ที่มุมขวาบน
  เพื่อตรวจสอบสิทธิ์และยืนยันการเชื่อมต่อ
</Step>

<Step title="Grant connection access">
  มอบสิทธิ์ `USE CONNECTION` ให้กับผู้ใช้หรือบทบาทใดๆ
  ที่ต้องการเข้าถึง Honeydew MCP server:

  ```sql theme={null}
  GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
  ```
</Step>

<Step title="Add the MCP server in Genie Code">
  1. เปิด Genie Code และคลิกไอคอนรูปเฟือง
  2. ไปที่ **MCP Servers** → **Add Server**
  3. เลือก **External MCP server**
  4. เลือกการเชื่อมต่อ `honeydew-mcp` ที่คุณสร้างขึ้น
  5. ลงชื่อเข้าใช้การเชื่อมต่อเมื่อได้รับแจ้ง
  6. คลิก **Save**

หมายเหตุ

Databricks จำกัด MCP ไว้ที่ 20 เครื่องมือในทุกเซิร์ฟเวอร์ที่กำหนดค่าไว้ หากคุณต้องการปรับเปลี่ยนว่าเครื่องมือ Honeydew ใดบ้างที่พร้อมใช้งาน ให้ใช้การตั้งค่า MCP ของ Genie Code เพื่อเปิดหรือปิดเครื่องมือเฉพาะ

การลบ MCP server

หากต้องการลบ Honeydew MCP server ออกจาก Genie Code:

  1. เปิด Genie Code และคลิกไอคอนรูปเฟือง
  2. ไปที่ MCP Servers
  3. ค้นหา honeydew-mcp และคลิก Remove

หากต้องการลบการเชื่อมต่อ Unity Catalog ที่อยู่ภายใต้ด้วย ให้รัน SQL ต่อไปนี้:

DROP CONNECTION `honeydew-mcp`;

Devin

#### MCP Server

Devin เชื่อมต่อกับ MCP servers ระยะไกลผ่าน MCP Marketplace

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน Settings > MCP Server ใน Honeydew Studio

หากต้องการเพิ่ม Honeydew MCP server:

  1. ไปที่ Settings -> Connections -> MCP servers

  2. คลิก Add a custom MCP

  3. ป้อน honeydew ในช่อง Server Name

  4. เพิ่มไอคอนและ Short Description ตามต้องการ

  5. เลือก HTTP เป็นประเภทการขนส่ง

  6. ป้อน https://mcp.honeydew.cloud/mcp ในช่อง Server URL

  7. กำหนดค่าการตรวจสอบสิทธิ์:

    เลือก **OAuth** เป็นวิธีการตรวจสอบสิทธิ์ Devin จะแจ้งให้คุณตรวจสอบสิทธิ์กับ Honeydew ในระหว่างเซสชันแรก 
    <Tab title="API Key">
  เลือก **Auth Header** เป็นวิธีการตรวจสอบสิทธิ์
  ปล่อยคีย์ส่วนหัวไว้เป็น `Authorization` และตั้งค่าเป็น
  `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
  (ดู [Authentication](#authentication))
</Tab>

  8. คลิก Save จากนั้นคลิก Test listing tools เพื่อตรวจสอบการเชื่อมต่อ

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. ไปที่ Settings -> Connections -> MCP servers
  2. คลิก Add a custom MCP
  3. ป้อน honeydew-docs ในช่อง Server Name
  4. เลือก HTTP เป็นประเภทการขนส่ง
  5. ป้อน https://honeydew.ai/docs/mcp ในช่อง Server URL
  6. ตั้งค่าวิธีการตรวจสอบสิทธิ์เป็น None
  7. คลิก Save

การลบ MCP server

หากต้องการลบ Honeydew MCP server:

  1. ไปที่ Settings -> Connections -> MCP servers
  2. ค้นหาเซิร์ฟเวอร์ honeydew และลบออก

หากต้องการลบ Honeydew Documentation MCP server:

  1. ไปที่ Settings -> Connections -> MCP servers
  2. ค้นหาเซิร์ฟเวอร์ honeydew-docs และลบออก

GitHub Copilot CLI

#### MCP Server

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน Settings > MCP Server ใน Honeydew Studio

  1. เปิด GitHub Copilot CLI ด้วย copilot

  2. พิมพ์ /mcp add เพื่อเปิดแบบฟอร์มการกำหนดค่าเซิร์ฟเวอร์

  3. กรอกข้อมูลในฟิลด์ต่อไปนี้:

    • Name: honeydew

    • Type: http

    • URL: https://mcp.honeydew.cloud/mcp

    • HTTP Headers:

      ไม่จำเป็นต้องมีส่วนหัวเพิ่มเติมสำหรับ OAuth ```json theme={null} { "Authorization": "Basic " } ```

  4. กด Ctrl+S เพื่อบันทึก

ใช้ /mcp show เพื่อตรวจสอบว่าเซิร์ฟเวอร์เชื่อมต่ออยู่

AI Coding Agent Plugins

หมายเหตุ

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

Honeydew มี plugins repository พร้อมทักษะและเครื่องมือสำหรับการสร้างโมเดลเชิงความหมาย และการวิเคราะห์ข้อมูลผ่านการสนทนาตามธรรมชาติ

เพิ่ม marketplace ใน Copilot CLI:

/plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

จากนั้นติดตั้งปลั๊กอิน Honeydew จาก marketplace:

/plugin install honeydew-ai@honeydew-ai-github-copilot-plugins

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. เปิด GitHub Copilot CLI ด้วย copilot
  2. พิมพ์ /mcp add เพื่อเปิดแบบฟอร์มการกำหนดค่าเซิร์ฟเวอร์
  3. กรอกข้อมูลในฟิลด์ต่อไปนี้:
    • Name: honeydew-docs
    • Type: http
    • URL: https://honeydew.ai/docs/mcp
  4. กด Ctrl+S เพื่อบันทึก

การลบ MCP server

หากต้องการลบ Honeydew MCP server ให้เปิด GitHub Copilot CLI ด้วย copilot จากนั้นพิมพ์:

/mcp remove honeydew

หากต้องการลบ Honeydew Documentation MCP server:

/mcp remove honeydew-docs

Gemini CLI

#### การติดตั้งส่วนขยาย

หมายเหตุ

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

Honeydew มี plugins repository พร้อมทักษะและเครื่องมือสำหรับการสร้างโมเดลเชิงความหมาย และการวิเคราะห์ข้อมูลผ่านการสนทนาตามธรรมชาติ การติดตั้งส่วนขยายจะตั้งค่า Honeydew MCP servers โดยอัตโนมัติ

รันคำสั่งต่อไปนี้เพื่อติดตั้งส่วนขยาย Honeydew:

gemini extensions install \
    https://github.com/honeydew-ai/honeydew-ai-coding-agents-plugins \
    --auto-update

แฟล็ก --auto-update จะทำให้ส่วนขยายอัปเดตโดยอัตโนมัติ

การตั้งค่า MCP

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

Honeydew MCP server เชื่อมต่อ Gemini CLI กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน Settings > MCP Server ใน Honeydew Studio

รันคำสั่งต่อไปนี้เพื่อเพิ่ม Honeydew MCP server:

```bash theme={null} gemini mcp add --transport http honeydew \ https://mcp.honeydew.cloud/mcp ``` 
  เปิด Gemini CLI ด้วย `gemini`
  คุณจะได้รับแจ้งให้ตรวจสอบสิทธิ์ด้วย OAuth กับ Honeydew
</Tab>

<Tab title="API Key">
  ```bash theme={null}
  gemini mcp add --transport http honeydew \
      https://mcp.honeydew.cloud/mcp \
      --header "Authorization: Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
  ```
</Tab>

Honeydew Documentation MCP (ไม่บังคับ)

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

gemini mcp add --transport http honeydew-docs \
    https://honeydew.ai/docs/mcp

การลบ MCP server

หากต้องการลบ Honeydew MCP server:

gemini mcp remove honeydew

หากต้องการลบ Honeydew Documentation MCP server:

gemini mcp remove honeydew-docs

VS Code และ GitHub Copilot

#### การติดตั้งปลั๊กอิน

Honeydew มี plugins repository พร้อมทักษะและเครื่องมือสำหรับการสร้างโมเดลเชิงความหมาย และการวิเคราะห์ข้อมูลผ่านการสนทนาตามธรรมชาติ การติดตั้งปลั๊กอินจะตั้งค่า Honeydew MCP servers โดยอัตโนมัติ

เพิ่ม Honeydew marketplace

  1. เปิด settings.json ของ VS Code (เปิด Command Palette ด้วย CMD+Shift+P บน macOS หรือ Ctrl+Shift+P บน Windows/Linux จากนั้นเลือก Preferences: Open User Settings (JSON))
  2. เพิ่ม Honeydew marketplace ในการตั้งค่า chat.plugins.marketplaces: 
    "chat.plugins.marketplaces": [
  "honeydew-ai/honeydew-ai-coding-agents-plugins"
]

ติดตั้งปลั๊กอิน

  1. เปิดมุมมอง Extensions (CMD+Shift+X บน macOS หรือ Ctrl+Shift+X บน Windows/Linux)
  2. ป้อน @agentPlugins ในช่องค้นหา
  3. ค้นหาปลั๊กอิน Honeydew AI และคลิก Install

ครั้งแรกที่คุณติดตั้งปลั๊กอินจาก marketplace ใหม่ VS Code จะแสดงพร้อมท์ความน่าเชื่อถือ — ตรวจสอบแหล่งที่มาของ marketplace ก่อนยืนยัน

อัปเดตปลั๊กอิน

หากเปิดใช้งาน extensions.autoUpdate ในการตั้งค่า VS Code ปลั๊กอินจะอัปเดตโดยอัตโนมัติ หากต้องการอัปเดตด้วยตนเอง ให้เปิด Command Palette และรัน Extensions: Check for Extension Updates

MCP Server

ใช้ส่วนนี้หากองค์กรของคุณใช้ Honeydew endpoint ที่กำหนดเอง หรือหากคุณต้องการกำหนดค่า MCP servers โดยไม่ต้องติดตั้งปลั๊กอิน ปิดการใช้งานการเชื่อมต่อ Honeydew MCP ที่เพิ่มโดยปลั๊กอิน จากนั้นเพิ่ม endpoint ที่กำหนดเองของคุณโดยใช้คำแนะนำด้านล่าง

Honeydew MCP server เชื่อมต่อ VS Code กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน Settings > MCP Server ใน Honeydew Studio

  1. เปิด Command Palette ด้วย CMD+Shift+P (macOS) หรือ Ctrl+Shift+P (Windows/Linux)
  2. เลือก MCP: Add Server...
  3. เลือก HTTP (HTTP or Server-Sent Events)
  4. ป้อน URL ของ Honeydew MCP server: https://mcp.honeydew.cloud/mcp
  5. ป้อน honeydew เป็นชื่อเซิร์ฟเวอร์

การดำเนินการนี้จะเพิ่มเซิร์ฟเวอร์ลงในไฟล์ .vscode/mcp.json ของคุณ เปิดไฟล์และเพิ่มส่วนหัวตามต้องการ:

```json theme={null} { "servers": { "honeydew": { "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
<Tab title="API Key">
  ```json theme={null}
  {
    "servers": {
      "honeydew": {
        "type": "http",
        "url": "https://mcp.honeydew.cloud/mcp",
        "headers": {
          "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
        }
      }
    }
  }
  ```
</Tab>

Honeydew Documentation MCP (ไม่บังคับ)

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

เพิ่มเนื้อหาต่อไปนี้ลงใน .vscode/mcp.json ของคุณ:

{
  "servers": {
    "honeydew-docs": {
      "type": "http",
      "url": "https://honeydew.ai/docs/mcp"
    }
  }
}

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew ให้เปิด .vscode/mcp.json และลบรายการ honeydew ออกจากออบเจกต์ servers หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP ให้ลบรายการ honeydew-docs ออกจากไฟล์เดียวกัน

Codex CLI

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

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

เพิ่ม marketplace ใน Codex:

codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

จากนั้นเปิด Codex ด้วย codex และพิมพ์ /plugins เพื่อเรียกดูและติดตั้งปลั๊กอิน Honeydew AI

การอัปเดตปลั๊กอิน

หากต้องการอัปเดต marketplace ของ Honeydew ให้รัน:

codex plugin marketplace upgrade honeydew-ai-coding-agents-plugins

จากนั้นเปิด Codex และพิมพ์ /plugins เพื่อใช้การอัปเดต

การตั้งค่า MCP

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

เซิร์ฟเวอร์ Honeydew MCP เชื่อมต่อ Codex กับ Honeydew Semantic Layer สำหรับการสำรวจโมเดล การสอบถามข้อมูล การจัดการโมเดล และการเข้าถึงเอกสาร

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่า คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

บรรทัดคำสั่ง

codex mcp add honeydew \
    --url https://mcp.honeydew.cloud/mcp

จากนั้นเปิด Codex ด้วย codex คุณจะได้รับแจ้งให้รับรองความถูกต้อง ด้วย OAuth กับ Honeydew

หลังจากเพิ่มเซิร์ฟเวอร์แล้ว ให้เปิดไฟล์การกำหนดค่า ที่ ~/.codex/config.toml และเพิ่มส่วนหัว ในส่วน [mcp_servers.honeydew] ตามความจำเป็น

การกำหนดค่า TOML

เพิ่มเนื้อหาต่อไปนี้ลงใน ~/.codex/config.toml (หรือ .codex/config.toml ในโปรเจกต์ที่เชื่อถือได้):

[mcp_servers.honeydew]
url = "https://mcp.honeydew.cloud/mcp"

[mcp_servers.honeydew.env_http_headers]
Authorization = "HONEYDEW_AUTH"

ตั้งค่าตัวแปรสภาพแวดล้อม HONEYDEW_AUTH เป็น Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (ดู การรับรองความถูกต้อง)

Honeydew Documentation MCP (ไม่บังคับ)

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

codex mcp add honeydew-docs \
    --url https://honeydew.ai/docs/mcp

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew:

codex mcp remove honeydew

หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP:

codex mcp remove honeydew-docs

Codex

#### การติดตั้งปลั๊กอิน

หมายเหตุ

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

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

เพิ่ม marketplace ใน Codex:

  1. เปิด ปลั๊กอิน
  2. คลิกลูกศรแบบเลื่อนลงและเลือก เพิ่ม marketplace
  3. เพิ่ม honeydew-ai/honeydew-ai-coding-agents-plugins

หมายเหตุ

คุณยังสามารถเพิ่ม marketplace จาก Codex CLI:

codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins

จากนั้นติดตั้งปลั๊กอิน:

  1. เปิด ปลั๊กอิน
  2. เลือก marketplace Honeydew AI
  3. ติดตั้งปลั๊กอิน Honeydew

การตั้งค่า MCP

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

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่า คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

Honeydew MCP

  1. เปิดแอปพลิเคชัน Codex

  2. ไปที่ การตั้งค่า -> เซิร์ฟเวอร์ MCP

  3. ภายใต้ เซิร์ฟเวอร์ที่กำหนดเอง คลิก เพิ่มเซิร์ฟเวอร์

  4. ตั้งชื่อเซิร์ฟเวอร์เป็น honeydew

  5. เลือก Streamable HTTP เป็นประเภทการขนส่ง

  6. ตั้งค่า URL เป็น https://mcp.honeydew.cloud/mcp

  7. เว้นช่อง ตัวแปรสภาพแวดล้อมโทเค็น Bearer ว่างไว้

  8. กำหนดค่าการรับรองความถูกต้องดังนี้:

    การรับรองความถูกต้อง OAuth

    Codex จะเปลี่ยนเส้นทางคุณเพื่อรับรองความถูกต้องกับ Honeydew เมื่อเชื่อมต่อ ไม่จำเป็นต้องมีการกำหนดค่าเพิ่มเติม

    การรับรองความถูกต้อง HTTP Basic

    เพิ่มส่วนหัว Authorization ในรายการส่วนหัวด้านบนด้วยค่า Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET> (ดู การรับรองความถูกต้อง)

การแก้ไขปัญหาการรับรองความถูกต้อง MCP

หากเซิร์ฟเวอร์ Honeydew MCP ไม่ได้รับการรับรองความถูกต้องใน Codex และตัวเลือก "รับรองความถูกต้อง" ไม่ปรากฏ:

  1. ติดตั้ง Codex CLI
  2. รัน codex mcp login honeydew

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. ไปที่ การตั้งค่า -> เซิร์ฟเวอร์ MCP
  2. ภายใต้ เซิร์ฟเวอร์ที่กำหนดเอง คลิก เพิ่มเซิร์ฟเวอร์
  3. ตั้งชื่อเซิร์ฟเวอร์เป็น honeydew-docs
  4. เลือก Streamable HTTP เป็นประเภทการขนส่ง
  5. ตั้งค่า URL เป็น https://honeydew.ai/docs/mcp

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew:

  1. ไปที่ การตั้งค่า -> เซิร์ฟเวอร์ MCP
  2. ค้นหา honeydew ภายใต้ เซิร์ฟเวอร์ที่กำหนดเอง และคลิก ลบ

หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP:

  1. ไปที่ การตั้งค่า -> เซิร์ฟเวอร์ MCP
  2. ค้นหา honeydew-docs ภายใต้ เซิร์ฟเวอร์ที่กำหนดเอง และคลิก ลบ

Antigravity

#### เซิร์ฟเวอร์ MCP

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่า คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

  1. เปิดตัวแก้ไข Antigravity

  2. คลิกเมนูแบบเลื่อนลง ... ที่ด้านบนของแผงเอเจนต์

  3. คลิก จัดการเซิร์ฟเวอร์ MCP

  4. คลิก ดูการกำหนดค่าดิบ

  5. เพิ่มเนื้อหาต่อไปนี้ลงใน mcp_config.json:

    ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` 
    <Tab title="API Key">
  ```json theme={null}
  {
    "name": "honeydew",
    "type": "http",
    "url": "https://mcp.honeydew.cloud/mcp",
    "headers": {
      "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
    }
  }
  ```
</Tab>

  6. บันทึกไฟล์

Honeydew Documentation MCP (ไม่บังคับ)

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

  1. เปิดตัวแก้ไข Antigravity
  2. คลิกเมนูแบบเลื่อนลง ... ที่ด้านบนของแผงเอเจนต์
  3. คลิก จัดการเซิร์ฟเวอร์ MCP
  4. คลิก ดูการกำหนดค่าดิบ
  5. เพิ่มเนื้อหาต่อไปนี้ลงใน mcp_config.json: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  6. บันทึกไฟล์

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew:

  1. เปิดตัวแก้ไข Antigravity
  2. คลิกเมนูแบบเลื่อนลง ... ที่ด้านบนของแผงเอเจนต์
  3. คลิก จัดการเซิร์ฟเวอร์ MCP
  4. คลิก ดูการกำหนดค่าดิบ
  5. ลบรายการ honeydew และ honeydew-docs ออกจาก mcp_config.json
  6. บันทึกไฟล์

OpenCode

#### เซิร์ฟเวอร์ MCP

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่า คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

รันคำสั่งต่อไปนี้ และปฏิบัติตามพร้อมต์แบบโต้ตอบ: 
  ```bash theme={null}
  opencode mcp add
  ```

  เมื่อได้รับพร้อมต์ ให้ป้อนค่าต่อไปนี้:

  1. **ตำแหน่ง**: เลือกขอบเขตที่คุณต้องการ (โปรเจกต์ปัจจุบันหรือทั่วโลก)
  2. **ชื่อเซิร์ฟเวอร์ MCP**: `honeydew`
  3. **ประเภทเซิร์ฟเวอร์ MCP**: `Remote`
  4. **URL เซิร์ฟเวอร์ MCP**: `https://mcp.honeydew.cloud/mcp`
  5. **การรับรองความถูกต้อง OAuth**: `Yes`
  6. **ID ไคลเอ็นต์ที่ลงทะเบียนล่วงหน้า**: `No`
</Tab>

<Tab title="JSON configuration">
  เพิ่มเนื้อหาต่อไปนี้ลงในไฟล์ `opencode.jsonc` ของคุณ:

  <Tabs>
    <Tab title="OAuth (recommended)">
      ```json theme={null}
      {
        "$schema": "https://opencode.ai/config.json",
        "mcp": {
          "honeydew": {
            "type": "remote",
            "url": "https://mcp.honeydew.cloud/mcp",
            "oauth": {}
          }
        }
      }
      ```

      จากนั้นรับรองความถูกต้องกับ Honeydew:

      ```bash theme={null}
      opencode mcp auth honeydew
      ```

      การดำเนินการนี้จะเปิดหน้าต่างเบราว์เซอร์เพื่อดำเนินการรับรองความถูกต้อง OAuth ให้เสร็จสมบูรณ์
    </Tab>

    <Tab title="API Key">
      ```json theme={null}
      {
        "$schema": "https://opencode.ai/config.json",
        "mcp": {
          "honeydew": {
            "type": "remote",
            "url": "https://mcp.honeydew.cloud/mcp",
            "headers": {
              "Authorization": "Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>"
            }
          }
        }
      }
      ```
    </Tab>
  </Tabs>
</Tab>

การรับรองความถูกต้องซ้ำ

หากต้องการรับรองความถูกต้องซ้ำ ให้ตรวจสอบสถานะของคุณและออกจากระบบก่อน:

opencode mcp auth list
opencode mcp logout honeydew
opencode mcp auth honeydew

Honeydew Documentation MCP (ไม่บังคับ)

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

รัน `opencode mcp add` และป้อนค่าต่อไปนี้: 
  1. **ชื่อเซิร์ฟเวอร์ MCP**: `honeydew-docs`
  2. **ประเภทเซิร์ฟเวอร์ MCP**: `Remote`
  3. **URL เซิร์ฟเวอร์ MCP**: `https://honeydew.ai/docs/mcp`
  4. **การรับรองความถูกต้อง OAuth**: `No`
</Tab>

<Tab title="JSON configuration">
  เพิ่มเนื้อหาต่อไปนี้ลงในไฟล์ `opencode.jsonc` ของคุณ:

  ```json theme={null}
  {
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
      "honeydew-docs": {
        "type": "remote",
        "url": "https://honeydew.ai/docs/mcp"
      }
    }
  }
  ```
</Tab>

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew ให้ลบรายการ honeydew ออกจากไฟล์ opencode.jsonc ของคุณ หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP ให้ลบรายการ honeydew-docs ออกจากไฟล์เดียวกัน

Kiro

Kiro IDE และ Kiro CLI ใช้ไฟล์การกำหนดค่า MCP ร่วมกัน ดังนั้นขั้นตอนด้านล่างจึงใช้ได้กับทั้งสอง

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

Kiro อ่านเซิร์ฟเวอร์ MCP จากไฟล์การกำหนดค่าสองไฟล์:

  • เวิร์กสเปซ: .kiro/settings/mcp.json (เฉพาะโปรเจกต์ปัจจุบัน)
  • ผู้ใช้: ~/.kiro/settings/mcp.json (ใช้กับทุกเวิร์กสเปซ)

หากมีทั้งสองไฟล์ การกำหนดค่าเวิร์กสเปซจะมีความสำคัญกว่า

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ของผู้เช่า คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

เพิ่มเซิร์ฟเวอร์ Honeydew MCP ลงในไฟล์ mcp.json ไฟล์ใดไฟล์หนึ่ง (เวิร์กสเปซหรือผู้ใช้):

```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp" } } } ``` 
  เมื่อเชื่อมต่อกับ Honeydew ครั้งแรก Kiro จะให้ URL สำหรับการรับรองความถูกต้อง
  เปิดในเบราว์เซอร์ของคุณเพื่อดำเนินการรับรองความถูกต้อง OAuth ให้เสร็จสมบูรณ์
</Tab>
```json theme={null} { "mcpServers": { "honeydew": { "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } } } ```

ใน Kiro CLI ให้รัน /mcp เพื่อตรวจสอบว่าเซิร์ฟเวอร์เชื่อมต่ออยู่ ใน Kiro IDE เซิร์ฟเวอร์จะปรากฏภายใต้แผง MCP

Honeydew Documentation MCP (ไม่บังคับ)

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

เพิ่มข้อมูลต่อไปนี้ลงใน mcp.json ของคุณ:

{
  "mcpServers": {
    "honeydew-docs": {
      "url": "https://honeydew.ai/docs/mcp"
    }
  }
}

การลบเซิร์ฟเวอร์ MCP

หากต้องการลบเซิร์ฟเวอร์ MCP ของ Honeydew ให้ลบรายการ honeydew ออกจาก mcp.json ของคุณ หากต้องการลบเซิร์ฟเวอร์ Honeydew Documentation MCP ให้ลบรายการ honeydew-docs ออกจากไฟล์เดียวกัน

Snowflake Intelligence

Snowflake เชื่อมต่อกับเซิร์ฟเวอร์ MCP ภายนอกผ่าน [MCP connectors](https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-mcp-connectors) ทำให้เครื่องมือของ Honeydew พร้อมใช้งานสำหรับ Snowflake Intelligence และ Cortex Agents

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

  • บทบาทที่มีสิทธิ์ CREATE INTEGRATION บนบัญชี
  • บทบาทที่มีสิทธิ์ CREATE MCP SERVER บนสคีมาเป้าหมาย

โดยค่าเริ่มต้น เฉพาะบทบาท ACCOUNTADMIN เท่านั้นที่ถือสิทธิ์เหล่านี้

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

```sql theme={null} CREATE API INTEGRATION honeydew_mcp_integration API_PROVIDER = external_mcp API_ALLOWED_PREFIXES = ('https://mcp.honeydew.cloud/mcp') API_USER_AUTHENTICATION = ( TYPE = OAUTH_DYNAMIC_CLIENT OAUTH_RESOURCE_URL = 'https://mcp.honeydew.cloud/mcp' OAUTH_ALLOWED_SCOPES = ('openid') ) ENABLED = TRUE; ``` 
<Step title="Create the external MCP server">
  เซิร์ฟเวอร์ MCP ภายนอกเป็นออบเจกต์ระดับสคีมา
  ที่อ้างอิงการรวม API:

  ```sql theme={null}
  CREATE EXTERNAL MCP SERVER honeydew
    WITH DISPLAY_NAME = 'Honeydew MCP Server'
    URL = 'https://mcp.honeydew.cloud/mcp'
    API_INTEGRATION = honeydew_mcp_integration;
  ```
</Step>

<Step title="Grant access">
  อนุญาตการใช้งานทั้งการรวมและเซิร์ฟเวอร์ MCP
  ให้กับบทบาทใดๆ ที่ต้องการเข้าถึง Honeydew:

  ```sql theme={null}
  GRANT USAGE ON INTEGRATION honeydew_mcp_integration TO ROLE <role>;
  GRANT USAGE ON EXTERNAL MCP SERVER honeydew TO ROLE <role>;
  ```
</Step>

<Step title="Add the MCP server to an agent">
  เพิ่มเซิร์ฟเวอร์ MCP `honeydew` เป็นเครื่องมือให้กับ Cortex Agent
  หรือเอเจนต์ Snowflake Intelligence
  ผู้ใช้จะได้รับแจ้งให้รับรองความถูกต้องด้วย OAuth กับ Honeydew ในการใช้งานครั้งแรก
</Step>

หมายเหตุ

เซิร์ฟเวอร์ Honeydew Documentation MCP แบบสแตนด์อโลนไม่ได้รับการสนับสนุน ใน Snowflake เนื่องจากเซิร์ฟเวอร์ MCP ภายนอกของ Snowflake ต้องใช้การรับรองความถูกต้อง ด้วย OAuth และเซิร์ฟเวอร์เอกสารไม่มีการรับรองความถูกต้อง การเข้าถึงเอกสารสามารถใช้ได้ผ่านเครื่องมือเอกสารของเซิร์ฟเวอร์ MCP ของ Honeydew

การลบเซิร์ฟเวอร์ MCP

ลบเซิร์ฟเวอร์ MCP ก่อน จากนั้นจึงลบการรวม API:

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

ไคลเอนต์อื่นๆ

ไคลเอนต์ที่เข้ากันได้กับ MCP ใดๆ สามารถเชื่อมต่อ กับเซิร์ฟเวอร์ MCP ของ Honeydew โดยใช้การส่งข้อมูล HTTP มาตรฐาน

ใช้การกำหนดค่า JSON ต่อไปนี้ เป็นจุดเริ่มต้น:

หมายเหตุ

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew ที่กำหนดเอง ให้แทนที่ https://mcp.honeydew.cloud/mcp ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp" } ``` ```json theme={null} { "name": "honeydew", "type": "http", "url": "https://mcp.honeydew.cloud/mcp", "headers": { "Authorization": "Basic " } } ```

ดู Server URL Authentication และ Configuration สำหรับรายละเอียดเกี่ยวกับพารามิเตอร์แต่ละรายการ

ตัวอย่างการใช้งาน

เมื่อเชื่อมต่อแล้ว คุณสามารถถามผู้ช่วย AI ของคุณด้วยคำถามเช่น:

  • "มีเอนทิตีใดบ้างในโมเดลเชิงความหมาย"
  • "แสดงแอตทริบิวต์และเมตริก สำหรับเอนทิตี orders"
  • "มีโดเมนใดบ้างที่กำหนดในโมเดล"
  • "มีตารางใดบ้างในสคีมา analytics"
  • "มีคำสั่งซื้อกี่รายการในเดือนที่แล้ว"
  • "สร้างเมตริกใหม่สำหรับรายได้รวม บนเอนทิตี orders"
  • "มูลค่าคำสั่งซื้อเฉลี่ยตามภูมิภาค ในไตรมาสที่แล้วคือเท่าใด"

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

ปัญหาการรับรองความถูกต้องด้วย OAuth

ตรวจสอบว่าไคลเอนต์ของคุณรองรับ OAuth ตรวจสอบให้แน่ใจว่าคุณมีสิทธิ์ที่จำเป็นในเวิร์กสเปซ Honeydew และลองรับรองความถูกต้องใหม่ผ่านอินเทอร์เฟซการจัดการ MCP ของไคลเอนต์ของคุณ

การรับรองความถูกต้องใหม่ใน Claude Code

พิมพ์ /mcp เลือก Honeydew MCP จากรายการ เลือก "ล้างการรับรองความถูกต้อง" หรือ "รับรองความถูกต้อง" จากนั้นทำตามขั้นตอน OAuth ในเบราว์เซอร์เพื่อเชื่อมต่อกับ Honeydew อีกครั้ง

ปัญหาการเชื่อมต่อ

ยืนยันว่า URL ของเซิร์ฟเวอร์ MCP ตรงกับ https://mcp.honeydew.cloud/mcp และตรวจสอบว่าไวยากรณ์การกำหนดค่า MCP ของไคลเอนต์ของคุณถูกต้อง หากองค์กรของคุณใช้ชื่อโฮสต์ที่กำหนดเอง ให้ตรวจสอบว่า URL ตรงกับ ชื่อโฮสต์ผู้เช่าของคุณที่ปรากฏใน การตั้งค่า > เซิร์ฟเวอร์ MCP ใน Honeydew Studio

เครื่องมือหายไป

ตรวจสอบว่าการรับรองความถูกต้องสำเร็จ ตรวจสอบสิทธิ์การเข้าถึงเวิร์กสเปซ Honeydew ของคุณ และตรวจสอบคอนโซลของไคลเอนต์ของคุณสำหรับข้อความแสดงข้อผิดพลาด

ผลลัพธ์เกินจำนวนโทเค็นสูงสุดที่อนุญาต (Claude)

ใน Claude Code, Claude Desktop และ Claude.ai การเรียกใช้เครื่องมืออาจล้มเหลวด้วยข้อผิดพลาด ที่ผลลัพธ์เกินจำนวนโทเค็นสูงสุดที่อนุญาต เครื่องมือวิเคราะห์ของ Honeydew เช่น monitor_analysis และ get_analysis_step_details สามารถส่งคืนผลลัพธ์ขนาดใหญ่ ที่เกินขีดจำกัดผลลัพธ์ MCP ของ Claude

Claude จะเตือนเมื่อผลลัพธ์ของเครื่องมือ MCP เกิน 10,000 โทเค็นและปฏิเสธผลลัพธ์ที่เกิน ขีดจำกัดเริ่มต้นที่ 25,000 โทเค็น หากต้องการเพิ่มขีดจำกัด ให้ตั้งค่าตัวแปรสภาพแวดล้อม MAX_MCP_OUTPUT_TOKENS ก่อนเปิดใช้ Claude:

export MAX_MCP_OUTPUT_TOKENS=50000
claude

ดู MCP output limits and warnings ในเอกสารของ Claude สำหรับรายละเอียด

สำหรับการสนับสนุนเพิ่มเติม โปรดติดต่อฝ่ายสนับสนุน Honeydew ที่ support@honeydew.ai

เครื่องมือที่มีให้ใช้งาน

เครื่องมือที่ทำเครื่องหมายเป็น อ่านอย่างเดียว จะไม่แก้ไข โมเดลเชิงความหมายหรือคลังข้อมูล

เคล็ดลับ

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

เซสชันและเวิร์กสเปซ

list_workspaces

อ่านอย่างเดียว

แสดงรายการเวิร์กสเปซทั้งหมดที่มีให้ใช้งาน ส่งคืนชื่อเวิร์กสเปซและประเภทคลังข้อมูล (snowflake, databricks หรือ bigquery) ใช้ประเภทคลังข้อมูลเพื่อแจ้งการใช้งานโมเดลเชิงความหมาย

list_workspace_branches

อ่านอย่างเดียว

แสดงรายการสาขาทั้งหมดที่มีให้ใช้งานสำหรับเวิร์กสเปซ

ชื่อของเวิร์กสเปซ

get_session_workspace_and_branch

อ่านอย่างเดียว

รับเวิร์กสเปซและสาขาที่ตั้งไว้สำหรับเซสชันปัจจุบัน

set_session_workspace_and_branch

อ่านอย่างเดียว

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

ชื่อของเวิร์กสเปซ สาขาที่จะใช้

create_workspace_branch

สร้างสาขาใหม่สำหรับเวิร์กสเปซที่มีอยู่ สาขาถูกสร้างจากสถานะปัจจุบันของสาขา prod ของเวิร์กสเปซ หากไม่ได้ปักหมุดเวิร์กสเปซผ่านส่วนหัว เซสชันจะสลับไปยังสาขาใหม่โดยอัตโนมัติ

ชื่อของเวิร์กสเปซที่จะสร้างสาขา ชื่อของสาขาใหม่ที่จะสร้าง

delete_workspace_branch

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

ชื่อของเวิร์กสเปซที่มีสาขาที่จะลบ ชื่อของสาขาที่จะลบ

get_branch_history

อ่านอย่างเดียว

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

จำนวนการเปลี่ยนแปลงสูงสุดที่จะส่งคืน

create_pr_for_working_branch

สร้างคำขอดึงข้อมูล (pull request) สำหรับสาขาทำงานของเซสชันปัจจุบัน ส่งคืน URL ของ PR เมื่อสำเร็จ

ชื่อเรื่องสำหรับคำขอดึงข้อมูล คำอธิบายสำหรับคำขอดึงข้อมูล

คำถามและการวิเคราะห์

initiate_analysis

อ่านอย่างเดียว

เริ่มหรือดำเนินการวิเคราะห์ข้อมูลต่อ ส่งคืน conversation_id — ใช้ monitor_analysis เพื่อสอบถามความคืบหน้าและผลลัพธ์ และ abort_analysis เพื่อหยุดก่อนกำหนด ดู Deep Analysis สำหรับรายละเอียดเพิ่มเติม

คำถามภาษาธรรมชาติที่จะถาม ชื่อเอเจนต์สำหรับการสนทนาใหม่ ละเว้นสำหรับคำถามติดตามผล — เอเจนต์จะถูกสืบทอด จากการสนทนาที่มีอยู่ ID การสนทนาที่มีอยู่เพื่อดำเนินการต่อ หรือละเว้นเพื่อเริ่มการสนทนาใหม่

monitor_analysis

อ่านอย่างเดียว

สอบถามข้อความความคืบหน้าใหม่จากการวิเคราะห์ที่กำลังดำเนินการ การเรียกแต่ละครั้งจะส่งคืนเฉพาะข้อความตั้งแต่การเรียกครั้งล่าสุด สอบถามซ้ำจนกว่า status จะเป็น DONE หรือ NO_CHAT_CURRENTLY_RUNNING

ID การสนทนาที่ส่งคืนโดย `initiate_analysis` จำนวนข้อความสูงสุดที่จะส่งคืนต่อการเรียก ID ข้อความที่จะเล่นซ้ำ ใช้ `last_received_message_id` จากผลลัพธ์ก่อนหน้าเพื่อกู้คืนข้อความที่พลาด

get_analysis_step_details

อ่านอย่างเดียว

ดึงรายละเอียดทั้งหมดสำหรับขั้นตอนการวิเคราะห์เฉพาะ รวมถึงคิวรีเชิงความหมาย คำสั่ง SQL บริบทที่ใช้ และข้อมูลที่ดึงมาในขั้นตอนนั้น

ID การสนทนาที่ส่งคืนโดย `initiate_analysis` ID ขั้นตอนจาก `monitor_analysis` (เช่น `STEP/0`)

abort_analysis

อ่านอย่างเดียว

ยกเลิกการวิเคราะห์ที่กำลังดำเนินการ สามารถดำเนินการต่อจากจุดที่ยกเลิกได้ด้วย initiate_analysis

ID การสนทนาที่ส่งคืนโดย `initiate_analysis`

list_analysis_chats

อ่านอย่างเดียว

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

จำนวนการสนทนาสูงสุดที่จะส่งคืน จำนวนการสนทนาที่จะข้ามสำหรับการแบ่งหน้า

provide_analysis_feedback

ตั้งค่าหรือล้างข้อเสนอแนะในการสนทนาการวิเคราะห์เฉพาะ มีรายการข้อเสนอแนะเดียวต่อการสนทนา (ไม่ใช่ต่อคำถาม) — ควรสะท้อนคุณภาพโดยรวมของขั้นตอนการสนทนาทั้งหมด

เรียกใช้หลังจาก monitor_analysis เสร็จสมบูรณ์และผู้ใช้แสดง ความพึงพอใจหรือไม่พอใจกับผลลัพธ์ ใช้สตริงยืนยันสั้นๆ สำหรับข้อเสนอแนะเชิงบวก (เช่น Good) หรือรูปแบบ <Reason>: <details> สำหรับข้อเสนอแนะเชิงลบ โดยที่ Reason เป็นหนึ่งใน Chart Issue, Data Issue, Wrong Judgement หรือ Other

ID การสนทนาของการสนทนาการวิเคราะห์ ข้อความข้อเสนอแนะที่จะเก็บ หรือ `null` เพื่อล้างข้อเสนอแนะที่มีอยู่

get_stored_conversation

อ่านอย่างเดียว

ส่งคืนข้อความทั้งหมดจากการสนทนาการวิเคราะห์ที่มีอยู่ ใช้เพื่อตรวจสอบเนื้อหาทั้งหมดของการสนทนาก่อนหน้า is_complete ในการตอบสนองระบุว่าการสนทนา ถึงสถานะสิ้นสุดหรือไม่

ID การสนทนาจาก `list_analysis_chats` หากเป็น `true` ให้รวมรายการความคืบหน้า `step_start` และ `step_insight` หากเป็น `false` ให้ส่งคืนเฉพาะการตอบสนองสุดท้ายและข้อความแผน/การตีความ

การเรียกดูและการค้นพบ

list_entities

อ่านอย่างเดียว

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

get_entity

อ่านอย่างเดียว

รับข้อมูลโดยละเอียดเกี่ยวกับเอนทิตี รวมถึงแอตทริบิวต์ เมตริก ชุดข้อมูล ความสัมพันธ์ และคำจำกัดความ YAML ชื่อของเอนทิตี

get_field

อ่านอย่างเดียว

รับข้อมูลโดยละเอียดเกี่ยวกับฟิลด์เฉพาะ (แอตทริบิวต์หรือเมตริก) ภายในเอนทิตี รวมถึงนิยาม YAML ของฟิลด์นั้น

ชื่อของเอนทิตีที่มีฟิลด์นั้น ชื่อของฟิลด์

list_domains

อ่านอย่างเดียว

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

get_domain

อ่านอย่างเดียว

รับข้อมูลโดยละเอียดเกี่ยวกับโดเมน รวมถึงเอนทิตี ตัวกรอง พารามิเตอร์ และนิยาม YAML

ชื่อของโดเมน

search_model

อ่านอย่างเดียว

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

ใช้ไวยากรณ์ entity.field เพื่อจำกัดการค้นหาให้อยู่เฉพาะฟิลด์ภายในเอนทิตีที่ระบุ ตัวอย่างเช่น customers.balance ค้นหาฟิลด์ balance บนเอนทิตีที่ตรงกับ customers; customers. คืนค่าฟิลด์ทั้งหมดของเอนทิตีที่ตรงกัน ในโหมด OR/AND การจับคู่บางส่วนจะใช้กับทั้งส่วนเอนทิตีและฟิลด์ — cust.bal จับคู่ customers.balance

สตริงคำค้นหา ควบคุมวิธีการจับคู่คำค้นหา:
  • OR — แยกตามช่องว่าง คืนค่าวัตถุที่ตรงกับคำใดคำหนึ่ง
  • AND — แยกตามช่องว่าง คืนค่าวัตถุที่ตรงกับทุกคำเท่านั้น
  • EXACT — ใช้สตริงเต็มตามที่เป็น คืนค่าวัตถุที่มีชื่อ ชื่อที่แสดง หรือป้ายกำกับตรงกันแบบทั้งหมด

การค้นพบคลังข้อมูล

list_databases

อ่านอย่างเดียว

แสดงรายการฐานข้อมูลทั้งหมดที่พร้อมใช้งานในคลังข้อมูลที่เชื่อมต่อ

list_schemas

อ่านอย่างเดียว

แสดงรายการสคีมาทั้งหมดในฐานข้อมูลที่ระบุในคลังข้อมูลที่เชื่อมต่อ

ชื่อฐานข้อมูล

list_tables

อ่านอย่างเดียว

แสดงรายการตาราง/วิวในฐานข้อมูลและสคีมาที่ระบุในคลังข้อมูลที่เชื่อมต่อ

ชื่อฐานข้อมูล ชื่อสคีมา

get_table_info

อ่านอย่างเดียว

รับข้อมูลโดยละเอียดเกี่ยวกับตาราง/วิวในคลังข้อมูล รวมถึงคอลัมน์และข้อมูลเมตา

ชื่อฐานข้อมูล ชื่อสคีมา ชื่อตาราง

โมเดลเชิงความหมาย

import_tables

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

รายการชื่อตารางแบบเต็มรูปแบบในรูปแบบ `database.schema.table`

create_entity

สร้างเอนทิตีใหม่ในโมเดลเชิงความหมาย จากนิยาม YAML

นิยาม YAML สำหรับเอนทิตี นิยาม YAML สำหรับชุดข้อมูล

create_object

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

นิยาม YAML ของวัตถุ สร้างวัตถุแม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

update_object

อัปเดตวัตถุโมเดลเชิงความหมายที่มีอยู่จากนิยาม YAML ประเภทที่รองรับ: เอนทิตี แอตทริบิวต์ที่คำนวณได้ เมตริก ชุดข้อมูล ชุดข้อมูลไดนามิก โดเมน และพารามิเตอร์ระดับโลก

นิยาม YAML ของวัตถุ คีย์ของวัตถุที่จะอัปเดต อัปเดตวัตถุแม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

validate_object

อ่านอย่างเดียว

ตรวจสอบนิยาม YAML ของวัตถุโมเดลเชิงความหมายโดยไม่ต้องสร้างหรืออัปเดต ประเภทที่รองรับ: เอนทิตี แอตทริบิวต์ที่คำนวณได้ เมตริก ชุดข้อมูล ชุดข้อมูลไดนามิก โดเมน และพารามิเตอร์ระดับโลก

นิยาม YAML ที่จะตรวจสอบ คีย์ของวัตถุที่จะใช้ตรวจสอบ

delete_object

ลบวัตถุโมเดลเชิงความหมายตามคีย์

คีย์ของวัตถุที่จะลบ ลบวัตถุแม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

เอเจนต์

list_agents

อ่านอย่างเดียว

แสดงรายการเอเจนต์ทั้งหมดพร้อมชื่อ คำอธิบาย โดเมน และการอ้างอิงบริบท

get_agent

อ่านอย่างเดียว

รับข้อมูลโดยละเอียดเกี่ยวกับเอเจนต์ รวมถึงนิยาม frontmatter YAML

ชื่อของเอเจนต์ที่จะดึงข้อมูล

create_agent

สร้างเอเจนต์ใหม่

ข้อมูลเมตาสำหรับเอเจนต์ใหม่ ชื่อแบบลำดับชั้น (เช่น `growth-analyst`, `finance/budget-analyst`) 
<ParamField body="display_name" type="string" required>
  ชื่อที่มนุษย์อ่านได้ซึ่งแสดงใน UI
</ParamField>

<ParamField body="description" type="string" required>
  คำอธิบายวัตถุประสงค์และความสามารถของเอเจนต์
</ParamField>

<ParamField body="domain" type="string" required>
  โดเมนที่เอเจนต์นี้ทำงาน
</ParamField>

<ParamField body="welcome_message" type="string">
  ข้อความแนะนำที่แสดงเมื่อผู้ใช้เริ่มเซสชัน
</ParamField>

<ParamField body="sample_questions" type="string[]">
  คำถามตัวอย่างที่แสดงแก่ผู้ใช้
</ParamField>

<ParamField body="context" type="string[]">
  ชื่อรายการบริบทหรือรูปแบบ glob ที่จะโหลดเข้าสู่เซสชัน
  (เช่น `skills/**`, `knowledge/marketing/**`)
</ParamField>

<ParamField body="owner" type="string">
  ตัวระบุเจ้าของเอเจนต์
</ParamField>
เนื้อหา Markdown ที่ต่อท้ายหลัง frontmatter ข้อความนี้จะถูกแทรกลงในพรอมป์ก่อนทุกเซสชันการวิเคราะห์ สร้างเอเจนต์แม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

update_agent

อัปเดตเอเจนต์ที่มีอยู่

ชื่อของเอเจนต์ที่จะอัปเดต นิยามเอเจนต์ที่อัปเดตแบบเต็ม ต้องระบุฟิลด์ที่จำเป็นทั้งหมดจาก `create_agent` — นี่คือการแทนที่แบบเต็ม ไม่ใช่การอัปเดตบางส่วน เนื้อหา Markdown ที่อัปเดตสำหรับเอเจนต์ อัปเดตเอเจนต์แม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

delete_agent

ลบเอเจนต์ตามชื่อ

ชื่อของเอเจนต์ที่จะลบ

รายการบริบท

list_context_items

อ่านอย่างเดียว

แสดงรายการรายการบริบททั้งหมดพร้อมประเภท ชื่อ ชื่อเรื่อง และค่าประเภทย่อย

get_context_item

อ่านอย่างเดียว

รับรายการบริบทตามชื่อ

ชื่อของรายการบริบทที่จะดึงข้อมูล

create_context_item

สร้างรายการบริบทใหม่ รองรับประเภทคำสั่งและความทรงจำ

ข้อมูลเมตาสำหรับรายการบริบทใหม่ ต้องเป็น `instruction` 
<ParamField body="name" type="string" required>
  ชื่อแบบลำดับชั้น
  (เช่น `knowledge/customer/churn-analysis`, `skills/reporting`)
</ParamField>

<ParamField body="subtype" type="string" required>
  หนึ่งใน `knowledge`, `skill` หรือ `instruction`
</ParamField>

<ParamField body="title" type="string" required>
  ชื่อเรื่องที่มนุษย์อ่านได้สำหรับรายการบริบท
</ParamField>

<ParamField body="apply" type="string" required>
  เมื่อใดที่จะใช้บริบท: `always` หรือ `on_demand`
</ParamField>

<ParamField body="description" type="string">
  คำอธิบายที่ AI ใช้ตัดสินใจว่าเมื่อใดควรโหลดรายการนี้
  (จำเป็นเมื่อ `apply` เป็น `on_demand`)
</ParamField>

<ParamField body="owner" type="string">
  ตัวระบุเจ้าของ
</ParamField>

<ParamField body="labels" type="string[]">
  ป้ายกำกับสำหรับจัดระเบียบรายการบริบท
</ParamField>

<ParamField body="related_objects" type="object[]">
  วัตถุเชิงความหมายที่รายการบริบทนี้เกี่ยวข้อง
  แต่ละวัตถุมี `name` (สตริง) และ `type` (`domain`, `entity` หรือ `field`)
</ParamField>

<ParamField body="external_source" type="object">
  แหล่งข้อมูลภายนอกเพื่อดึงเนื้อหา (สำหรับประเภทย่อย `knowledge`)
  มี `tool` (ชื่อเครื่องมือ MCP), `resource_id` (ตัวระบุในเครื่องมือภายนอก)
  และ `cache_max_age_in_seconds` ที่ไม่บังคับ (ค่าเริ่มต้น: `3600`)
</ParamField>
ต้องเป็น `memory` 
<ParamField body="name" type="string" required>
  ชื่อแบบลำดับชั้น (เช่น `events/q4-launch`, `2024/pricing-decision`)
</ParamField>

<ParamField body="subtype" type="string" required>
  หนึ่งใน `event` หรือ `decision_trace`
</ParamField>

<ParamField body="title" type="string" required>
  ชื่อเรื่องที่มนุษย์อ่านได้สำหรับรายการบริบท
</ParamField>

<ParamField body="apply" type="string" required>
  เมื่อใดที่จะใช้บริบท: `always` หรือ `on_demand`
</ParamField>

<ParamField body="from_date" type="string" required>
  วันที่เริ่มต้นของช่วงความทรงจำในรูปแบบ ISO (เช่น `2024-01-01`)
</ParamField>

<ParamField body="to_date" type="string">
  วันที่สิ้นสุดของช่วงความทรงจำในรูปแบบ ISO
</ParamField>

<ParamField body="description" type="string">
  คำอธิบายที่ AI ใช้ตัดสินใจว่าเมื่อใดควรโหลดรายการนี้
  (จำเป็นเมื่อ `apply` เป็น `on_demand`)
</ParamField>

<ParamField body="owner" type="string">
  ตัวระบุเจ้าของ
</ParamField>

<ParamField body="labels" type="string[]">
  ป้ายกำกับสำหรับจัดระเบียบรายการบริบท
</ParamField>

<ParamField body="related_objects" type="object[]">
  วัตถุเชิงความหมายที่รายการบริบทนี้เกี่ยวข้อง
  แต่ละวัตถุมี `name` (สตริง) และ `type` (`domain`, `entity` หรือ `field`)
</ParamField>

<ParamField body="external_source" type="object">
  แหล่งข้อมูลภายนอกเพื่อดึงเนื้อหา
  มี `tool` (ชื่อเครื่องมือ MCP), `resource_id` (ตัวระบุในเครื่องมือภายนอก)
  และ `cache_max_age_in_seconds` ที่ไม่บังคับ (ค่าเริ่มต้น: `3600`)
</ParamField>
เนื้อหา Markdown สำหรับเนื้อหาของรายการบริบท สร้างรายการบริบทแม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

update_context_item

อัปเดตรายการบริบทที่มีอยู่

ชื่อของรายการบริบทที่จะอัปเดต นิยามรายการบริบทที่อัปเดตแบบเต็ม ต้องระบุฟิลด์ที่จำเป็นทั้งหมดจาก `create_context_item` — นี่คือการแทนที่แบบเต็ม ไม่ใช่การอัปเดตบางส่วน เนื้อหา Markdown ที่อัปเดตสำหรับรายการบริบท อัปเดตรายการบริบทแม้ว่าการตรวจสอบจะเกิดข้อผิดพลาด

delete_context_item

ลบรายการบริบทตามชื่อ

ชื่อของรายการบริบทที่จะลบ

คิวรีและตัวอย่าง

get_sql_from_fields

อ่านอย่างเดียว

สร้างคิวรี SQL สำหรับคิวรีเลเยอร์เชิงความหมายที่กำหนดโดยแอตทริบิวต์ เมตริก และตัวกรอง คืนค่า SQL โดยไม่ต้องดำเนินการ

ชื่อแอตทริบิวต์แบบเต็มรูปแบบ (`entity.attribute_name`) รองรับนามแฝง: `entity.attribute_name as alias_name` ชื่อเมตริกแบบเต็มรูปแบบ (`entity.metric_name`) หรือนิพจน์ SQL (เช่น `SUM(entity.field)`) รองรับนามแฝง: `SUM(entity.field) as total` เงื่อนไขตัวกรอง (เช่น `entity.field = 'value'`, `entity.date_field > '2024-01-01'`) รายการฟิลด์สำหรับจัดเรียง รูปแบบ: `entity.field_name` หรือ `entity.field_name DESC` ทิศทางเริ่มต้นคือ ASC เมื่อใช้นามแฝง ให้จัดเรียงตามชื่อนามแฝง โดเมนที่จะใช้คิวรี จำนวนแถวสูงสุดที่จะคืนค่า จำนวนแถวที่จะข้ามสำหรับการแบ่งหน้า เพิ่ม [รายงาน pre-aggregation](/docs/performance/aggregate-awareness#debugging-aggregate-matching) ที่ด้านบนของ SQL ที่ส่งคืน โดยระบุสำหรับทุก pre-aggregation ในเวิร์กสเปซว่า CTE ใด ใช้งานมัน หรือเหตุผลที่ไม่สามารถใช้งานได้

get_data_from_fields

อ่านอย่างเดียว

ดำเนินการคิวรี semantic layer ที่กำหนดโดย attributes, metrics และ filters และส่งคืนข้อมูลผลลัพธ์

ชื่อ attribute แบบ fully qualified (`entity.attribute_name`) รองรับ aliases: `entity.attribute_name as alias_name` ชื่อ metric แบบ fully qualified (`entity.metric_name`) หรือนิพจน์ SQL (เช่น `SUM(entity.field)`) รองรับ aliases: `SUM(entity.field) as total` เงื่อนไขตัวกรอง (เช่น `entity.field = 'value'`, `entity.date_field > '2024-01-01'`) รายการฟิลด์สำหรับการเรียงลำดับ รูปแบบ: `entity.field_name` หรือ `entity.field_name DESC` ทิศทางเริ่มต้นคือ ASC เมื่อใช้ aliases ให้เรียงลำดับตามชื่อ alias โดเมนที่ใช้ในการคิวรี จำนวนแถวสูงสุดที่จะส่งคืน จำนวนแถวที่จะข้ามสำหรับการแบ่งหน้า

list_query_history

อ่านอย่างเดียว

แสดงรายการคิวรีที่ดำเนินการก่อนหน้านี้ผ่าน semantic layer ของ Honeydew เรียงตามรายการล่าสุดก่อน ใช้เพื่อค้นหาและคัดแยกคิวรีที่ล้มเหลว และทำความเข้าใจ ว่าทำไมคิวรีเหล่านั้นจึงล้มเหลว ผู้เรียกที่ไม่ใช่ผู้ดูแลระบบจะเห็นเฉพาะคิวรีของตนเองเท่านั้น

แต่ละคิวรีประกอบด้วยสถานะ ข้อความแสดงข้อผิดพลาด เจ้าของ ไคลเอนต์ โดเมน SQL ต้นฉบับที่ป้อน (SQL ที่ผู้ใช้ส่งสำหรับคิวรีอินเทอร์เฟซ SQL) การประทับเวลาสำหรับการคอมไพล์และการดำเนินการในคลังข้อมูล ID คิวรีของคลังข้อมูล และลิงก์เพื่อเปิดในแอป Honeydew

กรองตามสถานะคิวรี (`FAILED`, `SUCCESS`, `RUNNING` หรือ `CANCELED`) กรองตามไคลเอนต์ที่รันคิวรี (เช่น `Snowflake`, `MCP`) กรองตามชื่อโดเมน กรองตามเจ้าของคิวรี (อีเมลของผู้ใช้ หรือชื่อของคีย์ API) ใช้ได้เฉพาะผู้เรียกที่เป็นผู้ดูแลระบบเท่านั้น ผู้ที่ไม่ใช่ผู้ดูแลระบบจะถูกจำกัดให้เห็น เฉพาะคิวรีของตนเอง เฉพาะคิวรีที่ดำเนินการที่หรือหลังเวลานี้ (ISO 8601) เฉพาะคิวรีที่ดำเนินการที่หรือก่อนเวลานี้ (ISO 8601) ส่งคืนคำจำกัดความ YAML เชิงความหมายของแต่ละคิวรีด้วย (attributes, metrics, filters) เปิดใช้เพื่อสร้างคิวรีซ้ำหรือแก้ไขคิวรี ส่งคืน SQL ของคลังข้อมูลที่คอมไพล์แล้วของแต่ละคิวรีด้วย (ขนาดใหญ่) เปิดใช้สำหรับการดีบักฝั่งคลังข้อมูลของคิวรีเฉพาะ จำนวนคิวรีสูงสุดที่จะส่งคืน จำนวนคิวรีที่จะข้ามสำหรับการแบ่งหน้า

เอกสารประกอบ

search_docs

อ่านอย่างเดียว

ค้นหาฐานความรู้เอกสารประกอบของ Honeydew สำหรับข้อมูลที่เกี่ยวข้อง ตัวอย่างโค้ด การอ้างอิง API และคำแนะนำ ส่งคืนเนื้อหาตามบริบทพร้อมชื่อเรื่องและลิงก์ไปยังหน้าเอกสารประกอบ หากต้องการอ่านเนื้อหาเต็มของหน้า ให้ใช้ query_docs_filesystem

คำค้นหา

query_docs_filesystem

อ่านอย่างเดียว

รันคำสั่งแบบเชลล์ที่อ่านอย่างเดียวกับระบบไฟล์เสมือนในหน่วยความจำ ที่มีหน้าเอกสารประกอบของ Honeydew และสเปก OpenAPI รองรับคำสั่งเช่น rg, grep, find, tree, ls, cat, head และ tail ใช้สำหรับการจับคู่คำสำคัญหรือ regex ที่แม่นยำ การสำรวจโครงสร้าง หรือการอ่านเนื้อหาเต็มของหน้าเฉพาะตามเส้นทาง

คำสั่งเชลล์ที่จะรัน (เช่น `rg -il "keyword" /`, `tree / -L 2`, `head -80 /path/page.mdx`)

คำถามที่พบบ่อย

เครื่องมือใดบ้างที่จำเป็นสำหรับการวิเคราะห์เชิงลึก?

การรัน Deep Analysis ต้องใช้:

หากต้องการตรวจสอบบทสนทนาการวิเคราะห์ที่ผ่านมา ให้เปิดใช้ list_analysis_chats และ get_stored_conversation ด้วย

การจำกัดเอเจนต์ให้ใช้เฉพาะเครื่องมือเหล่านี้มีประโยชน์เมื่อ:

  • ผู้ใช้ที่คุณตั้งใจให้ใช้ทำงานเฉพาะเวิร์กโฟลว์การวิเคราะห์เชิงลึก
  • คุณต้องการให้เอเจนต์โฟกัสกับงานวิเคราะห์เท่านั้น
  • ไคลเอนต์ของคุณจำกัดจำนวนเครื่องมือที่สามารถเปิดใช้ได้ (ตัวอย่างเช่น Databricks Genie Code)

สำหรับกรณีการใช้งานอื่น ให้เปิดเผยเครื่องมือเพิ่มเติมที่ระบุไว้ภายใต้ Tools Available — เอเจนต์จะเลือกเครื่องมือที่เหมาะสมสำหรับแต่ละงาน