ClickSend MCP Server

これはClickSendチームによって開発された公式のClickSend MCP Serverです。セキュリティ上の理由から、非公式のClickSend MCPバージョンは使用しないでください。

目的

ClickSend MCPは、ClickSendのメッセージング機能を最新のAIエコシステムやプラットフォームに拡張するように設計されています - 開発者がカスタムコードを書くことなくClickSend経由で簡単にSMSを送信できるようにします。

これにより導入が加速され、AI駆動の新しいユースケースが可能になり、インテリジェントな自動化の時代においてClickSendを将来にわたって対応可能なメッセージングプラットフォームとして位置づけます。

Related MCP server: Twilio MCP Server

要件

• Node.js >= 18

  • nvm（Node Version Manager）を使用して、このアプリを実行するための正しいバージョンを設定できます

インストール

AIデスクトップクライアントをダウンロードします。例としては、**こちら**からダウンロードできるClaude for Desktopがあります。

設定

サーバーには2つの環境変数が必要です：

• CLICKSEND_USERNAME: あなたのClickSendユーザー名

• CLICKSEND_API_KEY: あなたのClickSend APIキー

ClickSendにサインアップすると、https://dashboard.clicksend.com/account/subaccountsでユーザー名とキーを確認できます。

Claude Desktopの設定

• Claude for Desktopを開きます

• システムのメニューバーから設定に移動します

• 設定ウィンドウで、Developerタブに移動し、Edit Configをクリックします。 これで、以下の場所にある設定ファイルが開きます：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

• NPMパッケージを使用する場合

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
         "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

• ローカルビルドを使用する場合

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key"
      }
    }
  }
}

その後、Claude Desktopを再起動して設定を再読み込みします。接続されている場合は、ハンマーアイコンをクリックしたときにclicksend-send-smsが表示されます。

Claudeとの対話例

Claudeを通じてサーバーと対話する自然な方法をいくつか紹介します：

SMS：(単純な)

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

機能

• ClickSendユーザー名とAPIキーを設定して、一度に1つのSMSを送信します

• 連絡先リストにメッセージを送信するための価格を取得します

• 連絡先や連絡先リストを検索して、それらにメッセージを送信します

• SMSテンプレートを取得し、それを使用してメッセージを送信します

• SMS履歴を表示/取得します

• 過去30日間のSMS統計を取得します

サポート対象API

1. POST /v3/sms/send

• 操作ID: send-sms

• 概要: SMSを送信する

• 説明: 電話番号または連絡先リストの連絡先として、受信者にメッセージを送信します。

2. POST /v3/sms/price

• 操作ID: calculate-sms-price

• 概要: SMS価格を計算する

• 説明: メッセージの種類と長さに基づいて、メッセージ送信の価格を計算します。

3. GET /v3/sms/templates

• 操作ID: view-sms-templates

• 概要: SMSテンプレートを表示する

• 説明: フィルタリングオプション付きでSMSテンプレートを取得します。

4. GET /v3/sms/history

• 操作ID: view-sms-history

• 概要: SMS履歴を表示する

• 説明: フィルタリングとページネーションオプション付きで、以前に送信されたSMSを表示します。

5. GET /v3/statistics/sms

• 操作ID: view-sms-statistics

• 概要: SMS統計を表示する

• 説明: 過去30日間のSMS統計を取得します。

6. GET /v3/search/contacts-lists

• 操作ID: view-contact-lists

• 概要: 連絡先リストを表示する

• 説明: 検索された連絡先リストの一覧を取得します。

重要な注意事項

1. 電話番号の形式: すべての電話番号はE.164形式（例：+61411111111）である必要があります

2. レート制限: ClickSendアカウントのレート制限と価格に注意してください

3. セキュリティ: ClickSendの認証情報を安全に保管し、バージョン管理にコミットしないでください

トラブルシューティング

よくあるエラーメッセージと解決策：

1. エラー"Phone number must be in E.164 format"

   • 電話番号が「+」と国番号で始まっていることを確認してください

2. 「"Invalid credentials"エラー

   • CLICKSEND_USERNAMEとCLICKSEND_API_KEYを再確認してください。ClickSendダッシュボードからコピーできます。

コントリビューション

コントリビューションを歓迎します！プルリクエストを送信する前に、コントリビューションガイドラインをお読みください。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細はLICENSEファイルを参照してください。

セキュリティ

GitHubのissueやプルリクエストには、機密情報（電話番号やClickSend認証情報など）を含めないでください。