Kudosity MCP

官方

使用Kudosity API建置以發送SMS和MMS。存取開發者文件、API參考資料及即時測試工具，以發送訊息、管理聯絡人清單、設定Webhook等。

造訪 kudosity.com

你可以用 Kudosity MCP 做什麼？

  • Discover available messaging APIs — ask your AI to list all Kudosity APIs (SMS, RCS, WhatsApp) using list-specs.
  • Inspect API endpoints and parameters — have the assistant explore paths, methods, and supported parameters for any service with list-endpoints and get-endpoint.
  • Retrieve request and response schemas — get the exact body format or response structure for an endpoint via get-request-body and get-response-schema.
  • Generate ready-to-run code snippets — produce curl, JavaScript, or Python examples with proper auth using get-code-snippet.
  • Execute live API calls — send real SMS or test any Kudosity endpoint directly from chat with execute-request.

文件

Kudosity 模型上下文協定（MCP）伺服器讓 AI 驅動的編輯器（如 Cursor 和 Windsurf）及助理（如 Claude Desktop）能夠直接探索並執行 Kudosity API。透過 MCP，你的 AI 可以搜尋 API 規格、產生程式碼片段，並執行即時請求——完全無需離開你的開發環境。

什麼是 MCP？

模型上下文協定（MCP）是一項開放標準，允許 AI 應用程式安全地存取外部資料來源與工具。Kudosity MCP 伺服器為 AI 代理提供：

  • 直接 API 存取 Kudosity 功能——發送訊息、更新聯絡人清單等。
  • 文件搜尋——讓你的 AI 智慧搜尋 API 規格與教學，提供精準解答。
  • 來自 Kudosity 帳戶的即時資料——直接從對話中查詢並執行即時操作。
  • Kudosity 整合的程式碼生成
  • 即時 API 執行——超越靜態範例，執行真實請求
  • 始終保持最新——由 Swagger API 來源定義驅動

MCP 伺服器功能

Kudosity MCP 伺服器提供全面的 API 探索、文件、程式碼生成與即時執行工具：

🔍 API 探索與發掘

  • list-specs——探索可用的訊息 API（SMS、RCS、WhatsApp 等）
  • list-endpoints——列出服務的所有 API 路徑與方法
  • get-endpoint——檢查任何路徑支援的方法與參數
  • search-specs——跨規格搜尋關鍵字或模式

📋 API 結構與文件

  • get-request-body——取得任何端點的請求主體結構
  • get-response-schema——查看特定端點與狀態碼的回應結構
  • list-security-schemes——檢查驗證方法與需求
  • search-documentation——搜尋 API 文件內容

⚡ 程式碼生成

  • get-code-snippet——產生 curl、JavaScript、Python 等語言的即用範例
  • 自動提供正確的驗證與參數

🚀 即時 API 執行

  • execute-request——使用 HAR 格式執行真實 API 呼叫
  • 發送測試 SMS 訊息
  • 使用即時憑證驗證任何 Kudosity 端點
  • 回傳實際回應與錯誤

可用 API

MCP 伺服器提供對以下 Kudosity API 的存取：

  • Transmit Message API——支援 SMS、RCS、MMS、WhatsApp 與 webhook 的 v2 訊息服務
  • Transmit SMS API——具備進階聯絡人清單、關鍵字與報表功能的完整 SMS 服務

Kudosity MCP 伺服器設定

Kudosity 在 https://developers.kudosity.com/mcp 託管一個遠端 MCP 伺服器。請設定你的 AI 開發工具以連線至此伺服器。

驗證設定

對於需要驗證的 API，你需要設定 API 憑證。根據端點不同，方法有所差異：

  • api.transmitsms.com（v1 端點）——使用 Base64 編碼的 API Key 與 Secret 進行基本驗證
  • api.transmitmessage.com（v2 端點）——在 x-api-key 標頭中使用你的金鑰進行 API Key 驗證

針對 v1 端點（api.transmitsms.com）- 基本驗證：

  1. 取得你的憑證：從 Kudosity 儀表板 → 開發者 → API 設定
  2. 組合成：API_KEY:API_SECRET
  3. Base64 編碼：
    • 終端機：echo -n "API_KEY:API_SECRET" | base64
    • 瀏覽器主控台：btoa("API_KEY:API_SECRET")
    • 線上工具：base64encode.org

針對 v2 端點（api.transmitmessage.com）- API Key 驗證：

直接在 x-api-key 標頭中使用你的 API Key（無需 Base64 編碼）。

針對 v1 端點（api.transmitsms.com）- 新增至 claude_desktop_config.json：

JSON

{
  "mcpServers": {
    "kudosity": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.kudosity.com/mcp",
        "--header",
        "Authorization: Basic ${KUDOSITY_AUTH_HEADER}"
      ],
      "env": {
        "KUDOSITY_AUTH_HEADER": "YOUR_BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

重要：儲存設定檔後，請重新啟動你的 AI 工具。

你也可以使用以下指令為此專案安裝 Claude MCP 整合：

Bash

claude mcp add kudosity --scope project -- npx mcp-remote https://developers.kudosity.com/mcp

測試你的 MCP 設定

設定完成後，你可以測試 MCP 伺服器連線：

  1. 重新啟動你的 AI 工具（Claude Desktop、Cursor 等）
  2. 與 AI 助理開始新對話
  3. 詢問 Kudosity 相關問題——嘗試以下提問：
    • 「Kudosity 提供哪些 API？」
    • 「示範一個發送 SMS 的範例」
    • 「建立一個 curl 指令，透過 Kudosity 發送我的第一則 SMS」
    • 「我該如何開始使用 Kudosity 發送 SMS？」

如果成功，AI 將直接從你的帳戶與文件中擷取 Kudosity API 詳細資訊與範例程式碼來回應。

大約 2 個月前更新

複製頁面