Hydrolix
ทางการการรวมข้อมูลไทม์ซีรีส์ดาต้าเลคของ Hydrolix ที่ให้ความสามารถในการสำรวจสคีมาและสอบถามข้อมูลสำหรับเวิร์กโฟลว์ที่ใช้ LLM
คุณทำอะไรได้บ้างด้วย Hydrolix MCP?
- รันคิวรี SQL — ขอให้ผู้ช่วยของคุณดำเนินการ
run_select_queryกับคลัสเตอร์ Hydrolix ของคุณ โดยสามารถกำหนดขีดจำกัดจำนวนแถวและความคิดเห็นเกี่ยวกับวัตถุประสงค์ได้ - แสดงรายการฐานข้อมูล — ให้ผู้ช่วยของคุณเรียกใช้
list_databasesเพื่อแสดงฐานข้อมูลทั้งหมดที่มีอยู่ในคลัสเตอร์ Hydrolix ของคุณ - สำรวจโครงสร้างตาราง — ใช้
list_tablesและget_table_infoเพื่อค้นหาตารางและดึงข้อมูลเมตาดาต้า เช่น โครงสร้าง (schema) สำหรับฐานข้อมูลใดก็ได้ - คิวรีตามช่วงเวลา — ขอผลลัพธ์ที่เรียงตามลำดับเวลา (timestamp) ภายในช่วงวันที่ที่กำหนด เพื่อใช้ประโยชน์จากการปรับแต่งคีย์หลัก (primary key) สำหรับคิวรีที่มีประสิทธิภาพ
เอกสาร
เซิร์ฟเวอร์ MCP ของ Hydrolix
เซิร์ฟเวอร์ MCP สำหรับ Hydrolix
เริ่มต้นใช้งานอย่างรวดเร็ว
เริ่มต้นใช้งานได้ภายในไม่กี่นาที ส่วนนี้ครอบคลุม Claude Desktop และ Claude Code
ขั้นตอนที่ 1 — ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:
- ข้อมูลประจำตัวของ Hydrolix — ชื่อโฮสต์ของคลัสเตอร์ของคุณ พร้อมด้วยชื่อผู้ใช้/รหัสผ่าน หรือโทเค็นบัญชีบริการ หากคุณไม่มีข้อมูลเหล่านี้ โปรดสอบถามผู้ดูแลระบบ Hydrolix ของคุณ
- Claude Desktop — ดาวน์โหลดจาก claude.ai/download
ขั้นตอนที่ 2 — ติดตั้งเซิร์ฟเวอร์ MCP
เลือกวิธีการที่ตรงกับการตั้งค่าของคุณ:
ตัวเลือก A: ใช้ uv (แนะนำ)
uv จัดการ Python โดยอัตโนมัติและดาวน์โหลด mcp-hydrolix ตามความต้องการ ดังนั้นจึงไม่จำเป็นต้องมีขั้นตอนการติดตั้งแยกต่างหาก หากคุณยังไม่มี uv ให้ติดตั้ง:
macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
ตัวเลือก B: ใช้ pip
ต้องใช้ Python 3.13+ หากคุณต้องการติดตั้ง Python ให้ดาวน์โหลดจาก python.org
pip install mcp-hydrolix
ขั้นตอนที่ 3 — กำหนดค่า Claude Desktop
-
เปิดไฟล์การกำหนดค่าของ Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
เพิ่มรายการต่อไปนี้ลงในออบเจ็กต์
"mcpServers"(สร้างไฟล์ด้วยเนื้อหานี้หากยังไม่มี):
{
"mcpServers": {
"mcp-hydrolix": {
"command": "uvx",
"args": [
"--python",
"3.13",
"--refresh-package",
"mcp-hydrolix",
"mcp-hydrolix"
],
"env": {
"HYDROLIX_URL": "https://<your-hydrolix-hostname>",
"HYDROLIX_USER": "<your-username>",
"HYDROLIX_PASSWORD": "<your-password>"
}
}
}
}
แทนที่ <your-hydrolix-hostname>, <your-username> และ <your-password> ด้วยข้อมูลประจำตัวจริงของคุณ
[!NOTE] หากคุณใช้ตัวเลือก B (pip) ให้ใช้
"command": "mcp-hydrolix"โดยไม่มีฟิลด์"args"แทน
[!TIP] หากไฟล์มีรายการอื่นอยู่แล้ว ให้เพิ่มบล็อก
"mcp-hydrolix"ภายในออบเจ็กต์"mcpServers"ที่มีอยู่แทนที่จะแทนที่ทั้งไฟล์
[!NOTE] หากคุณตรวจสอบสิทธิ์ด้วยโทเค็นบัญชีบริการแทนชื่อผู้ใช้/รหัสผ่าน โปรดดู การตรวจสอบสิทธิ์
ไม่พบคำสั่ง?
Claude Desktop เปิดใช้งานโดยไม่มี PATH ของเชลล์ของคุณ ดังนั้นอาจไม่พบไบนารีแม้ว่าจะติดตั้งแล้วก็ตาม ค้นหาเส้นทางแบบเต็มและใช้เป็นค่า "command" ในการกำหนดค่า
ตัวเลือก A (uv): ค้นหา uvx:
- macOS / Linux:
which uvx - Windows:
where.exe uvx
ตัวเลือก B (pip): ค้นหา mcp-hydrolix:
- macOS / Linux:
which mcp-hydrolix - Windows:
where.exe mcp-hydrolix
หาก which/where.exe ไม่ส่งคืนอะไรเลย แสดงว่าไบนารีไม่อยู่ใน PATH ของคุณ วิธีแก้ไขที่สะอาดที่สุดคือเปลี่ยนไปใช้ตัวเลือก A (uv) ซึ่งจัดการสภาพแวดล้อม Python และ PATH ให้คุณ
ขั้นตอนที่ 4 — รีสตาร์ท Claude Desktop
รีสตาร์ทแอปพลิเคชันเพื่อใช้การกำหนดค่า
ผู้ใช้ macOS / Windows: ตรวจสอบให้แน่ใจว่าได้ออกจาก Claude โดยสมบูรณ์ก่อนรีสตาร์ท บน macOS กด Cmd+Q หรือคลิกขวาที่ไอคอน Dock แล้วเลือก Quit บน Windows ใช้ไอคอนถาดระบบ
ขั้นตอนที่ 5 — ตรวจสอบว่าทำงานถูกต้อง
-
เปิดการสนทนาใหม่ใน Claude Desktop มองหาไอคอนเครื่องมือ/ค้อนใกล้กับช่องป้อนข้อความ — ซึ่งยืนยันว่าเซิร์ฟเวอร์ MCP เชื่อมต่อสำเร็จ
-
ลองใช้พรอมต์นี้เพื่อยืนยันว่าทุกอย่างทำงาน:
ใช้เครื่องมือ Hydrolix MCP ของคุณ แสดงรายการฐานข้อมูลที่มีอยู่
Claude ควรเรียกใช้เครื่องมือ list_databases และส่งคืนรายการฐานข้อมูลจากคลัสเตอร์ของคุณ
ต้องการใช้ Claude Code แทนหรือไม่
หากคุณต้องการใช้บรรทัดคำสั่ง ตรวจสอบให้แน่ใจว่าติดตั้ง uv แล้ว (ตัวเลือก A จาก ขั้นตอนที่ 2) จากนั้นรัน:
claude mcp add --transport stdio hydrolix \
--env HYDROLIX_URL=https://<your-hydrolix-hostname> \
--env HYDROLIX_USER=<your-username> \
--env HYDROLIX_PASSWORD=<your-password> \
--env HYDROLIX_MCP_SERVER_TRANSPORT=stdio \
-- uvx --python 3.13 --refresh-package mcp-hydrolix mcp-hydrolix
จากนั้นเปิด Claude Code และทดสอบด้วยพรอมต์เดียวกัน:
ใช้เครื่องมือ Hydrolix MCP ของคุณ แสดงรายการฐานข้อมูลที่มีอยู่
ต้องการใช้ VS Code แทนหรือไม่
คลิกป้าย ติดตั้งใน VS Code ที่ด้านบนของ README นี้เพื่อติดตั้งด้วยคลิกเดียว หากคุณต้องการใช้ขั้นตอน UI ให้เปิด Command Palette (Cmd+Shift+P / Ctrl+Shift+P) รัน MCP: Add Server เลือก Command (stdio) และใช้คำสั่ง uvx ... และบล็อก env ซ้ำจาก ขั้นตอนที่ 3
เครื่องมือ
-
run_select_query- ดำเนินการค้นหา SQL บนคลัสเตอร์ Hydrolix ของคุณ
- อินพุต:
query(สตริง): การค้นหา SQL ที่จะดำเนินการ - อินพุต:
max_cells(จำนวนเต็ม, ไม่บังคับ): งบประมาณเซลล์ผลลัพธ์ (แถว × คอลัมน์); เมื่อเซิร์ฟเวอร์ตั้งค่าขีดจำกัด ผู้เรียกสามารถลดได้เท่านั้น - อินพุต:
purpose(สตริง, จำเป็น): เหตุผลที่รันการค้นหา; บันทึกพร้อมกับการค้นหาเป็นhdx_query_comment - ส่วนท้าย
FORMATจะถูกลบออก; เซิร์ฟเวอร์เลือกฟอร์แมตสายส่ง
-
list_databases- แสดงรายการฐานข้อมูลทั้งหมดบนคลัสเตอร์ Hydrolix ของคุณ
-
list_tables- แสดงรายการตารางทั้งหมดในฐานข้อมูล
- อินพุต:
database(สตริง): ชื่อของฐานข้อมูล
-
get_table_info- รับข้อมูลเมตาของตาราง เช่น โครงสร้าง
- อินพุต:
database(สตริง): ชื่อของฐานข้อมูล - อินพุต:
table(สตริง): ชื่อของตาราง
การใช้งานอย่างมีประสิทธิภาพ
เนื่องจากความหลากหลายของสถาปัตยกรรม LLM ไม่ใช่ทุกรุ่นจะใช้เครื่องมือข้างต้นอย่างเชิงรุก และมีเพียงไม่กี่รุ่นที่จะใช้อย่างมีประสิทธิภาพโดยไม่มีคำแนะนำ แม้จะมีคำอธิบายเครื่องมือที่สร้างขึ้นอย่างรอบคอบให้กับโมเดลแล้วก็ตาม เพื่อให้ได้ผลลัพธ์ที่ดีที่สุดจากโมเดลของคุณขณะใช้เซิร์ฟเวอร์ MCP ของ Hydrolix เราขอแนะนำดังต่อไปนี้:
- อ้างถึงฐานข้อมูล Hydrolix ของคุณด้วยชื่อและขอการใช้เครื่องมือในพรอมต์ของคุณ (เช่น "ใช้เครื่องมือ MCP เพื่อเข้าถึงฐานข้อมูล Hydrolix ของฉัน โปรด ...")
- สิ่งนี้กระตุ้นให้โมเดลใช้เครื่องมือ MCP ที่มีอยู่และลดภาพหลอนให้น้อยที่สุด
- รวมช่วงเวลาในพรอมต์ของคุณ (เช่น "ระหว่างวันที่ 5 ธันวาคม 2023 ถึง 18 มกราคม 2024, ...") และขอโดยเฉพาะให้ผลลัพธ์เรียงตามลำดับเวลา
- สิ่งนี้กระตุ้นให้โมเดลเขียนการค้นหาที่มีประสิทธิภาพมากขึ้นซึ่งใช้ประโยชน์จาก การเพิ่มประสิทธิภาพคีย์หลัก
ปลายทางตรวจสอบสุขภาพ
เมื่อรันด้วยการขนส่ง HTTP หรือ SSE ปลายทางตรวจสอบสุขภาพจะพร้อมใช้งานที่ /health ปลายทางนี้:
- ส่งคืน
200 OKพร้อมเวอร์ชัน Clickhouse ของ Hydrolix query-head หากเซิร์ฟเวอร์ทำงานปกติและสามารถเชื่อมต่อกับ Hydrolix ได้ - ส่งคืน
503 Service Unavailableหากเซิร์ฟเวอร์ไม่สามารถเชื่อมต่อกับ Hydrolix query-head ได้
ตัวอย่าง:
curl http://localhost:8000/health
# Response: OK - Connected to Hydrolix compatible with ClickHouse 24.3.1
การกำหนดค่า
เซิร์ฟเวอร์ MCP ของ Hydrolix ถูกกำหนดค่าโดยใช้รายการเซิร์ฟเวอร์ MCP มาตรฐาน ปรึกษาเอกสารของไคลเอนต์ของคุณสำหรับคำแนะนำเฉพาะเกี่ยวกับตำแหน่งที่จะค้นหาหรือประกาศเซิร์ฟเวอร์ MCP ตัวอย่างการตั้งค่าโดยใช้ Claude Desktop มีเอกสารด้านล่าง
วิธีที่แนะนำในการเปิดใช้เซิร์ฟเวอร์ MCP ของ Hydrolix คือผ่าน ตัวจัดการโครงการ uv ซึ่งจะจัดการติดตั้ง dependencies อื่นๆ ทั้งหมดในสภาพแวดล้อมที่แยกจากกัน
การตรวจสอบสิทธิ์
เซิร์ฟเวอร์รองรับวิธีการตรวจสอบสิทธิ์หลายวิธีโดยมีลำดับความสำคัญดังต่อไปนี้ (สูงสุดไปต่ำสุด):
- โทเค็น Bearer ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านส่วนหัว
Authorization: Bearer <token> - พารามิเตอร์ GET ต่อคำขอ: โทเค็นบัญชีบริการที่ให้ผ่านพารามิเตอร์คิวรี
?token=<token> - ข้อมูลประจำตัวตามสภาพแวดล้อม: ข้อมูลประจำตัวที่กำหนดค่าผ่านตัวแปรสภาพแวดล้อม
- โทเค็นบัญชีบริการ (
HYDROLIX_TOKEN) หรือ - ชื่อผู้ใช้และรหัสผ่าน (
HYDROLIX_USERและHYDROLIX_PASSWORD)
- โทเค็นบัญชีบริการ (
เมื่อกำหนดค่าวิธีการตรวจสอบสิทธิ์หลายวิธี เซิร์ฟเวอร์จะใช้วิธีแรกที่พร้อมใช้งานตามลำดับความสำคัญข้างต้น การตรวจสอบสิทธิ์ต่อคำขอใช้ได้เฉพาะเมื่อใช้โหมดการขนส่ง HTTP หรือ SSE ฟอร์ม ?token= มีไว้สำหรับไคลเอนต์ที่ไม่สามารถส่งส่วนหัวได้; ตั้งค่า HYDROLIX_ALLOW_TOKEN_QUERY_PARAM=false ในการปรับใช้ที่ไคลเอนต์ทุกตัวส่งส่วนหัว Authorization (ดู ข้อมูลประจำตัวต่อคำขอ)
หมายเหตุ: แนะนำให้ใช้โทเค็นบัญชีบริการที่มีบทบาทอ่านอย่างเดียว
คำจำกัดความของเซิร์ฟเวอร์ MCP โดยใช้ชื่อผู้ใช้และรหัสผ่าน (JSON):
{
"command": "uvx",
"args": [
"--python",
"3.13",
"--refresh-package",
"mcp-hydrolix",
"mcp-hydrolix"
],
"env": {
"HYDROLIX_URL": "https://<hydrolix-host>",
"HYDROLIX_USER": "<hydrolix-user>",
"HYDROLIX_PASSWORD": "<hydrolix-password>"
}
}
คำจำกัดความของเซิร์ฟเวอร์ MCP โดยใช้โทเค็นบัญชีบริการ (JSON):
{
"command": "uvx",
"args": [
"--python",
"3.13",
"--refresh-package",
"mcp-hydrolix",
"mcp-hydrolix"
],
"env": {
"HYDROLIX_URL": "https://<hydrolix-host>",
"HYDROLIX_TOKEN": "<hydrolix-service-account-token>"
}
}
คำจำกัดความของเซิร์ฟเวอร์ MCP โดยใช้ชื่อผู้ใช้และรหัสผ่าน (YAML):
command: uvx
args:
- --python
- "3.13"
- --refresh-package
- mcp-hydrolix
- mcp-hydrolix
env:
HYDROLIX_URL: https://<hydrolix-host>
HYDROLIX_USER: <hydrolix-user>
HYDROLIX_PASSWORD: <hydrolix-password>
คำจำกัดความของเซิร์ฟเวอร์ MCP โดยใช้โทเค็นบัญชีบริการ (YAML):
command: uvx
args:
- --python
- "3.13"
- --refresh-package
- mcp-hydrolix
- mcp-hydrolix
env:
HYDROLIX_URL: https://<hydrolix-host>
HYDROLIX_TOKEN: <hydrolix-service-account-token>
ตัวอย่างการกำหนดค่า (Claude Desktop)
-
เปิดไฟล์การกำหนดค่าของ Claude Desktop ที่อยู่ที่:
- บน macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - บน Windows:
%APPDATA%/Claude/claude_desktop_config.json
- บน macOS:
-
เพิ่มรายการเซิร์ฟเวอร์
mcp-hydrolixลงในบล็อกการกำหนดค่าmcpServersเพื่อใช้ชื่อผู้ใช้และรหัสผ่าน:
{
"mcpServers": {
"mcp-hydrolix": {
"command": "uvx",
"args": [
"--python",
"3.13",
"--refresh-package",
"mcp-hydrolix",
"mcp-hydrolix"
],
"env": {
"HYDROLIX_URL": "https://<hydrolix-host>",
"HYDROLIX_USER": "<hydrolix-user>",
"HYDROLIX_PASSWORD": "<hydrolix-password>"
}
}
}
}
เพื่อใช้บัญชีบริการ ให้ใช้บล็อกการกำหนดค่าต่อไปนี้:
{
"mcpServers": {
"mcp-hydrolix": {
"command": "uvx",
"args": [
"--python",
"3.13",
"--refresh-package",
"mcp-hydrolix",
"mcp-hydrolix"
],
"env": {
"HYDROLIX_URL": "https://<hydrolix-host>",
"HYDROLIX_TOKEN": "<hydrolix-service-account-token>"
}
}
}
}
-
อัปเดตคำจำกัดความของตัวแปรสภาพแวดล้อมเพื่อชี้ไปยังคลัสเตอร์ Hydrolix ของคุณ
-
(แนะนำ) ค้นหารายการคำสั่งสำหรับ
uvxและแทนที่ด้วยเส้นทางสัมบูรณ์ไปยังไฟล์ปฏิบัติการuvxเพื่อให้แน่ใจว่าใช้เวอร์ชันที่ถูกต้องของuvxเมื่อเริ่มเซิร์ฟเวอร์ คุณสามารถค้นหาเส้นทางนี้ได้โดยใช้which uvxหรือwhere.exe uvx -
รีสตาร์ท Claude Desktop เพื่อใช้การเปลี่ยนแปลง หากคุณใช้ Windows ตรวจสอบให้แน่ใจว่า Claude หยุดโดยสมบูรณ์โดยปิดไคลเอนต์ผ่านไอคอนถาดระบบ
ตัวอย่างการกำหนดค่า (Claude Code)
เพื่อกำหนดค่าเซิร์ฟเวอร์ MCP ของ Hydrolix สำหรับ Claude Code ให้รันคำสั่งต่อไปนี้:
claude mcp add --transport stdio hydrolix \
--env HYDROLIX_USER=<hydrolix-user> \
--env HYDROLIX_PASSWORD=<hydrolix-password> \
--env HYDROLIX_URL=https://<hydrolix-host> \
--env HYDROLIX_MCP_SERVER_TRANSPORT=stdio \
-- uvx --python 3.13 --refresh-package mcp-hydrolix mcp-hydrolix
ตัวแปรสภาพแวดล้อม
ตัวแปรต่อไปนี้ใช้เพื่อกำหนดค่าการเชื่อมต่อ Hydrolix ตัวแปรเหล่านี้อาจให้ผ่านบล็อกการกำหนดค่า MCP (ดังแสดงด้านบน) ไฟล์ .env หรือตัวแปรสภาพแวดล้อมแบบดั้งเดิม
ตัวแปรที่จำเป็น
คุณต้องตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้เพื่อระบุคลัสเตอร์:
HYDROLIX_URL(แนะนำ): URL สาธารณะตามรูปแบบบัญญัติของคลัสเตอร์ Hydrolix ของคุณ เช่นhttps://mycluster.hydrolix.liveสำหรับการปรับใช้นอกคลัสเตอร์โดยทั่วไป ตัวแปรเดียวนี้เพียงพอ — ให้โฮสต์ พอร์ต (ค่าเริ่มต้นตาม scheme 443/80) และการตั้งค่า TLS สำหรับทั้งปลายทางคิวรี HTTP และการตรวจสอบ/versionของ RESTHYDROLIX_HOST(เลิกใช้แล้ว): ชื่อโฮสต์ของเซิร์ฟเวอร์ Hydrolix ของคุณ ยังคงรองรับเพื่อความเข้ากันได้ย้อนหลัง แต่ควรแทนที่ด้วยHYDROLIX_URL
เมื่อ HYDROLIX_MCP_SERVER_TRANSPORT เป็น http หรือ sse จำเป็นต้องใช้ HYDROLIX_URL โดยเฉพาะ (ปลายทางข้อมูลเมตา OAuth ที่กำลังจะมาถึงจะประกาศ) HYDROLIX_HOST เพียงอย่างเดียวไม่เพียงพอสำหรับการขนส่งเหล่านี้
ตัวแปรการตรวจสอบสิทธิ์
ต้องกำหนดค่าวิธีการตรวจสอบสิทธิ์อย่างน้อยหนึ่งวิธีเมื่อใช้การขนส่ง stdio:
HYDROLIX_TOKEN: โทเค็นบัญชีบริการสำหรับการตรวจสอบสิทธิ์ตามสภาพแวดล้อมHYDROLIX_USERและHYDROLIX_PASSWORD: ชื่อผู้ใช้และรหัสผ่านสำหรับการตรวจสอบสิทธิ์ตามสภาพแวดล้อม (ต้องให้ทั้งสองร่วมกัน)
โดยสรุป:
- สำหรับ stdio คุณต้องใช้ HYDROLIX_TOKEN หรือ HYDROLIX_USER+HYDROLIX_PASS (ข้อมูลประจำตัวตามสภาพแวดล้อม)
- สำหรับ http/sse คุณอาจใช้ HYDROLIX_TOKEN หรือ HYDROLIX_USER+HYDROLIX_PASS (ข้อมูลประจำตัวตามสภาพแวดล้อม) แต่คุณอาจใช้ข้อมูลประจำตัวต่อคำขอแทน
หากไม่มีข้อมูลประจำตัวผ่านสภาพแวดล้อมหรือคำขอ คำขอจะล้มเหลว
การใช้การตรวจสอบสิทธิ์ต่อคำขอด้วยการขนส่ง HTTP
เมื่อใช้การขนส่ง HTTP หรือ SSE คุณสามารถละเว้นข้อมูลประจำตัวตามสภาพแวดล้อมและให้การตรวจสอบสิทธิ์ต่อคำขอแทนได้ ซึ่งมีประโยชน์สำหรับสถานการณ์ผู้ใช้หลายคนหรือกับไคลเอนต์ที่ไม่รองรับการรันเซิร์ฟเวอร์ MCP ในเครื่อง
ตัวอย่างการกำหนดค่า mcpServers ที่เชื่อมต่อกับเซิร์ฟเวอร์ HTTP ระยะไกลด้วยการตรวจสอบสิทธิ์ต่อคำขอ:
{
"mcpServers": {
"mcp-hydrolix-remote": {
"url": "https://my-hydrolix-mcp.example.com/mcp?token=<service-account-token>"
}
}
}
ตัวอย่างการกำหนดค่า .env ขั้นต่ำสำหรับการรันเซิร์ฟเวอร์ HTTP ของคุณเองโดยไม่มีข้อมูลประจำตัวตามสภาพแวดล้อม:
HYDROLIX_URL=https://my-cluster.hydrolix.net
HYDROLIX_MCP_SERVER_TRANSPORT=http
แม้จะไม่เป็นส่วนหนึ่งของข้อกำหนด MCP แต่ไคลเอนต์ MCP จำนวนมากอนุญาตให้เพิ่มส่วนหัวในคำขอที่ออกโดย MCP เมื่อเป็นไปได้ เราขอแนะนำให้กำหนดค่าไคลเอนต์ MCP เพื่อส่งโทเค็นบัญชีบริการผ่านส่วนหัว Authorization: Bearer <sa-token-here> แทนที่จะเป็นพารามิเตอร์คิวรีเพื่อความปลอดภัยที่มากขึ้น
หมายเหตุ: การตั้งค่าโฮสต์และพอร์ตผูกใช้เฉพาะเมื่อตั้งค่าการขนส่งเป็น "http" หรือ "sse"
ตัวแปรที่ไม่บังคับ
ดู docs/CONFIG.md สำหรับการแทนที่ปลายทาง ตัวแปรนามแฝงที่เลิกใช้แล้ว และชุดตัวแปรปรับแต่งที่ไม่บังคับทั้งหมด (การหมดเวลา การแทนที่การตั้งค่า SETTINGS ของคิวรี การตัดทอนผลลัพธ์ การปรับแต่ง worker HTTP/SSE พร็อกซี เมตริก และช่องทางหลบหนี)
ผู้ดูแล
งานที่ต้องใช้สิทธิ์การปฏิบัติการ — การรันชุดทดสอบแบบ end-to-end กับคลัสเตอร์ Hydrolix ที่ใช้งานจริง และการตัดเวอร์ชันเผยแพร่ — ได้ถูกบันทึกแยกไว้ใน MAINTAINERS.md