MCP

OmeniaClaw mcp มีหน้าที่สองอย่าง:

• เรียกใช้ OmeniaClaw เป็นเซิร์ฟเวอร์ MCP ด้วย OmeniaClaw mcp serve
• จัดการนิยามเซิร์ฟเวอร์ MCP ขาออกที่ OmeniaClaw เป็นเจ้าของด้วย list, show, set และ unset

กล่าวอีกอย่างคือ:

• serve คือ OmeniaClaw ที่ทำหน้าที่เป็นเซิร์ฟเวอร์ MCP
• list / show / set / unset คือ OmeniaClaw ที่ทำหน้าที่เป็นรีจิสทรีฝั่งไคลเอนต์ MCP สำหรับเซิร์ฟเวอร์ MCP อื่นที่รันไทม์ของมันอาจใช้งานภายหลัง

ใช้ OmeniaClaw acp เมื่อ OmeniaClaw ควรโฮสต์เซสชัน coding harness เองและกำหนดเส้นทางรันไทม์นั้นผ่าน ACP

OmeniaClaw ในฐานะเซิร์ฟเวอร์ MCP

นี่คือเส้นทาง OmeniaClaw mcp serve

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

ใช้ OmeniaClaw mcp serve เมื่อ:

• Codex, Claude Code หรือไคลเอนต์ MCP อื่นควรคุยโดยตรงกับการสนทนาช่องทางที่รองรับโดย OmeniaClaw
• คุณมี OmeniaClaw Gateway แบบภายในเครื่องหรือระยะไกลที่มีเซสชันที่ถูกกำหนดเส้นทางไว้แล้ว
• คุณต้องการเซิร์ฟเวอร์ MCP หนึ่งตัวที่ทำงานได้กับแบ็กเอนด์ช่องทางของ OmeniaClaw แทนการเรียกใช้บริดจ์แยกสำหรับแต่ละช่องทาง

ใช้ OmeniaClaw acp แทนเมื่อ OmeniaClaw ควรโฮสต์รันไทม์การเขียนโค้ดเองและเก็บเซสชันเอเจนต์ไว้ภายใน OmeniaClaw

วิธีทำงาน

OmeniaClaw mcp serve เริ่มเซิร์ฟเวอร์ MCP แบบ stdio ไคลเอนต์ MCP เป็นเจ้าของโปรเซสนั้น ขณะที่ไคลเอนต์ยังเปิดเซสชัน stdio ไว้ บริดจ์จะเชื่อมต่อกับ OmeniaClaw Gateway ภายในเครื่องหรือระยะไกลผ่าน WebSocket และเปิดเผยการสนทนาช่องทางที่ถูกกำหนดเส้นทางผ่าน MCP

เลือกโหมดไคลเอนต์

ใช้บริดจ์เดียวกันได้สองวิธี:

สิ่งที่ serve เปิดเผย

บริดจ์ใช้เมทาดาทาเส้นทางเซสชันของ Gateway ที่มีอยู่เพื่อเปิดเผยการสนทนาที่รองรับโดยช่องทาง การสนทนาจะปรากฏเมื่อ OmeniaClaw มีสถานะเซสชันที่มีเส้นทางที่รู้จักอยู่แล้ว เช่น:

• channel
• เมทาดาทาผู้รับหรือปลายทาง
• accountId ที่เป็นทางเลือก
• threadId ที่เป็นทางเลือก

สิ่งนี้ให้ไคลเอนต์ MCP มีที่เดียวสำหรับ:

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

การใช้งาน

OmeniaClaw mcp serve

OmeniaClaw mcp serve --url wss://gateway-host:18789 --token-file ~/.OmeniaClaw/gateway.token

OmeniaClaw mcp serve --url wss://gateway-host:18789 --password-file ~/.OmeniaClaw/gateway.password

OmeniaClaw mcp serve --verboseOmeniaClaw mcp serve --claude-channel-mode off

เครื่องมือบริดจ์

บริดจ์ปัจจุบันเปิดเผยเครื่องมือ MCP เหล่านี้:

โมเดลอีเวนต์

บริดจ์เก็บคิวอีเวนต์ในหน่วยความจำขณะที่เชื่อมต่ออยู่

ชนิดอีเวนต์ปัจจุบัน:

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

การแจ้งเตือนช่องทาง Claude

บริดจ์ยังสามารถเปิดเผยการแจ้งเตือนช่องทางเฉพาะของ Claude ได้ด้วย นี่คือสิ่งที่เทียบเท่ากับอะแดปเตอร์ช่องทาง Claude Code ของ OmeniaClaw: เครื่องมือ MCP มาตรฐานยังพร้อมใช้งาน แต่ข้อความขาเข้าสดสามารถมาถึงเป็นการแจ้งเตือน MCP เฉพาะของ Claude ได้เช่นกัน

เมื่อเปิดใช้โหมดช่องทาง Claude เซิร์ฟเวอร์จะประกาศความสามารถเชิงทดลองของ Claude และสามารถปล่อย:

• notifications/claude/channel
• notifications/claude/channel/permission

พฤติกรรมบริดจ์ปัจจุบัน:

• ข้อความทรานสคริปต์ user ขาเข้าจะถูกส่งต่อเป็น notifications/claude/channel
• คำขออนุญาต Claude ที่ได้รับผ่าน MCP จะถูกติดตามในหน่วยความจำ
• หากการสนทนาที่เชื่อมโยงส่ง yes abcde หรือ no abcde ในภายหลัง บริดจ์จะแปลงสิ่งนั้นเป็น notifications/claude/channel/permission
• การแจ้งเตือนเหล่านี้มีเฉพาะเซสชันสดเท่านั้น หากไคลเอนต์ MCP ตัดการเชื่อมต่อ จะไม่มีเป้าหมาย push

สิ่งนี้ตั้งใจให้เฉพาะเจาะจงต่อไคลเอนต์ ไคลเอนต์ MCP ทั่วไปควรพึ่งพาเครื่องมือ polling มาตรฐาน

การกำหนดค่าไคลเอนต์ MCP

ตัวอย่างการกำหนดค่าไคลเอนต์ stdio:

{  "mcpServers": {    "OmeniaClaw": {      "command": "OmeniaClaw",      "args": [        "mcp",        "serve",        "--url",        "wss://gateway-host:18789",        "--token-file",        "/path/to/gateway.token"      ]    }  }}

สำหรับไคลเอนต์ MCP ทั่วไปส่วนใหญ่ ให้เริ่มจากพื้นผิวเครื่องมือมาตรฐานและไม่ต้องสนใจโหมด Claude เปิดโหมด Claude เฉพาะสำหรับไคลเอนต์ที่เข้าใจเมธอดการแจ้งเตือนเฉพาะของ Claude จริง ๆ เท่านั้น

ตัวเลือก

OmeniaClaw mcp serve รองรับ:

ความปลอดภัยและขอบเขตความเชื่อถือ

บริดจ์ไม่ได้สร้างเส้นทางขึ้นเอง มันเปิดเผยเฉพาะการสนทนาที่ Gateway รู้วิธีกำหนดเส้นทางอยู่แล้วเท่านั้น

หมายความว่า:

• allowlist ของผู้ส่ง การจับคู่ และความเชื่อถือระดับช่องทางยังเป็นของการกำหนดค่าช่องทาง OmeniaClaw พื้นฐาน
• messages_send สามารถตอบกลับผ่านเส้นทางที่จัดเก็บอยู่แล้วเท่านั้น
• สถานะการอนุมัติเป็นแบบสด/ในหน่วยความจำเท่านั้นสำหรับเซสชันบริดจ์ปัจจุบัน
• การตรวจสอบสิทธิ์ของบริดจ์ควรใช้การควบคุมโทเค็นหรือรหัสผ่าน Gateway เดียวกับที่คุณจะเชื่อถือสำหรับไคลเอนต์ Gateway ระยะไกลอื่น

หากการสนทนาหายไปจาก conversations_list สาเหตุปกติมักไม่ใช่การกำหนดค่า MCP แต่เป็นเมทาดาทาเส้นทางที่ขาดหายหรือไม่สมบูรณ์ในเซสชัน Gateway พื้นฐาน

การทดสอบ

OmeniaClaw มาพร้อมกับ smoke Docker แบบกำหนดผลได้สำหรับบริดจ์นี้:

pnpm test:docker:mcp-channels

smoke นั้น:

• เริ่มคอนเทนเนอร์ Gateway ที่ใส่ข้อมูลตั้งต้นไว้
• เริ่มคอนเทนเนอร์ตัวที่สองซึ่งสร้าง OmeniaClaw mcp serve
• ตรวจสอบการค้นพบการสนทนา การอ่านทรานสคริปต์ การอ่านเมทาดาทาไฟล์แนบ พฤติกรรมคิวอีเวนต์สด และการกำหนดเส้นทางการส่งขาออก
• ตรวจสอบการแจ้งเตือนช่องทางและสิทธิ์แบบ Claude ผ่านบริดจ์ stdio MCP จริง

นี่เป็นวิธีที่เร็วที่สุดในการพิสูจน์ว่าบริดจ์ทำงานได้โดยไม่ต้องเชื่อมบัญชี Telegram, Discord หรือ iMessage จริงเข้ากับการรันทดสอบ

สำหรับบริบทการทดสอบที่กว้างขึ้น โปรดดู การทดสอบ

การแก้ไขปัญหา

OmeniaClaw ในฐานะรีจิสทรีไคลเอนต์ MCP

นี่คือเส้นทาง OmeniaClaw mcp list, show, set และ unset

คำสั่งเหล่านี้ไม่ได้เปิดเผย OmeniaClaw ผ่าน MCP แต่ใช้จัดการนิยาม MCP server ที่ OmeniaClaw เป็นเจ้าของภายใต้ mcp.servers ในการกำหนดค่า OmeniaClaw

นิยามที่บันทึกไว้เหล่านี้มีไว้สำหรับ runtime ที่ OmeniaClaw เปิดใช้งานหรือกำหนดค่าในภายหลัง เช่น Pi แบบฝังตัวและ runtime adapter อื่น ๆ OmeniaClaw จัดเก็บนิยามไว้ส่วนกลาง เพื่อให้ runtime เหล่านั้นไม่จำเป็นต้องเก็บรายการ MCP server ซ้ำของตนเอง

runtime adapter อาจปรับ registry ที่ใช้ร่วมกันนี้ให้อยู่ในรูปแบบที่ client ปลายทางคาดหวัง ตัวอย่างเช่น Pi แบบฝังตัวใช้ค่า transport ของ OmeniaClaw โดยตรง ขณะที่ Claude Code และ Gemini ได้รับค่า type แบบ native ของ CLI เช่น http, sse หรือ stdio

นิยาม MCP server ที่บันทึกไว้

OmeniaClaw ยังจัดเก็บ MCP server registry แบบเบาใน config สำหรับพื้นผิวที่ต้องการนิยาม MCP ที่ OmeniaClaw จัดการ

คำสั่ง:

• OmeniaClaw mcp list
• OmeniaClaw mcp show [name]
• OmeniaClaw mcp set <name> <json>
• OmeniaClaw mcp unset <name>

หมายเหตุ:

• list เรียงชื่อ server
• show โดยไม่ระบุชื่อจะพิมพ์ object ของ MCP server ที่กำหนดค่าไว้ทั้งหมด
• set คาดหวังค่า JSON object หนึ่งค่าบนบรรทัดคำสั่ง
• ใช้ transport: "streamable-http" สำหรับ Streamable HTTP MCP server นอกจากนี้ OmeniaClaw mcp set ยังปรับ type: "http" แบบ native ของ CLI ให้เป็น config shape มาตรฐานเดียวกันเพื่อความเข้ากันได้
• unset ล้มเหลวหากไม่มี server ชื่อนั้นอยู่

ตัวอย่าง:

OmeniaClaw mcp listOmeniaClaw mcp show context7 --jsonOmeniaClaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'OmeniaClaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'OmeniaClaw mcp unset context7

ตัวอย่าง config shape:

{  "mcp": {    "servers": {      "context7": {        "command": "uvx",        "args": ["context7-mcp"]      },      "docs": {        "url": "https://mcp.example.com",        "transport": "streamable-http"      }    }  }}

Stdio transport

เปิดใช้งาน child process ภายในเครื่องและสื่อสารผ่าน stdin/stdout

SSE / HTTP transport

เชื่อมต่อกับ MCP server ระยะไกลผ่าน HTTP Server-Sent Events

ตัวอย่าง:

{  "mcp": {    "servers": {      "remote-tools": {        "url": "https://mcp.example.com",        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

ค่าที่ละเอียดอ่อนใน url (userinfo) และ headers จะถูกปกปิดใน log และผลลัพธ์สถานะ

Streamable HTTP transport

streamable-http เป็นตัวเลือก transport เพิ่มเติมเคียงคู่กับ sse และ stdio โดยใช้ HTTP streaming สำหรับการสื่อสารสองทางกับ MCP server ระยะไกล

การกำหนดค่า OmeniaClaw ใช้ transport: "streamable-http" เป็นการสะกดมาตรฐาน ค่า MCP type: "http" แบบ native ของ CLI จะได้รับการยอมรับเมื่อบันทึกผ่าน OmeniaClaw mcp set และถูกซ่อมแซมโดย OmeniaClaw doctor --fix ใน config ที่มีอยู่ แต่ transport คือสิ่งที่ Pi แบบฝังตัวใช้โดยตรง

ตัวอย่าง:

{  "mcp": {    "servers": {      "streaming-tools": {        "url": "https://mcp.example.com/stream",        "transport": "streamable-http",        "connectionTimeoutMs": 10000,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

ข้อจำกัดปัจจุบัน

หน้านี้บันทึก bridge ตามที่จัดส่งอยู่ในปัจจุบัน

ข้อจำกัดปัจจุบัน:

• การค้นพบการสนทนาขึ้นอยู่กับ metadata เส้นทางของ session Gateway ที่มีอยู่
• ไม่มี generic push protocol นอกเหนือจาก adapter เฉพาะของ Claude
• ยังไม่มีเครื่องมือแก้ไขหรือ react ต่อข้อความ
• transport HTTP/SSE/streamable-http เชื่อมต่อกับ remote server เดียว; ยังไม่มี upstream แบบ multiplexed
• permissions_list_open รวมเฉพาะ approval ที่สังเกตได้ขณะ bridge เชื่อมต่ออยู่เท่านั้น

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI
• Plugins