MCP
ClickNext MCP
อัปเดตล่าสุด 17 พ.ย. 2026
เพิ่ม server เดียว — URL ของเรา + cnx- key ที่คุณมีอยู่แล้ว — เครื่องมือภายนอก (Claude Code, Claude Desktop, Cursor, VS Code, Codex, OpenCode, Warp) ก็เรียก “เครื่องมือของ ClickNext” ได้ทันที
MCP (Model Context Protocol) คือมาตรฐานให้ AI client ต่อกับ “เครื่องมือ/ข้อมูล” จากภายนอกได้ ClickNext MCP เปิดของกลางขององค์กรให้ agent ของคุณเรียกใช้: คลังสกิล (รวมสกิลผู้เชี่ยวชาญ expert-*), สมององค์กร (Org Brain), ความต่อเนื่องของโปรเจกต์, สร้างรูป และ Hub ที่เรียกทะลุไประบบปลายทาง — ใช้คีย์เดียวกับ endpoint โมเดล ไม่ต้องออกโทเคนใหม่
Endpoint และ Auth
| MCP URL | https://caw.clicknext.com/api/mcp |
| Transport | Streamable HTTP — JSON-RPC 2.0 ผ่าน POST ตอบกลับเป็น JSON ธรรมดา (ไม่ใช้ SSE, ไม่มี session) |
| Auth header | Authorization: Bearer cnx-xxxxxxxx (หรือ x-api-key: cnx-xxxxxxxx) |
| Protocol | initialize ตอบ protocolVersion 2024-11-05 · serverInfo clicknext 1.1.0 |
| OAuth | endpoint นี้ใช้ header คีย์เท่านั้น · Claude ที่ต่อแบบ custom connector (ล็อกอินด้วยบัญชีบริษัท ไม่ใช้คีย์) ใช้อีก endpoint หนึ่ง ดู ต่อจาก Claude ด้วยบัญชีบริษัท |
initializeและtools/listเรียกได้โดยไม่ต้องมีคีย์ (ให้ client เห็นรายการเครื่องมือ) แต่ทุกเครื่องมือต้องแนบคีย์- คีย์ของสมาชิกองค์กรลูกค้าใช้ได้เฉพาะ
whoami,list_projectsและresume_project(เครื่องมืออื่นเป็นของ ClickNext ภายใน) —list_skills/get_skillรับ skill keycnsk-ได้ด้วย - ถ้าลืมแนบคีย์ จะไม่ได้ HTTP 401 แต่เครื่องมือตอบข้อความ
Auth required…(หรือNot connected…สำหรับ whoami) พร้อมisError: true - ข้อยกเว้นที่ตอบเป็น HTTP error: ยิงถี่เกิน (429) และคีย์ของบัญชีที่ถูกปิดการใช้งาน (403
account_disabled) - ยังไม่มีคีย์? ดู วิธีขอ cnx- key
ตั้งค่าตามเครื่องมือ
เลือกเครื่องมือของคุณ แล้วแทน cnx-xxxx ด้วยคีย์ของคุณ
ใช้คำสั่ง claude mcp add (transport แบบ http)
claude mcp add --transport http clicknext \ https://caw.clicknext.com/api/mcp \ --header "Authorization: Bearer cnx-xxxxxxxx"
อยากให้ใช้ได้ทุกโปรเจกต์ เพิ่ม --scope user (ค่าเริ่มต้นคือเฉพาะโปรเจกต์ปัจจุบัน)
claude mcp add --scope user --transport http clicknext \ https://caw.clicknext.com/api/mcp \ --header "Authorization: Bearer cnx-xxxxxxxx"
เช็กว่าเพิ่มแล้ว: claude mcp list · ในหน้าแชทของ Claude Code พิมพ์ /mcp เพื่อดูสถานะ
ช่อง “Add custom connector” ของ Claude Desktop ใส่ header เองไม่ได้ (รองรับแต่ OAuth) — ให้ต่อผ่านตัวกลาง mcp-remote แทน (ต้องมี Node.js ในเครื่อง)
Claude Desktop: Settings → Developer → Edit Config แล้วเพิ่มใน claude_desktop_config.json
{
"mcpServers": {
"clicknext": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://caw.clicknext.com/api/mcp",
"--header", "Authorization:${CNX_AUTH}"
],
"env": { "CNX_AUTH": "Bearer cnx-xxxxxxxx" }
}
}
}Authorization:${CNX_AUTH} ติดกันไม่มีเว้นวรรค (กันปัญหาบน Windows) แล้วใส่ Bearer … ไว้ใน env · บันทึกแล้วปิด-เปิด Claude Desktop ใหม่แก้ไฟล์ ~/.cursor/mcp.json (หรือ .cursor/mcp.json ในโปรเจกต์)
{
"mcpServers": {
"clicknext": {
"url": "https://caw.clicknext.com/api/mcp",
"headers": { "Authorization": "Bearer cnx-xxxxxxxx" }
}
}
}แก้ไฟล์ .vscode/mcp.json ในโปรเจกต์ — ใช้ inputs ให้ VS Code ถามคีย์ตอนเริ่ม server จะได้ไม่ต้องเก็บคีย์ในไฟล์
{
"inputs": [
{ "type": "promptString", "id": "cnx-key",
"description": "ClickNext cnx- key", "password": true }
],
"servers": {
"clicknext": {
"type": "http",
"url": "https://caw.clicknext.com/api/mcp",
"headers": { "Authorization": "Bearer ${input:cnx-key}" }
}
}
}Codex CLI: เพิ่มใน ~/.codex/config.toml แล้วตั้งคีย์เป็นตัวแปรแวดล้อม (Codex ใส่ Authorization: Bearer ให้เอง)
# ~/.codex/config.toml [mcp_servers.clicknext] url = "https://caw.clicknext.com/api/mcp" bearer_token_env_var = "CLICKNEXT_KEY"
export CLICKNEXT_KEY=cnx-xxxxxxxx codex
เพิ่มในไฟล์ opencode.json
{
"mcp": {
"clicknext": {
"type": "remote",
"url": "https://caw.clicknext.com/api/mcp",
"headers": { "Authorization": "Bearer cnx-xxxxxxxx" },
"oauth": false,
"enabled": true
}
}
}"oauth": false บอก OpenCode ไม่ต้องพยายามล็อกอินแบบ OAuth (server นี้ใช้คีย์ใน header)Warp: Settings → Agents → MCP servers → + Add แล้ววาง JSON
{
"clicknext": {
"url": "https://caw.clicknext.com/api/mcp",
"headers": { "Authorization": "Bearer cnx-xxxxxxxx" }
}
}ทดสอบด้วย whoami
หลังเพิ่ม MCP แล้ว สั่ง agent ให้เรียกเครื่องมือ whoami — ควรตอบว่าเชื่อมต่อในชื่ออีเมลคุณ พร้อมรายการ endpoint
curl https://caw.clicknext.com/api/mcp \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"whoami","arguments":{}}}'สำเร็จ: ข้อความขึ้นต้น Connected to ClickNext as <อีเมลคุณ> (key: <ชื่อคีย์>) ตามด้วย chat_endpoint / models_endpoint / mcp_endpoint · ไม่สำเร็จ: Not connected. Pass your ClickNext cnx- key… = header ไม่ถูกส่งหรือคีย์ผิด
ต่อจาก Claude ด้วยบัญชีบริษัท
สำหรับ claude.ai, Claude Desktop และ Claude Code ที่ต่อแบบ custom connector: ล็อกอินด้วยบัญชีบริษัท (OAuth) ไม่ต้องมีคีย์ cnx-
https://caw.clicknext.com/api/v1/mcp
- claude.ai / Claude Desktop Settings → Connectors → Add custom connector → วาง URL ข้างบน → Connect → เข้าสู่ระบบด้วยบัญชีบริษัท → กด อนุญาต
- Claude Code รัน
claude mcp add --transport http clicknext https://caw.clicknext.com/api/v1/mcpแล้วพิมพ์/mcpเพื่อล็อกอิน - เครื่องมือที่ได้
whoami,search_knowledgeและชุดkm_*ของคลังของฉัน ในนามของคนที่กดอนุญาต (ไม่มีสกิล สร้างรูป หรือ Hub) ใช้ได้เฉพาะพนักงาน - ยกเลิก ที่ /chat → คลังของฉัน → เชื่อมกับ Claude → ยกเลิกการเชื่อมต่อ ขั้นตอนพร้อมภาพรวมอยู่ที่ เอกสาร: เชื่อมกับ Claude
/api/mcp ไม่ได้ และคีย์ cnx- ใช้กับ /api/v1/mcp ไม่ได้ เลือก URL ให้ตรงกับวิธีล็อกอิน · ข้อมูลที่ Claude ดึงไปจะอยู่บนระบบของ Anthropicเครื่องมือทั้งหมด
ClickNext MCP เปิดเครื่องมือ 20 ตัว (ตรงกับผล tools/list): 10 ตัวของส่วนกลางด้านล่างนี้ และ 10 ตัวของ คลังของฉัน — ทุกตัวต้องแนบคีย์
ยืนยันการเชื่อมต่อ — คืนว่าเป็นคีย์ของใคร และรายการ endpoint (chat / models / mcp) เรียกตัวแรกเพื่อเช็กว่าตั้งค่าถูก
ลิสต์สกิลในคลัง ClickNext (หลายร้อยสกิล รวมสกิลผู้เชี่ยวชาญ expert-* กว่า 200 สาขา) เฉพาะสกิลสาธารณะ (Public) กรองด้วย q (ข้อความ), category (เช่น code, design, docs) หรือ tag แต่ละบรรทัดบอกหมวดของสกิล เช่น q: "expert"
ดึงเนื้อหา SKILL.md เต็มของสกิลตามชื่อ (เช่น expert-accountant) ไปใช้เป็นบริบทในงานได้ทันที
ค้นสมององค์กร (Org Brain) แบบ semantic — การตัดสินใจ/มาตรฐาน/how-to/ข้อเท็จจริงระบบ คืนหัวข้อ + คะแนน + เนื้อหา ใช้ยึดคำตอบให้ตรงบริบท ClickNext
ลิสต์โปรเจกต์ (continuity threads) ของคุณบนเกตเวย์ สูงสุด 100 รายการล่าสุด พร้อมจำนวนเทิร์นและเวลาที่อัปเดต
ดึง handoff brief เพื่อทำงานต่อจากที่ AI/เซสชันก่อนหน้าค้างไว้ ไม่ต้องเริ่มใหม่ (เฉพาะโปรเจกต์ของคุณเอง)
สร้างรูปจากคำบรรยาย (ไทยได้ ใช้ได้ถึง 1,000 ตัวอักษร ส่วนที่เกินถูกตัดทิ้ง) คืนเป็นรูปภาพใน MCP โดยตรง — สร้างด้วย gpt-image-2.5-sunburst คิดตามโทเคนจริงลงที่คีย์ของคุณ ต้องมีสิทธิ์สร้างรูปและยังมีโควตาโทเคน/งบของคีย์เหลือ (ไม่จำกัดจำนวนรูปต่อวัน) · prompt ยาวกว่านี้หรืออยากกำหนดขนาดรูป ใช้ /api/v1/images/generations
ลิสต์ “ปลายทาง” (connector) ที่คุณเรียกผ่าน Hub ได้ — ขององค์กร ของทีม และของคุณเอง พร้อมชนิด/สถานะ เริ่มจากตัวนี้
สำหรับ connector ชนิด MCP — ลิสต์ tools ของ server ปลายทาง จะได้รู้ว่าเรียกอะไรได้
เรียกทะลุไปปลายทางแล้วรับผลกลับ — MCP: ใส่ tool+arguments · REST/internal/OAuth: ใส่ path+params
เครื่องมือของคลังของฉัน (km_*)
คลังของฉันคือคลังความรู้ส่วนตัวของพนักงานแต่ละคน (เปิดดูได้ที่ /chat → คลังของฉัน รายละเอียดที่ เอกสาร) เครื่องมือชุดนี้ทำงานกับคลังของเจ้าของคีย์เสมอ ระบุคลังของคนอื่นไม่ได้ และใช้ได้เฉพาะพนักงาน
ค้นบันทึก การตัดสินใจ วิธีทำ และไฟล์ในคลังของคุณ พร้อมที่มา (เลือกค้นสมุดที่เพื่อนแชร์ให้อ่านได้ด้วย)
บันทึกข้อเท็จจริง การตัดสินใจ วิธีทำ สถานะงาน หรือบันทึกประชุมลงคลัง รหัสผ่านและ key ถูกตัดออกก่อนเก็บ ของที่มีอยู่แล้วไม่ถูกบันทึกซ้ำ
ถามคำถามที่ตอบจากคลังของคุณอย่างเดียว ด้วยโมเดลในบริษัท พร้อมเลขอ้างอิง
เตรียมงานต่อของโครงการ: สถานะล่าสุด สิ่งที่ตัดสินแล้ว งานค้าง วิธีทำ ไฟล์ และคนที่เกี่ยวข้องในหน้าเดียว
บันทึกสถานะงานของโครงการหลังจบแต่ละขั้น สถานะเดิมถูกเก็บเป็นประวัติ
ถามคลังของเพื่อนร่วมงาน ผู้ช่วยคลังของเขาตอบจากสิ่งที่เขาแชร์ให้คุณ (หรือรอเขาอนุมัติ) เจ้าของเห็นทุกคำถาม
สิ่งที่รอคุณในคลัง: ข้อเสนอของผู้ช่วย คำถามจากเพื่อนร่วมงาน และคำตอบใหม่ของคำถามที่คุณถามไว้
เริ่ม ดูความคืบหน้า และหยุดภารกิจของผู้ช่วยคลัง (หา ถามเพื่อนร่วมงาน แล้วเขียนรายงานลงคลังของคุณ)
/api/v1/images/generationsClickNext Hub — เรียกทะลุไปปลายทาง (Broker)
นอกจากเครื่องมือของ ClickNext เอง เกตเวย์ยังเป็น ตัวกลาง (broker) ให้ agent ของคุณเรียกไปยัง “ปลายทาง” — โปรดักต์บริษัท, REST API, MCP server อื่น และ SaaS ที่ล็อกอินแบบ OAuth (เช่น Google และ Microsoft 365) — ผ่านเครื่องมือ 3 ตัว (list_connectors / list_connector_tools / call_connector)
ปลายทางที่คุณเห็นมี 3 ระดับ (ถ้าชื่อซ้ำกัน ระดับที่เจาะจงกว่าชนะ: ของคุณ → ของทีม → ขององค์กร)
- ขององค์กร แอดมินเปิดให้ใช้ผ่าน broker (อาจจำกัดเฉพาะบางคีย์/บางคน) หรือตั้งเป็นแบบให้แต่ละคน “เชื่อมบัญชีตัวเอง” / “ใส่คีย์ของตัวเอง”
- ของทีม connector ที่แชร์ให้ทีมของคุณ
- ของคุณเอง REST / MCP ที่คุณเพิ่มเองที่ การเชื่อมต่อของฉัน → หัวข้อ Connector ส่วนตัว (ขั้นสูง) (เรียกได้เฉพาะ agent ของคุณ จนกว่าจะกด “ขอแชร์” และได้รับอนุมัติ)
- connector ที่ใช้บัญชีของแต่ละคน (เช่น Google: Gmail, Drive, Calendar, Sheets · Microsoft 365: Outlook, OneDrive / SharePoint, ปฏิทิน ตามที่ IT ตั้งไว้): เปิด /my-connectors หัวข้อ บัญชีที่เชื่อมได้ แล้วกด เชื่อมบัญชี (หรือ ใส่คีย์ สำหรับ connector ที่ใช้คีย์รายคน) ก่อน แล้ว
call_connectorจะเรียกในนามคุณด้วยสิทธิ์ของคุณเท่านั้น - ใช้บัญชีที่เชื่อมไว้ได้ทั้งในแอปเดสก์ท็อป เว็บแชท และ MCP
- คีย์และโทเค็นเก็บที่ส่วนกลางแบบเข้ารหัส
- ทุกการเรียกผ่าน SSRF guard และถูกบันทึกในระบบตรวจสอบ
ขั้นตอนทั่วไป:
- เรียก
list_connectors— ได้บรรทัดแบบ- Google API [cn_…] type=oauth scope=org health=ok(connector ที่ต้องเชื่อมบัญชีหรือใส่คีย์ของตัวเองมีข้อความ(per-user: connect your account / add your own key at /my-connectors first)ต่อท้าย) - ถ้าเป็น
type=mcp: เรียกlist_connector_tools— ดู tools ของปลายทาง - เรียก
call_connector— ส่งconnector(ชื่อหรือ id) + (MCP:tool/arguments· REST:path/params) แล้วรับผลกลับ
ตัวอย่าง: เรียก connector Google ผ่าน broker (ต้องเชื่อมบัญชี Google ที่ /my-connectors ก่อน)
curl https://caw.clicknext.com/api/mcp \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"call_connector",
"arguments":{"connector":"Google API",
"path":"/drive/v3/files"}}}'- REST / OAuth: เรียกแบบ
GETเท่านั้น (อ่านข้อมูล) ·pathต่อท้าย base URL ของ connector เสมอ (ใส่ URL เต็มไปที่อื่นไม่ได้ ไม่ใส่ = ใช้ path ทดสอบของ connector) ·paramsกลายเป็น query string - REST: ผลลัพธ์ขึ้นต้นด้วย
HTTP <status>ตามด้วยเนื้อหาไม่เกิน 6,000 ตัวอักษร · รอได้สูงสุด 20 วินาที · ปลายทางที่ redirect จะถูกบล็อก - MCP: ได้ผลของ tool ปลายทางกลับมาตรง ๆ (รูปแบบเดียวกับ
tools/call)
เรียกดิบ (JSON-RPC)
อยากลองเองหรือ debug — เกตเวย์รับ JSON-RPC 2.0 ตรง ๆ ผ่าน POST
เริ่ม session (initialize)
curl https://caw.clicknext.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{}}'ลิสต์เครื่องมือ (ไม่ต้องมีคีย์)
curl https://caw.clicknext.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'ค้นสมององค์กร
curl https://caw.clicknext.com/api/mcp \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"search_knowledge",
"arguments":{"query":"การ deploy เกตเวย์","k":5}}}'ค้นสกิลผู้เชี่ยวชาญ
curl https://caw.clicknext.com/api/mcp \
-H "Authorization: Bearer cnx-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":4,"method":"tools/call",
"params":{"name":"list_skills","arguments":{"q":"expert"}}}'| คำตอบ | ความหมาย |
|---|---|
result.content[] | ผลของเครื่องมือ (ข้อความ หรือรูปภาพสำหรับ generate_image) · มี isError: true = เครื่องมือทำงานไม่สำเร็จ อ่านเหตุผลจากข้อความ |
error -32602 unknown tool | ชื่อเครื่องมือผิด — เช็กจาก tools/list |
error -32601 method not found | รองรับเฉพาะ initialize, tools/list, tools/call (และ notifications/* ซึ่งตอบ HTTP 202) |
แก้ปัญหาที่พบบ่อย
| อาการ | สาเหตุ / วิธีแก้ |
|---|---|
เห็นเครื่องมือครบ แต่เรียกแล้วได้ Auth required… / Not connected… | header คีย์ไม่ถูกส่ง หรือคีย์ผิด/ถูกเพิกถอน (tools/list เปิดโดยไม่ต้องมีคีย์ จึงเห็นรายการได้อยู่ดี) — เช็กว่าเขียน Bearer cnx-… ถูก แล้วลอง whoami |
| client พาไปหน้าล็อกอิน OAuth | server นี้ไม่มี OAuth — ใส่คีย์ใน header แทน (OpenCode: "oauth": false · Claude Desktop: ใช้ mcp-remote) |
| log ฟ้องว่าเปิด SSE / GET ไม่ได้ (404) | ปกติ — server รับเฉพาะ POST และตอบเป็น JSON ทุกครั้ง เครื่องมือยังเรียกได้ตามปกติ |
generate_image: โควต้าการใช้งาน AI ของคุณเต็มแล้ว… / งบของคีย์นี้เต็มแล้ว… | โควตาโทเคนหรืองบของคีย์รอบนี้หมด (รูปคิดโทเคนรวมกับแชท) สร้างรูปได้อีกเมื่อเริ่มรอบใหม่ (ดู resets_at ที่ /api/v1/limits) หรือขอ IT ปรับโควตา |
generate_image: บัญชีนี้ไม่ได้รับสิทธิ์สร้างรูป | ทีมของคุณยังไม่ได้เปิดสิทธิ์สร้างรูป — แจ้งแอดมิน |
เครื่องมือ "…" เป็นของ ClickNext ภายใน — องค์กรลูกค้าใช้ไม่ได้ | คีย์ของสมาชิกองค์กรลูกค้าใช้ได้เฉพาะ whoami, list_projects และ resume_project |
call_connector: Access blocked by security policy / ตรวจรายการบล็อกของระบบความปลอดภัยไม่ได้ชั่วคราว… | บัญชี เครื่อง หรือ IP ถูกระงับ (ติดต่อ IT) หรือระบบตรวจรายการบล็อกไม่ได้ชั่วคราว จึงพักการเรียกปลายทางไว้ก่อน — ลองใหม่ในอีกสักครู่ |
HTTP 403 account_disabled | ผู้ดูแลปิดบัญชีเจ้าของคีย์ไว้ — ติดต่อผู้ดูแลระบบ |
call_connector: Connector not found or not exposed to the broker | ชื่อ/id ไม่ตรง หรือคุณไม่มีสิทธิ์ connector นั้น — เรียก list_connectors แล้วใช้ชื่อตามที่ขึ้น |
call_connector: You have not connected your account… / Add your own key… | connector นี้ใช้บัญชี/คีย์รายคน — เปิด /my-connectors กด เชื่อมบัญชี หรือ ใส่คีย์ แล้วลองใหม่ |
The ClickNext broker is disabled | แอดมินปิด Hub ชั่วคราว — เครื่องมืออื่นยังใช้ได้ ติดต่อ IT |