給應用程式、Webhook 與 AI agent 的託管事件總線

先讓第一筆事件成功送達。

不用先讀完整份文件。選一條接入方式,跑通發布與接收,再回來理解配額與交付語義。MCP、JavaScript、TypeScript、Python 和 curl 都可直接開始。

約五分鐘可完成第一筆發布 · Free 不綁信用卡

接進既有系統 · 五分鐘

接入範例,按需選用。

MCP 適合讓 agent 直接訂閱;SDK 適合應用程式;curl 適合先驗證 HTTP。片段由平台即時提供。還沒有現成系統,也可以先跑官方範例

還沒有 key?註冊後到面板的 Keys 頁建立一把,並設為環境變數 MQ_API_KEY。若要同時收發,請選 key(自訂)並勾選 publishsubscribe。MCP 也需要先設定 key;若要讓 agent 建立 topic 或替下游簽發窄權限金鑰,請使用 admin key。

能拿來做什麼

先選最接近你的事件路徑。

每個場景都標出接收方式與限制,方便你在動手前判斷是否合適。

01 / AI-NATIVE

AI agent 訂閱事件並反應

事件一到就喚醒長駐的 agent,不必每隔幾分鐘輪詢一次 長駐訂閱 事件 agent 輪詢對照 空手而回

把設定貼進 Claude Desktop 或 Cursor,agent 就能透過 MCP 的 watch_topic 持續等待事件。訂單或告警一到即可處理,不必在中間加一層輪詢服務。

選 MsgMesh 的理由:agent 可直接透過 MCP 接入,不必另寫事件橋接層。

02 / REALTIME

即時聊天室 / 多人協作

發到某個 room 的訊息只送給該 room 的訂閱者,其他 room 收不到 發布 room: vip room: main presence

聊天室、共編與直播互動都可即時接收訊息。同一個 topic 能用 room 分房,發布與 SSE/WebSocket 訂閱都能限定房間,不必為每個群組建立 topic。瀏覽器只拿短期 token,長期金鑰留在後端。

選 MsgMesh 的理由:平台處理房間路由與短期憑證,官方 SDK 處理重連與去重。presence 目前是整個 topic 的彙總,不分房間。

03 / WEBHOOK

應用事件通知 / webhook 中繼

事件送到 webhook 失敗後自動重試,重試用盡進入死信佇列,可再回放 事件 webhook 死信 replay ✗ ×3

把通知從 A 系統送到 B,採至少送達一次。失敗會自動重試;用盡後進入死信佇列,可查看並重送。註冊 webhook 時若提供 secret,每次投遞都會帶上 X-MsgMesh-Signature 供接收端驗證。

選 MsgMesh 的理由:不用自己實作重試、DLQ 與簽章,也不必維運另一套 queue。

04 / VIBE CODING

讓 agent 接手開通

事件一到就喚醒長駐的 agent,不必每隔幾分鐘輪詢一次 長駐訂閱 事件 agent 輪詢對照 空手而回

先在面板的 Keys 頁建立 admin key,貼進 MCP 設定。之後可直接請 AI IDE 為服務建立只能收發 orders 的金鑰與 topic;agent 會呼叫 create_keycreate_topic 完成設定。

選 MsgMesh 的理由:建立 topic 與簽發金鑰也能透過 MCP 完成,第一次設定後不必反覆切回面板。

方案與定價

服務方案與定價。

Free 用來驗證接入;需要更高吞吐、30 天保留與託管函數時,Paid 為每月 US$19。

🚧 MsgMesh 仍在公開 Beta,不提供 SLA。Free 可免費使用;Paid 為每月 US$19。方案或 Beta 計費規則若有調整,會提前通知。

Free:US$0,本期含 100 萬 message operations、每秒 20 請求、5 個 topic、保留 3 天。Paid:每月 US$19,本期含 600 萬 operations、每秒 2,000 請求、1,000 個 topic、保留 30 天並含託管函數。

估算每月費用

用三個日常數字快速估算。拖動滑桿看趨勢,也可以直接輸入精確值。

不知道怎麼填?試試常見情境:
10 萬則

只算你成功發出的原始訊息,不乘接收者人數。

每則 10 次

一則訊息送給 10 個訂閱者,就填 10。

4 KiB

多數 JSON 通知低於 16 KiB;每跨 16 KiB 會多一個大小單位。

你發出的訊息100,000
平台送達次數(估算)1,000,000
計費用量(operations)1,100,000
每則按幾個大小單位計 1 發送產生的用量 100,000 送達產生的用量 1,000,000

套用目前方案後,每月大約是:

正在從公開方案 API 讀取價格與含量…

這是估算,不是帳單。試算假設每則訊息都是輸入的大小、整月使用同一方案;價格與含量只讀取公開的 GET /v1/plans。實際費用依成功發送與可計費投遞計算。超額預設關閉,只有先加值並在面板明確開啟後,才會產生超額用量費。

展開:message operations 怎麼計算?

一則訊息消耗的 operations = 大小單位 ×(1 次發送 + 每一次投遞)。大小單位是每 16 KiB 算一個,不足 16 KiB 仍算一個。投遞指平台把該則訊息送給一個訂閱者一次:寫出到 SSE 或 WebSocket 連線、由 long-poll 拉取回傳,或 webhook 成功送達。歷史查詢與管理操作不計。

例如,一則 40 KiB 的訊息發給 3 個訂閱者,是 3 個大小單位 ×(1 次發送 + 3 次投遞)= 12 operations

含量以「本期」計算:每月 1 日(UTC)重新起算;變更方案的當天會另起一段,每個自然月至多一次。訊息則數與投遞次數會在面板另外顯示,但不是計費單位,也不能互相換算。

展開:超額、加值、稅務與取消

超額預設關閉,不會自動產生用量費。Free 與 Paid 都可先加值預付餘額,再於面板明確開啟超額;超出含量後每 100 萬 operations 收 US$3,每日結算。加值最低 US$5,稅金依帳單所在地計算;可用餘額按扣除 Polar 代收稅金後的淨額入帳。Paid 可隨時取消,於目前訂閱週期結束後生效;退款條件請見退款政策

不用先有系統 · 獨立跑

現成接入範例。

上面的片段適合接進既有系統;這兩個則是能獨立執行的完整專案。不必先有自己的 app,填入 API key 就能在本機跑起來。每次提交都會由 CI 安裝、建置,並用瀏覽器實際載入。

網頁聊天室chat-web

前端不放長期 key。範例附帶最小 token-broker 後端:長期 key 只留在後端,前端取得 5 分鐘的短期降權 token。平台會強制檢查 token 的房間清單,越權訂閱回 403。範例也包含 SSE 接收、多房間隔離與 cursor 續傳。

git clone https://github.com/LukeLogix/msgmesh-examples
cd msgmesh-examples/chat-web
npm install
cp .env.example .env
npm run build
node --env-file=.env server.js
chat-web 跑起來的畫面:兩個分頁在同一房間即時互傳,狀態列顯示 Connected (SSE)

開兩個分頁互傳訊息,就能看到即時投遞。.env 要填一把同時具備 publish 與 subscribe 能力的 key。

看 chat-web 原始碼 ↗

事件監看腳本agent-notifier

給 AI agent 與後端使用的事件監看器。Node 腳本以 subscribe() 長輪詢等待 topic,事件進來就處理;斷線時會退避重連,只有 key 失效才停止。它會接收整個 topic(firehose),不支援 room 過濾。

git clone https://github.com/LukeLogix/msgmesh-examples
cd msgmesh-examples/agent-notifier
npm install
cp .env.example .env
npm start

啟動後,每收到一則事件就印出一行。可用上面的 curl 或 chat-web 發布一筆確認;key 只需要 subscribe 能力,能把外洩時的影響範圍降到最低。

看 agent-notifier 原始碼 ↗

把第一筆事件送出去

Free 足夠完成接入驗證 · 不綁信用卡

免費建立帳號 →