SendKuy

SendKuy MCP サーバー

AI アシスタントやエージェントが人々に連絡できるようにします。WhatsApp、SMS、メールを送信し、OTP コードを検証し、SendKuy アカウントを通じてキャンペーンを実行できます。

インテグレーションの構築中（「自分の番号にテスト用 OTP を送信して」「Webhook が失敗するのはなぜ？」）に使ったり、オンコールアラート、毎日の収益サマリー、顧客ごとの注文更新など、自律的に動作するエージェントの通知ステップとして使ったりできます。

シナリオを含む詳しいガイド：docs.sendkuy.com/mcp

キーを取得する

app.sendkuy.com/user/api で API キーを作成します。account:read と、使用したいツールのスコープだけを付与してください。サーバーにはキーで使用できるツールのみが表示されるため、読み取りスコープだけを持つキーから、送信を行うツールが見えることはありません。

インストール

Claude Code：

claude mcp add --transport stdio --env SENDKUY_API_KEY=sk_live_YOUR_API_KEY sendkuy -- npx -y @sendkuy/mcp

Cursor（.cursor/mcp.json）、Windsurf、Claude Desktop：

{
  "mcpServers": {
    "sendkuy": {
      "command": "npx",
      "args": ["-y", "@sendkuy/mcp"],
      "env": { "SENDKUY_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "sendkuy-key",
      "description": "SendKuy API key",
      "password": true
    }
  ],
  "servers": {
    "sendkuy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sendkuy/mcp"],
      "env": { "SENDKUY_API_KEY": "${input:sendkuy-key}" }
    }
  }
}

Claude Desktop では、最新リリースから sendkuy-mcp.mcpb をワンクリックでインストールすることもできます。

ツール

ツール	機能	スコープ
sendkuy_get_account	プラン、チャネルごとのクレジット数、今期の使用状況、キーのスコープ	account:read
sendkuy_send_message	1つの本文を、1つのチャネルで1～100件の宛先、連絡先またはグループに送信	messages:write
sendkuy_send_batch	最大500件のメッセージを異なる内容で送信し、行ごとに結果を返します	messages:write
sendkuy_get_messages	IDを指定した最大20件のメッセージのステータス	messages:read
sendkuy_list_messages	チャネル、ステータス、時刻で絞り込んだ最近のメッセージ	messages:read
sendkuy_cancel_message	まだ送信されていないメッセージをキャンセルします	messages:write
sendkuy_send_verification	OTPコードを送信します	verifications:write
sendkuy_check_verification	ユーザーが入力したコードを確認します	verifications:write
sendkuy_check_whatsapp_numbers	WhatsAppを利用している番号を確認します	numbers:read
sendkuy_find_contacts	電話番号またはexternal_idで連絡先を検索します	contacts:read
sendkuy_list_templates	保存済みのメッセージテンプレート	templates:read
sendkuy_list_groups	連絡先グループとその件数	groups:read
sendkuy_list_campaigns	ダッシュボードで準備されたキャンペーン	campaigns:read
sendkuy_start_campaign	キャンペーンを開始します	campaigns:write
sendkuy_get_campaign	進行状況と配信統計	campaigns:read
sendkuy_control_campaign	一時停止、再開、またはキャンセル	campaigns:write
sendkuy_list_webhook_deliveries	Webhookと最新の配信試行	webhooks:read

送信を行うツールは、実際にメッセージを送信し、クレジットを消費します。省略可能なdedupe_keyを指定できます。同じキーで手順を繰り返したエージェントには、二重送信する代わりに最初の応答が返されます。

使用例

• オンコールアラート。「ヘルスチェックに失敗したら、サービス名とエラーを添えてオンコールグループにWhatsAppで通知してください。」エージェントはグループのgrp_ IDを宛先に指定し、インシデントIDをdedupe_keyに設定して送信します。
• 毎日の売上サマリー。「毎晩、各支店のマネージャーにそれぞれの数値を送信してください。」sendkuy_send_batchを1回呼び出し、マネージャーごとに異なる本文を送信します。
• 連携のデバッグ。「過去1時間に失敗したWhatsAppメッセージと、その理由を教えてください。」sendkuy_list_messagesを実行し、続けてsendkuy_list_webhook_deliveriesを実行します。

設定

変数
SENDKUY_API_KEY	API キーです。キーがない場合、無効な場合、または起動時に SendKuy に接続できない場合でも、サーバーは起動してツールを一覧表示します。また、修正してクライアントを再起動するまで、すべての呼び出しにその理由を返します。
SENDKUY_BASE_URL	プロキシまたはテスト用のモックサーバーを使用する場合にのみ設定します。デフォルトは https://app.sendkuy.com/api/v1 です。

ライセンス

MIT