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 โมเดลอย่างไร: หน้าเชื่อมต่อ คือให้เครื่องมือภายนอก “คุยกับโมเดล” ผ่านเกตเวย์ · หน้านี้คือให้เครื่องมือภายนอก “เรียกเครื่องมือของ ClickNext” เพิ่มเข้าไป — ใช้ควบคู่กันได้ หรือใช้ MCP อย่างเดียวกับโมเดลของเครื่องมือนั้นเองก็ได้
ใช้แอป ClickNext เดสก์ท็อปอยู่แล้ว? ไม่ต้องตั้งค่าอะไรในหน้านี้ — Hub เชื่อมมาให้ ในตัวอัตโนมัติ แค่เชื่อมบัญชีของคุณที่ การเชื่อมต่อของฉัน (ในแอป: เมนูโปรไฟล์ → การเชื่อมต่อของฉัน (Google/ไดร์/เมล)) แล้วเปิดแชทใหม่ก็สั่งอ่าน Drive/Gmail ได้เลย ไม่ต้องเพิ่ม MCP หรือวางคีย์ · ในแอปตั้งแต่ 0.8.187 ปุ่ม MCP แสดงบัญชี Google / Microsoft 365 ของคุณใน Hub เป็นการ์ดด้านบน (หัวข้อ บัญชีของคุณใน ClickNext Hub) พร้อมสถานะและปุ่มเชื่อมบัญชี · หน้านี้ไว้สำหรับเครื่องมือภายนอกอื่น (Claude Code, Cursor, Warp ฯลฯ) ที่อยากเรียกเครื่องมือ/ปลายทางของ ClickNext

Endpoint และ Auth

MCP URLhttps://caw.clicknext.com/api/mcp
TransportStreamable HTTP — JSON-RPC 2.0 ผ่าน POST ตอบกลับเป็น JSON ธรรมดา (ไม่ใช้ SSE, ไม่มี session)
Auth headerAuthorization: Bearer cnx-xxxxxxxx (หรือ x-api-key: cnx-xxxxxxxx)
Protocolinitialize ตอบ protocolVersion 2024-11-05 · serverInfo clicknext 1.1.0
OAuthendpoint นี้ใช้ header คีย์เท่านั้น · Claude ที่ต่อแบบ custom connector (ล็อกอินด้วยบัญชีบริษัท ไม่ใช้คีย์) ใช้อีก endpoint หนึ่ง ดู ต่อจาก Claude ด้วยบัญชีบริษัท
สิทธิ์:
  • initialize และ tools/list เรียกได้โดยไม่ต้องมีคีย์ (ให้ client เห็นรายการเครื่องมือ) แต่ทุกเครื่องมือต้องแนบคีย์
  • คีย์ของสมาชิกองค์กรลูกค้าใช้ได้เฉพาะ whoami, list_projects และ resume_project (เครื่องมืออื่นเป็นของ ClickNext ภายใน) — list_skills / get_skill รับ skill key cnsk- ได้ด้วย
  • ถ้าลืมแนบคีย์ จะไม่ได้ 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" }
    }
  }
}
ถ้าวางไฟล์ในโปรเจกต์ อย่า commit คีย์ขึ้น git

แก้ไฟล์ .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
ส่วนนี้คือให้ Codex เรียกเครื่องมือของ ClickNext เท่านั้น — การใช้ Codex คุยกับโมเดลผ่านเกตเวย์ยังทำไม่ได้ (Codex ต้องใช้ Responses API ซึ่งเกตเวย์ยังไม่มี) ดู หน้าเชื่อมต่อ

เพิ่มในไฟล์ 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
token ของการเชื่อมแบบนี้ใช้กับ /api/mcp ไม่ได้ และคีย์ cnx- ใช้กับ /api/v1/mcp ไม่ได้ เลือก URL ให้ตรงกับวิธีล็อกอิน · ข้อมูลที่ Claude ดึงไปจะอยู่บนระบบของ Anthropic

เครื่องมือทั้งหมด

ClickNext MCP เปิดเครื่องมือ 20 ตัว (ตรงกับผล tools/list): 10 ตัวของส่วนกลางด้านล่างนี้ และ 10 ตัวของ คลังของฉัน — ทุกตัวต้องแนบคีย์

whoamiไม่มี argument

ยืนยันการเชื่อมต่อ — คืนว่าเป็นคีย์ของใคร และรายการ endpoint (chat / models / mcp) เรียกตัวแรกเพื่อเช็กว่าตั้งค่าถูก

list_skillsq? · category? · tag? · รับ cnx- หรือ cnsk-

ลิสต์สกิลในคลัง ClickNext (หลายร้อยสกิล รวมสกิลผู้เชี่ยวชาญ expert-* กว่า 200 สาขา) เฉพาะสกิลสาธารณะ (Public) กรองด้วย q (ข้อความ), category (เช่น code, design, docs) หรือ tag แต่ละบรรทัดบอกหมวดของสกิล เช่น q: "expert"

get_skillname · รับ cnx- หรือ cnsk-

ดึงเนื้อหา SKILL.md เต็มของสกิลตามชื่อ (เช่น expert-accountant) ไปใช้เป็นบริบทในงานได้ทันที

search_knowledgequery · k? (1-10, ค่าเริ่มต้น 5)

ค้นสมององค์กร (Org Brain) แบบ semantic — การตัดสินใจ/มาตรฐาน/how-to/ข้อเท็จจริงระบบ คืนหัวข้อ + คะแนน + เนื้อหา ใช้ยึดคำตอบให้ตรงบริบท ClickNext

list_projectsไม่มี argument

ลิสต์โปรเจกต์ (continuity threads) ของคุณบนเกตเวย์ สูงสุด 100 รายการล่าสุด พร้อมจำนวนเทิร์นและเวลาที่อัปเดต

resume_projectproject_id

ดึง handoff brief เพื่อทำงานต่อจากที่ AI/เซสชันก่อนหน้าค้างไว้ ไม่ต้องเริ่มใหม่ (เฉพาะโปรเจกต์ของคุณเอง)

generate_imageprompt

สร้างรูปจากคำบรรยาย (ไทยได้ ใช้ได้ถึง 1,000 ตัวอักษร ส่วนที่เกินถูกตัดทิ้ง) คืนเป็นรูปภาพใน MCP โดยตรง — สร้างด้วย gpt-image-2.5-sunburst คิดตามโทเคนจริงลงที่คีย์ของคุณ ต้องมีสิทธิ์สร้างรูปและยังมีโควตาโทเคน/งบของคีย์เหลือ (ไม่จำกัดจำนวนรูปต่อวัน) · prompt ยาวกว่านี้หรืออยากกำหนดขนาดรูป ใช้ /api/v1/images/generations

list_connectorsไม่มี argument

ลิสต์ “ปลายทาง” (connector) ที่คุณเรียกผ่าน Hub ได้ — ขององค์กร ของทีม และของคุณเอง พร้อมชนิด/สถานะ เริ่มจากตัวนี้

list_connector_toolsconnector

สำหรับ connector ชนิด MCP — ลิสต์ tools ของ server ปลายทาง จะได้รู้ว่าเรียกอะไรได้

call_connectorconnector · tool?/arguments? · path?/params?

เรียกทะลุไปปลายทางแล้วรับผลกลับ — MCP: ใส่ tool+arguments · REST/internal/OAuth: ใส่ path+params

เครื่องมือของคลังของฉัน (km_*)

คลังของฉันคือคลังความรู้ส่วนตัวของพนักงานแต่ละคน (เปิดดูได้ที่ /chat → คลังของฉัน รายละเอียดที่ เอกสาร) เครื่องมือชุดนี้ทำงานกับคลังของเจ้าของคีย์เสมอ ระบุคลังของคนอื่นไม่ได้ และใช้ได้เฉพาะพนักงาน

km_search

ค้นบันทึก การตัดสินใจ วิธีทำ และไฟล์ในคลังของคุณ พร้อมที่มา (เลือกค้นสมุดที่เพื่อนแชร์ให้อ่านได้ด้วย)

km_save

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

km_ask

ถามคำถามที่ตอบจากคลังของคุณอย่างเดียว ด้วยโมเดลในบริษัท พร้อมเลขอ้างอิง

km_brief

เตรียมงานต่อของโครงการ: สถานะล่าสุด สิ่งที่ตัดสินแล้ว งานค้าง วิธีทำ ไฟล์ และคนที่เกี่ยวข้องในหน้าเดียว

km_status

บันทึกสถานะงานของโครงการหลังจบแต่ละขั้น สถานะเดิมถูกเก็บเป็นประวัติ

km_ask_person

ถามคลังของเพื่อนร่วมงาน ผู้ช่วยคลังของเขาตอบจากสิ่งที่เขาแชร์ให้คุณ (หรือรอเขาอนุมัติ) เจ้าของเห็นทุกคำถาม

km_review

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

km_mission_start · km_mission_status · km_mission_stop

เริ่ม ดูความคืบหน้า และหยุดภารกิจของผู้ช่วยคลัง (หา ถามเพื่อนร่วมงาน แล้วเขียนรายงานลงคลังของคุณ)

สร้างวิดีโอและโมเดล 3D ยังไม่เปิดผ่าน MCP — ใช้ในแอปเดสก์ท็อปหรือ /chat · อยากสร้างรูปจากโค้ดโดยไม่ผ่าน MCP ดู /api/v1/images/generations

ClickNext Hub — เรียกทะลุไปปลายทาง (Broker)

นอกจากเครื่องมือของ ClickNext เอง เกตเวย์ยังเป็น ตัวกลาง (broker) ให้ agent ของคุณเรียกไปยัง “ปลายทาง” — โปรดักต์บริษัท, REST API, MCP server อื่น และ SaaS ที่ล็อกอินแบบ OAuth (เช่น Google และ Microsoft 365) — ผ่านเครื่องมือ 3 ตัว (list_connectors / list_connector_tools / call_connector)

ปลายทางที่คุณเห็นมี 3 ระดับ (ถ้าชื่อซ้ำกัน ระดับที่เจาะจงกว่าชนะ: ของคุณ → ของทีม → ขององค์กร)

  • connector ที่ใช้บัญชีของแต่ละคน (เช่น Google: Gmail, Drive, Calendar, Sheets · Microsoft 365: Outlook, OneDrive / SharePoint, ปฏิทิน ตามที่ IT ตั้งไว้): เปิด /my-connectors หัวข้อ บัญชีที่เชื่อมได้ แล้วกด เชื่อมบัญชี (หรือ ใส่คีย์ สำหรับ connector ที่ใช้คีย์รายคน) ก่อน แล้ว call_connector จะเรียกในนามคุณด้วยสิทธิ์ของคุณเท่านั้น
  • ใช้บัญชีที่เชื่อมไว้ได้ทั้งในแอปเดสก์ท็อป เว็บแชท และ MCP
  • คีย์และโทเค็นเก็บที่ส่วนกลางแบบเข้ารหัส
  • ทุกการเรียกผ่าน SSRF guard และถูกบันทึกในระบบตรวจสอบ

ขั้นตอนทั่วไป:

  1. เรียก 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) ต่อท้าย)
  2. ถ้าเป็น type=mcp: เรียก list_connector_tools — ดู tools ของปลายทาง
  3. เรียก 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"}}}'

เรียกดิบ (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)
ต่อ endpoint โมเดลควบคู่กันด้วย ดู หน้าเชื่อมต่อ

แก้ปัญหาที่พบบ่อย

อาการสาเหตุ / วิธีแก้
เห็นเครื่องมือครบ แต่เรียกแล้วได้ Auth required… / Not connected…header คีย์ไม่ถูกส่ง หรือคีย์ผิด/ถูกเพิกถอน (tools/list เปิดโดยไม่ต้องมีคีย์ จึงเห็นรายการได้อยู่ดี) — เช็กว่าเขียน Bearer cnx-… ถูก แล้วลอง whoami
client พาไปหน้าล็อกอิน OAuthserver นี้ไม่มี 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