Dureach เปิดให้ใช้เครื่องมือ MCP 14 รายการชื่อ dureach.<action> ทุกเครื่องมือตรวจสอบฟิลด์ที่ไม่รู้จักอย่างเคร่งครัด ฟิลด์ส่วนเกินจะส่งคืนข้อผิดพลาดการตรวจสอบ ใช้ขอบเขตที่ระบุด้านล่าง ค่านอกช่วงจะส่งคืน invalid_arguments
มีเครื่องมือใดบ้าง
| เครื่องมือ | ความเสี่ยง | ขอบเขตที่ต้องใช้ | วัตถุประสงค์ |
|---|---|---|---|
dureach.workspace.context | R0 | workspace:read | ส่งคืนรหัสเวิร์กสเปซ ชื่อ บทบาทผู้เรียก และขอบเขตที่ได้รับ |
dureach.workspace.capabilities | R0 | workspace:read | แสดงการดำเนินการที่ใช้ได้กับการเชื่อมต่อนี้ |
dureach.companies.search | R1 | companies:read | ค้นหาระเบียนบริษัทด้วยคำสำคัญ |
dureach.companies.read | R1 | companies:read | อ่านบริษัทหนึ่งรายด้วย UUID |
dureach.trade.search | R1 | trade:read | ค้นหาระเบียนกิจกรรมการค้า |
dureach.trade.query | R1 | trade:read | เรียกใช้คำค้น SQL แบบอ่านอย่างเดียวกับมุมมองการขนส่ง |
dureach.contacts.search | R1 | contacts:read | ค้นหาระเบียนผู้ติดต่อด้วยคำสำคัญ |
dureach.contacts.query | R1 | contacts:read | เรียกใช้คำค้น SQL แบบอ่านอย่างเดียวกับมุมมองผู้ติดต่อ |
dureach.leads.list | R1 | leads:read | แสดงรายการลีดของเวิร์กสเปซพร้อมการแบ่งหน้า |
dureach.leads.create | R2 | leads:create | สร้างลีด รองรับการเรียกแบบทดลอง dry_run และ idempotency_key |
dureach.campaigns.list | R1 | campaigns:read | แสดงรายการแคมเปญพร้อมการแบ่งหน้า |
dureach.campaigns.draft | R2 | campaigns:create | ร่างแคมเปญ รองรับการเรียกแบบทดลอง dry_run และ idempotency_key |
dureach.email.send | R3 | emails:send | ส่งผ่านนโยบายถาวรที่เจ้าของตรวจแล้ว ต้องใช้ policy_id ที่ใช้งานอยู่ รองรับการเรียกแบบทดลอง dry_run และคีย์ idempotency |
dureach.sms.send | R3 | sms:send | ส่งผ่านนโยบายถาวรที่เจ้าของตรวจแล้ว กฎเดียวกับการส่งอีเมล |
ใช้ tools/list เพื่อดูเครื่องมือที่ใช้ได้กับการเชื่อมต่อนี้ ความพร้อมใช้งานขึ้นอยู่กับสิทธิ์ที่ได้รับและสิทธิ์การเข้าถึงของพื้นที่ทำงาน เริ่มด้วยสิทธิ์อ่าน และให้ผู้ดูแลตรวจสอบสิทธิ์ที่ขาดแทนการขอสิทธิ์กว้างเกินความจำเป็น
แต่ละเครื่องมือรับอาร์กิวเมนต์ใดบ้าง
workspace.context และ workspace.capabilities
ไม่มีอาร์กิวเมนต์ ส่ง {}
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "dureach.workspace.capabilities", "arguments": {}}}companies.search
| ฟิลด์ | ชนิด | ขอบเขต | ค่าเริ่มต้น |
|---|---|---|---|
query | string | 1–200 อักขระ ไม่ว่าง | ต้องระบุ |
page | integer | 1–20 | 1 |
limit | integer | 1–50 | 25 |
{"query": "industrial valves", "page": 1, "limit": 10}companies.read
| ฟิลด์ | ชนิด | รายละเอียด |
|---|---|---|
company_id | UUID | ต้องระบุ |
รหัสที่ไม่รู้จักจะส่งคืน company_not_found
trade.search
| ฟิลด์ | ชนิด | ขอบเขต | ค่าเริ่มต้น |
|---|---|---|---|
query | string | 3–100 อักขระ | ต้องระบุ |
dataset | enum | all, imports, exports, shipments | all |
page | integer | 1–20 | 1 |
limit | integer | 1–50 | 25 |
contacts.search
| ฟิลด์ | ชนิด | ขอบเขต | ค่าเริ่มต้น |
|---|---|---|---|
query | string | 3–100 อักขระ | ต้องระบุ |
page | integer | 1–40 | 1 |
limit | integer | 1–25 | 25 |
คำค้นสั้นกว่า 3 อักขระจะส่งคืนข้อผิดพลาดการตรวจสอบ ใช้ contacts.query เมื่อการค้นหาด้วยคำสำคัญไม่จำเพาะพอ
contacts.query และ trade.query
| ฟิลด์ | ชนิด | ขอบเขต | ค่าเริ่มต้น |
|---|---|---|---|
sql | string | ไม่เกิน 16 KiB UTF-8 ไวยากรณ์อ่านอย่างเดียว | ต้องระบุ |
page | integer | 1–20 | 1 |
limit | integer | 1–50 | 25 |
ห้ามใส่ SQL LIMIT/OFFSET ให้ใช้ page/limit แทน หน้า 2 ขึ้นไปต้องใช้ ORDER BY รายละเอียดไวยากรณ์อยู่ใน ตัวอ่าน SQL ของ MCP
leads.list และ campaigns.list
| ฟิลด์ | ชนิด | ขอบเขต | ค่าเริ่มต้น |
|---|---|---|---|
page | integer | 1–20 | 1 |
limit | integer | 1–50 | 25 |
leads.create
| ฟิลด์ | ชนิด | รายละเอียด |
|---|---|---|
email | ต้องระบุ ไม่เกิน 254 อักขระ | |
first_name | string | ไม่บังคับ ไม่เกิน 255 อักขระ |
last_name | string | ไม่บังคับ ไม่เกิน 255 อักขระ |
company_name | string | ไม่บังคับ ไม่เกิน 255 อักขระ |
idempotency_key | UUID | จำเป็นสำหรับการเขียนหรือส่งจริง ใช้ UUID เดิมเมื่อลองการดำเนินการเดิมอีกครั้งโดยไม่เปลี่ยนอาร์กิวเมนต์ |
dry_run | boolean | ไม่บังคับ ค่าเริ่มต้น false true เรียกแบบทดลองโดยไม่เขียนข้อมูล |
campaigns.draft
| ฟิลด์ | ชนิด | รายละเอียด |
|---|---|---|
name | string | ต้องระบุ ไม่เกิน 255 อักขระ |
idempotency_key | UUID | จำเป็นสำหรับการเขียนหรือส่งจริง ใช้ UUID เดิมเมื่อลองการดำเนินการเดิมอีกครั้งโดยไม่เปลี่ยนอาร์กิวเมนต์ |
dry_run | boolean | ไม่บังคับ ค่าเริ่มต้น false |
email.send และ sms.send
| ฟิลด์ | ชนิด | รายละเอียด |
|---|---|---|
policy_id | UUID | ต้องระบุ นโยบายการส่งถาวรที่อนุญาตการส่ง |
recipient | string | ต้องระบุ ไม่เกิน 255 อักขระ |
idempotency_key | UUID | จำเป็นสำหรับการเขียนหรือส่งจริง ใช้ UUID เดิมเมื่อลองการดำเนินการเดิมอีกครั้งโดยไม่เปลี่ยนอาร์กิวเมนต์ |
dry_run | boolean | ไม่บังคับ ค่าเริ่มต้น false |
การส่งที่ไม่มีนโยบายที่ใช้งานอยู่จะส่งคืน policy_not_found หรือ policy_not_authorized ความล้มเหลวด้านงบประมาณ การระงับ และโควตาจะส่งคืน policy_budget_exceeded, policy_daily_cap_exceeded, recipient_suppressed, recipient_already_attempted หรือ send_quota_exceeded ห้ามลองส่งใหม่ด้วยคีย์ idempotency ที่สร้างใหม่ ให้ใช้คีย์เดิมซ้ำ
ผลลัพธ์และข้อผิดพลาดมีรูปแบบอย่างไร
ความสำเร็จจะส่งคืนหนึ่งรายการข้อความพร้อม JSON และออบเจ็กต์ structuredContent ที่ตรงกันซึ่งผ่านการตรวจสอบตามสัญญาผลลัพธ์ของเครื่องมือ ผลลัพธ์ที่ใหญ่กว่า 1 MiB จะส่งคืน result_too_large แทนข้อมูลบางส่วน
ความล้มเหลวจะส่งคืน isError: true:
{"error": {"code": "invalid_arguments", "details": {"field": "limit"}},
"request_id": "REQ_ID"}รหัสทั่วไป: unknown_action (ใช้ชื่อจากตารางพร้อมคำนำหน้า dureach.) invalid_arguments scope_required plan_capability_required quota_exceeded (พร้อม limit_type, reset_at, retry_after) company_not_found policy_not_found policy_not_authorized result_too_large action_internal_error