Clicksend MCP Server

🚀 ClickSend MCP サーバー

モデルコンテキストプロトコル（MCP）サーバーで、Claudeや他のAIアシスタントがClickSendを通じてSMSとMMSを送信できるようにします。

✨ 主な機能

• ClickSendのユーザー名とAPIキーを設定するだけで、一度にSMSを送信できます。

📦 インストール

必要条件

• Node.js >= 18
  • このアプリケーションを実行するために、nvm（Nodeバージョンマネージャー）を使用して正しいバージョンを設定できます。

🛠️ 設定

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

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

ClickSendに登録している場合、ClickSendコントロールパネルでユーザー名とキーを見つけることができます。

Claude Desktopの設定

このサーバーをClaude Desktopと一緒に使用するには、設定ファイルに以下の内容を追加してください。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "-y",
        "@clicksend/sms-mcp-server"
      ],
      "env": {
        "CLICKSEND_USERNAME": "あなたのClickSendユーザー名",
        "CLICKSEND_API_KEY": "あなたのAPIキー"
      }
    }
  }
}

設定を追加したら、Claude Desktopを再起動して設定を再読み込みしてください。接続されている場合、ハンマーアイコンをクリックすると「clicksend-send-sms」が表示されるはずです。

💻 使用例

基本的な使用法

以下はClaudeを通じてサーバーとやり取りする自然な方法の例です。

電話番号61411111111にメッセージ「私はClickSend MCPサーバーを使ってSMSを送信しています！」を送信してください。

⚠️ 重要な注意事項

1. 電話番号の形式：すべての電話番号はE.164形式（例：+61411111111）である必要があります。
2. レート制限：ClickSendアカウントのレート制限と料金に注意してください。
3. セキュリティ：ClickSendの認証情報を安全に保管し、バージョン管理システムには決して提出しないでください。

❓ よくある質問

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

1. 「電話番号はE.164形式である必要があります」
   • 電話番号が「+」で始まり、国番号を含んでいることを確認してください。
2. 「無効な認証情報」
   • CLICKSEND_USERNAMEとCLICKSEND_API_KEYを確認してください。ClickSendダッシュボードでそれらをコピーできます。

🤝 コントリビューション

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

📄 ライセンス

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

🔒 セキュリティ

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