Kudosity MCP

公式

Kudosity APIを使用してSMSやMMSを送信できます。開発者向けドキュメント、APIリファレンス、ライブテストツールにアクセスして、メッセージの送信、連絡先リストの管理、ウェブフックの設定などが行えます。

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 Model Context Protocol (MCP) サーバーは、Cursor や Windsurf のような AI 搭載エディタや、Claude Desktop のようなアシスタントが、Kudosity API を直接探索・実行できるようにします。MCP を使えば、開発環境を離れることなく、AI が API 仕様を検索し、コードスニペットを生成し、実際のリクエストを実行できます。

MCP とは?

Model Context Protocol (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 はリモート MCP サーバーを https://developers.kudosity.com/mcp でホストしています。このサーバーに接続するように AI 開発ツールを設定してください。

認証設定

認証が必要な API では、API 認証情報を設定する必要があります。エンドポイントによって方法が異なります。

  • api.transmitsms.com(v1 エンドポイント) — Base64 エンコードされた API キーとシークレットによる Basic 認証
  • api.transmitmessage.com(v2 エンドポイント)x-api-key ヘッダーにキーを含める API キー認証

v1 エンドポイント(api.transmitsms.com)の場合 - Basic 認証:

  1. 認証情報を取得: Kudosity ダッシュボード → Developers → API Settings から
  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 キー認証:

API キーを直接 x-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 を送信する例を見せてください」
    • 「Kudosity で最初の SMS を送信する curl コマンドを作成してください」
    • 「Kudosity で SMS 送信を始めるにはどうすればよいですか?」

成功すると、AI はアカウントとドキュメントから直接取得した Kudosity API の詳細とサンプルコードで応答します。

約2か月前に更新


ページをコピー