Honeydew Semantic Layer

ทางการ

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

ดูบน honeydew.ai

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

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

เอกสาร

MCP Server

MCP คืออะไร?

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

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

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

การติดตั้ง

URL ของเซิร์ฟเวอร์

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

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

การตรวจสอบสิทธิ์

มีสองวิธีในการตรวจสอบสิทธิ์กับ Honeydew MCP Server: OAuth หรือ การตรวจสอบสิทธิ์แบบ HTTP Basic

การตรวจสอบสิทธิ์แบบ OAuth (แนะนำ)

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

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

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

การตรวจสอบสิทธิ์แบบ HTTP Basic

MCP Server ในโหมดการตรวจสอบสิทธิ์แบบ HTTP Basic ต้องการ API Key สำหรับการตรวจสอบสิทธิ์

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

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

คุณสามารถใช้คำสั่งต่อไปนี้ เพื่อสร้างสตริงที่เข้ารหัส 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>

การกำหนดค่า

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

คุณสามารถระบุส่วนหัวเหล่านี้ในการกำหนดค่าเซิร์ฟเวอร์ MCP ของคุณได้ (เป็นทางเลือก):

  • Workspace: ตรึงพื้นที่ทำงานสำหรับคำขอทั้งหมด (เป็นทางเลือก)
  • Branch: ตรึงสาขาพื้นที่ทำงานเฉพาะสำหรับคำขอทั้งหมด (เป็นทางเลือก, ค่าเริ่มต้นเป็น prod หากตั้งค่าพื้นที่ทำงาน)
  • Honeydew-Client: ระบุไคลเอนต์ MCP (เป็นทางเลือก, ตรวจพบอัตโนมัติจากเครื่องมือที่เชื่อมต่อ) ส่งส่วนหัวนี้เพื่อระบุตัวระบุไคลเอนต์เฉพาะ
  • ReadonlyToolsOnly: ตั้งค่าเป็น true เพื่อแสดงเฉพาะเครื่องมือแบบอ่านอย่างเดียว (เป็นทางเลือก)
เซิร์ฟเวอร์ MCP ใช้ส่วนหัวการตอบสนอง `Mcp-Session-Id` เพื่อรักษาสถานะเซสชัน รวมถึงพื้นที่ทำงานและสาขาที่ใช้งานอยู่ ดู [ข้อกำหนดการจัดการเซสชัน MCP](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#session-management) สำหรับรายละเอียด

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

Claude Code CLI

#### การติดตั้งปลั๊กอิน **ต้องใช้ Git.** การติดตั้งปลั๊กอินจาก GitHub จะโคลนที่เก็บ ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) ต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนปลั๊กอิน

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

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

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

ใช้หนึ่งในวิธีการต่อไปนี้เพื่อเพิ่มเซิร์ฟเวอร์ Honeydew MCP:

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **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 รองรับ
[การขยายตัวแปรสภาพแวดล้อม](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json)
โดยใช้ไวยากรณ์ `${VAR_NAME}`

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

```bash theme={null}
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 มีเครื่องมือการเข้าถึงเอกสารประกอบอยู่แล้ว ดังนั้นจึงไม่จำเป็นต้องใช้เซิร์ฟเวอร์เอกสารประกอบแยกต่างหาก เพิ่ม Honeydew Documentation MCP เฉพาะเมื่อคุณต้องการเข้าถึงเอกสารประกอบ โดยไม่ต้องเชื่อมต่อกับ Honeydew ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์

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

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

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

claude mcp remove honeydew

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

claude mcp remove honeydew-docs

Claude Desktop

#### การติดตั้งปลั๊กอิน **ต้องใช้ Git.** การติดตั้งปลั๊กอินจาก GitHub จะโคลนที่เก็บ ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) ต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนปลั๊กอิน

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

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

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

โหมด Claude Code

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

หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **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 มีเครื่องมือการเข้าถึงเอกสารประกอบอยู่แล้ว ดังนั้นจึงไม่จำเป็นต้องใช้เซิร์ฟเวอร์เอกสารประกอบแยกต่างหาก เพิ่ม 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

หากต้องการลบเซิร์ฟเวอร์ Honeydew MCP ในโหมด Cowork:

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

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

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

Claude.ai

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

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

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

การตั้งค่า MCP

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

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

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

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

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

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

  1. ไปที่ Settings -> Connectors
  2. ค้นหาคอนเน็กเตอร์ honeydew และคลิกไอคอนลบ

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

  1. ไปที่ Settings -> Connectors
  2. ค้นหาคอนเน็กเตอร์ honeydew-docs และคลิกไอคอนลบ

Cortex Code CLI

#### การติดตั้งปลั๊กอิน **ต้องใช้ Git** การติดตั้งปลั๊กอินจาก GitHub จะโคลนที่เก็บ ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) ต้องติดตั้งและอยู่ใน `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` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **Settings > MCP Server** ใน 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](https://git-scm.com/downloads) ต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนปลั๊กอิน

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

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

การตั้งค่า MCP

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

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

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

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

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

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

    <Tab title="API Key">
      1. **Server Name**: `honeydew`
      2. **Server Type**: **Remote (HTTP)**
      3. **Server URL**: `https://mcp.honeydew.cloud/mcp`
      4. ภายใต้ **Headers** คลิก **Add Header** และตั้งชื่อเป็น
         `Authorization` และค่าเป็น
         `Basic <YOUR_BASE64_ENCODED_API_KEY_AND_SECRET>`
      5. คลิก **Save**
    </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 ในลักษณะเดียวกัน โดยใช้ Server Name honeydew-docs, Server Type Remote (HTTP) และ Server URL https://honeydew.ai/docs/mcp ไม่จำเป็นต้องมีการตรวจสอบสิทธิ์

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

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

Cursor

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

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

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

การตั้งค่า MCP

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

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

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

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

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

  2. ไปที่ Settings -> Cursor Settings -> Tools & MCP

  3. คลิก New MCP Server

  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. คลิก Save

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

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

  1. ไปที่ Settings -> Cursor Settings -> Tools & MCP
  2. คลิก New MCP Server
  3. เพิ่มการกำหนดค่าต่อไปนี้: 
    {
  "name": "honeydew-docs",
  "type": "http",
  "url": "https://honeydew.ai/docs/mcp"
}
  4. คลิก Save

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

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

  1. ไปที่ Settings -> Cursor Settings -> Tools & MCP
  2. ค้นหา honeydew ในรายการและคลิกไอคอนลบ

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

  1. ไปที่ Settings -> Cursor Settings -> Tools & MCP
  2. ค้นหา honeydew-docs ในรายการและคลิกไอคอนลบ

Databricks Genie Code

เซิร์ฟเวอร์ MCP รองรับเฉพาะในโหมด Genie Code Agent สำหรับรายละเอียดเพิ่มเติม ดู [เอกสาร Databricks MCP](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 hostname แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud` ด้วย tenant hostname ของคุณ คุณสามารถค้นหา hostname ได้ใน **Settings > MCP Server** ใน Honeydew Studio ไปที่ **Catalog** → **Connections** → `honeydew-mcp` และคลิก **Login** ที่มุมขวาบน เพื่อตรวจสอบสิทธิ์และยืนยันการเชื่อมต่อ ให้สิทธิ์ `USE CONNECTION` แก่ผู้ใช้หรือบทบาทใดๆ ที่ต้องการเข้าถึง Honeydew MCP server: 
    GRANT USE CONNECTION ON CONNECTION `honeydew-mcp` TO <user-or-role>;
    1. เปิด Genie Code และคลิกไอคอนรูปเฟือง 2. ไปที่ **MCP Servers** → **Add Server** 3. เลือก **External MCP server** 4. เลือกการเชื่อมต่อ `honeydew-mcp` ที่คุณสร้างขึ้น 5. เข้าสู่ระบบการเชื่อมต่อเมื่อได้รับแจ้ง 6. คลิก **Save** Databricks จำกัด MCP ไว้ที่ 20 tools ในทุกเซิร์ฟเวอร์ที่กำหนดค่า หากคุณต้องการปรับแต่งว่า Honeydew tools ใดที่พร้อมใช้งาน ให้ใช้การตั้งค่า Genie Code MCP เพื่อเปิดหรือปิดใช้งาน tools เฉพาะ

การลบ 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 เชื่อมต่อกับ remote MCP servers ผ่าน MCP Marketplace

หากองค์กรของคุณใช้ Honeydew hostname แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วย tenant hostname ของคุณ คุณสามารถค้นหา hostname ได้ใน **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 เป็น transport type

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

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

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

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

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

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

  1. ไปที่ Settings -> Connections -> MCP servers
  2. คลิก Add a custom MCP
  3. ป้อน honeydew-docs ในช่อง Server Name
  4. เลือก HTTP เป็น transport type
  5. ป้อน https://honeydew.ai/docs/mcp ในช่อง Server URL
  6. ตั้งค่า authentication method เป็น 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 hostname แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วย tenant hostname ของคุณ คุณสามารถค้นหา hostname ได้ใน **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:

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

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

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

AI Coding Agent Plugins

**ต้องใช้ Git.** การติดตั้งปลั๊กอินจาก GitHub จะโคลน repository ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) จะต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนการใช้ปลั๊กอิน

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

เพิ่ม 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 มี documentation access tools รวมอยู่แล้ว ดังนั้นจึงไม่จำเป็นต้องใช้ documentation 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

#### การติดตั้ง Extension **ต้องใช้ Git.** การติดตั้งปลั๊กอินจาก GitHub จะโคลน repository ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) จะต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนการใช้ปลั๊กอิน

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

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

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

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

การตั้งค่า MCP

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

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

หากองค์กรของคุณใช้ Honeydew hostname แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วย tenant hostname ของคุณ คุณสามารถค้นหา hostname ได้ใน **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 มี documentation access tools รวมอยู่แล้ว ดังนั้นจึงไม่จำเป็นต้องใช้ documentation 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 พร้อม skills และ tools สำหรับการสร้าง semantic models และวิเคราะห์ข้อมูลผ่านการสนทนาด้วยภาษาธรรมชาติ การติดตั้งปลั๊กอินจะตั้งค่า 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 hostname แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วย tenant hostname ของคุณ คุณสามารถค้นหา hostname ได้ใน **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: `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 (ไม่บังคับ)

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

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

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

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

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

Codex CLI

#### การติดตั้งปลั๊กอิน **ต้องใช้ Git** การติดตั้งปลั๊กอินจาก GitHub จะทำการโคลนที่เก็บ ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) จะต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนการใช้ปลั๊กอิน

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

เพิ่ม 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` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **Settings > MCP Server** ใน 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 (ไม่บังคับ)

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

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

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

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

codex mcp remove honeydew

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

codex mcp remove honeydew-docs

Codex

#### การติดตั้งปลั๊กอิน **ต้องใช้ Git** การติดตั้งปลั๊กอินจาก GitHub จะทำการโคลนที่เก็บ ในเครื่อง ดังนั้น [Git](https://git-scm.com/downloads) จะต้องติดตั้งและอยู่ใน `PATH` ของคุณ หากไม่มี Git การติดตั้งปลั๊กอินจะล้มเหลว ติดตั้ง Git หรือ ใช้ขั้นตอนการตั้งค่า MCP ด้วยตนเองของไคลเอนต์ของคุณเพื่อกำหนดค่าเซิร์ฟเวอร์โดยตรง แทนการใช้ปลั๊กอิน

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

เพิ่ม marketplace ใน Codex:

  1. เปิด Plugins
  2. คลิกลูกศรดรอปดาวน์และเลือก Add marketplace
  3. เพิ่ม honeydew-ai/honeydew-ai-coding-agents-plugins
คุณยังสามารถเพิ่ม marketplace ได้จาก [Codex CLI](#codex-cli): 
```
codex plugin marketplace add honeydew-ai/honeydew-ai-coding-agents-plugins
```

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

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

การตั้งค่า MCP

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

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

Honeydew MCP

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

  2. ไปที่ Settings -> MCP Servers

  3. ภายใต้ Custom servers คลิก Add Server

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

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

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

  7. เว้นฟิลด์ Bearer token environment variable ให้ว่างเปล่า

  8. กำหนดค่าการตรวจสอบสิทธิ์ดังนี้:

    การตรวจสอบสิทธิ์ OAuth

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

    การตรวจสอบสิทธิ์ HTTP Basic

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

การแก้ไขปัญหาการตรวจสอบสิทธิ์ MCP

หากเซิร์ฟเวอร์ Honeydew MCP ไม่ได้รับการตรวจสอบสิทธิ์ใน Codex และตัวเลือก "Authenticate" ไม่ปรากฏ:

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

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

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

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

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

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

  1. ไปที่ Settings -> MCP Servers
  2. ค้นหา honeydew ภายใต้ Custom servers และคลิก Remove

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

  1. ไปที่ Settings -> MCP Servers
  2. ค้นหา honeydew-docs ภายใต้ Custom servers และคลิก Remove

Antigravity

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

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

  2. คลิกดรอปดาวน์ ... ที่ด้านบนของแผงตัวแทน

  3. คลิก Manage MCP Servers

  4. คลิก View raw config

  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 (ไม่บังคับ)

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

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

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

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

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

OpenCode

#### เซิร์ฟเวอร์ MCP หากองค์กรของคุณใช้ชื่อโฮสต์ Honeydew แบบกำหนดเอง ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **Settings > MCP Server** ใน Honeydew Studio รันคำสั่งต่อไปนี้ และทำตามพร้อมท์แบบโต้ตอบ: 
  ```bash theme={null}
  opencode mcp add
  ```

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

  1. **Location**: เลือกขอบเขตที่คุณต้องการ (โปรเจกต์ปัจจุบันหรือส่วนกลาง)
  2. **MCP server name**: `honeydew`
  3. **MCP server type**: `Remote`
  4. **MCP server URL**: `https://mcp.honeydew.cloud/mcp`
  5. **OAuth authentication**: `Yes`
  6. **Preregistered client 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 (ไม่บังคับ)

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

รัน `opencode mcp add` และป้อนค่าต่อไปนี้: 
  1. **MCP server name**: `honeydew-docs`
  2. **MCP server type**: `Remote`
  3. **MCP server URL**: `https://honeydew.ai/docs/mcp`
  4. **OAuth authentication**: `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

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

Kiro

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

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

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

  • Workspace: .kiro/settings/mcp.json (เฉพาะโปรเจกต์ปัจจุบัน)
  • User: ~/.kiro/settings/mcp.json (ใช้กับพื้นที่ทำงานทั้งหมด)

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

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

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

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

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

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

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

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

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

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

หากต้องการลบเซิร์ฟเวอร์ Honeydew MCP ให้ลบรายการ 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` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **Settings > MCP Server** ใน 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">
  เพิ่มเซิร์ฟเวอร์ `honeydew` MCP เป็นเครื่องมือให้กับ Cortex Agent
  หรือ Snowflake Intelligence agent
  ผู้ใช้จะได้รับแจ้งให้ตรวจสอบสิทธิ์ด้วย OAuth กับ Honeydew เมื่อใช้งานครั้งแรก
</Step>
เซิร์ฟเวอร์ Honeydew Documentation MCP แบบสแตนด์อโลนไม่รองรับ ใน Snowflake เนื่องจากเซิร์ฟเวอร์ MCP ภายนอกของ Snowflake ต้องการการตรวจสอบสิทธิ์ OAuth และเซิร์ฟเวอร์เอกสารไม่มีการตรวจสอบสิทธิ์ การเข้าถึงเอกสารสามารถทำได้ผ่านเครื่องมือเอกสาร ของเซิร์ฟเวอร์ Honeydew MCP

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

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

DROP MCP SERVER honeydew;
DROP INTEGRATION honeydew_mcp_integration;

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

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

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

หากองค์กรของคุณใช้ชื่อโฮสต์แบบกำหนดเองของ Honeydew ให้แทนที่ `https://mcp.honeydew.cloud/mcp` ด้วยชื่อโฮสต์ผู้เช่าของคุณ คุณสามารถค้นหาชื่อโฮสต์ได้ใน **Settings > MCP Server** ใน 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 จากรายการ เลือก "Clear authentication" หรือ "Authenticate" จากนั้นทำตามพร้อมท์ OAuth ของเบราว์เซอร์เพื่อเชื่อมต่อกับ Honeydew อีกครั้ง

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

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

สร้างคำขอดึงข้อมูลสำหรับสาขาการทำงานของเซสชันปัจจุบัน ส่งคืน 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

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

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

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

list_tables

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

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

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

get_table_info

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

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

ชื่อฐานข้อมูล ชื่อ schema ชื่อตาราง

โมเดลความหมาย

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 expressions (เช่น `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 เมื่อใช้นามแฝง ให้เรียงลำดับตามชื่อของนามแฝง โดเมนที่ต้องการคิวรี จำนวนแถวสูงสุดที่จะส่งคืน จำนวนแถวที่จะข้ามสำหรับการแบ่งหน้า

get_data_from_fields

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

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

ชื่อแอตทริบิวต์แบบเต็ม (`entity.attribute_name`) รองรับการใช้นามแฝง: `entity.attribute_name as alias_name` ชื่อเมตริกแบบเต็ม (`entity.metric_name`) หรือ SQL expressions (เช่น `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 เมื่อใช้นามแฝง ให้เรียงลำดับตามชื่อของนามแฝง โดเมนที่ต้องการคิวรี จำนวนแถวสูงสุดที่จะส่งคืน จำนวนแถวที่จะข้ามสำหรับการแบ่งหน้า

list_query_history

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

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

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

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

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

search_docs

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

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

คำค้นหา

query_docs_filesystem

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

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

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