ClickSend MCP Server

ClickSend MCP サーバー

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

目的

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

これにより、導入が促進され、新たな AI 主導のユースケースが可能になり、インテリジェントな自動化の時代に対応する将来性の高いメッセージングプラットフォームとして ClickSend の地位を確立できます。

要件

• 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 を開きます。

• システムのメニューバーから Settings を開きます。

• 設定ウィンドウで 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 Dashboard からコピーできます。

貢献

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

ライセンス

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

セキュリティ

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