MCP VoiceAI WhiteLabel

🚀 AWS MCPサーバーの更新方法

このドキュメントでは、AWS MCPサーバーの更新方法やVavicky MCPサーバーの機能、インストール、使用例などについて説明します。

🚀 クイックスタート

MCPサーバーの更新

このコマンドを実行すると、AWS上のコードが更新され、MCPサーバーが再起動され、ログが開きます。

cd MCP-VoiceAI-WhiteLabel/ && git pull && pm2 restart 6 && pm2 logs 6

ログからの退出

Press CTRL+C

✨ 主な機能

Vavicky MCPサーバーは、VoiceAI VAVicky AiAgencyプラットフォームの完全なMCPサーバー実装です。以下に主な機能を示します。

ユーザー管理

• トークンや設定を含むユーザーデータを取得
• ホワイトラベルの詳細（名前、説明、ドメイン、色）を更新
• カスタムメール通知のためのSMTP設定を更新

APIトークン管理

• OpenAI APIキーを更新
• ElevenLabs APIキーを更新
• Deepseek APIキーを更新
• Google Gemini APIキーを更新
• Open Router APIキーを更新

アシスタント管理

• すべてのアシスタントを取得
• 特定のアシスタント情報を取得
• 包括的な設定で新しいアシスタントを作成
• 既存のアシスタントを更新
• アシスタントを削除
• アシスタントファイルを管理
• 使用統計と分析を取得
• アシスタントとチャット

Twilio統合

• Twilioアカウントを接続/切断
• 利用可能な電話番号を取得
• 電話番号を購入
• 既存の番号を管理
• 使用統計を取得

通信

• 個別の電話をかける
• 一括で電話をかける
• SMSメッセージを送信
• アクティブな通話をキャンセル
• 進行中の通話を監視

📦 インストール

以下の手順でVavicky MCPサーバーをインストールします。

1. プロジェクトをクローンまたは作成する：

   mkdir vavicky-mcp-server
   cd vavicky-mcp-server
   

2. package.jsonを作成する：

   npm init -y
   npm install @modelcontextprotocol/sdk node-fetch
   

3. 提供されたコードでserver.jsファイルを作成する

4. 環境変数を設定する：

   echo 'VAVICKY_API_KEY=your-api-key-here' > .env
   

5. サーバーを実行可能にする：

   chmod +x server.js
   

📚 ドキュメント

Claudeデスクトップの設定

Claudeデスクトップの設定ファイルに以下を追加します。

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

{
  "mcpServers": {
    "vavicky": {
      "command": "node",
      "args": ["/absolute/path/to/your/vavicky-mcp-server/server.js"],
      "env": {
        "VAVICKY_API_KEY": "your-vavicky-api-key-here"
      }
    }
  }
}

💻 使用例

設定が完了したら、Claudeで以下のツールを使用できます。

アシスタント管理

Claude, create a new voice assistant named 'Sales Bot' with OpenAI GPT-4 that can make phone calls and has a professional greeting.

通信

Claude, send an SMS to +1234567890 using assistant ID 'assist_123' with the message 'Hello, this is a test message.'

分析

Claude, show me the usage statistics for all my assistants this month.

電話管理

Claude, get me a list of available toll-free numbers in the US and purchase one for my business.

ツールリファレンス

ユーザー管理ツール

• get_user - トークンや設定を含むユーザーデータを取得
• update_white_label - ホワイトラベルのブランディングを更新
• update_smtp - メール設定を構成

トークン管理ツール

• update_openai_token - OpenAI APIキーを設定
• update_elevenlabs_token - ElevenLabs APIキーを設定
• update_deepseek_token - Deepseek APIキーを設定
• update_gemini_token - Gemini APIキーを設定
• update_openrouter_token - Open Router APIキーを設定

アシスタントツール

• get_assistants - すべてのアシスタントをリスト表示
• get_assistant - 基本的なアシスタント情報を取得
• get_one_assistant - 完全なアシスタント情報を取得
• create_assistant - 新しいアシスタントを作成
• update_assistant - アシスタント設定を更新
• delete_assistant - アシスタントを削除
• get_assistant_files - アシスタントファイルをリスト表示
• delete_assistant_file - アシスタントファイルを削除
• get_assistant_usage - 使用統計を取得
• get_assistants_token_usage - アシスタント全体のトークン使用量を取得
• get_dashboard_assistant - ダッシュボードアシスタントを取得
• chat_with_assistant - アシスタントとチャット

Twilioツール

• connect_twilio - Twilioアカウントを接続
• disconnect_twilio - Twilioを切断
• get_twilio_numbers - 電話番号をリスト表示
• get_available_numbers - 利用可能な番号を検索
• buy_twilio_number - 電話番号を購入
• update_twilio_number - 番号設定を構成
• get_twilio_usage - Twilioの使用統計を取得

通信ツール

• make_call - 電話をかける
• make_bulk_call - 一括で電話をかける
• get_calls_in_progress - アクティブな通話をリスト表示
• cancel_call - アクティブな通話をキャンセル
• send_sms - SMSメッセージを送信

🔧 技術詳細

エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています。

• API認証エラー
• 無効なパラメーター
• ネットワーク接続問題
• APIレート制限

開発

デバッグを伴う開発モードで実行するには、以下のコマンドを実行します。

npm run dev

セキュリティ

• APIキーは環境変数を介して渡されます。
• すべてのリクエストには適切な認証ヘッダーが含まれています。
• すべてのパラメーターに対して入力検証が行われます。

📄 ライセンス

このMCPサーバーは、元のVavicky n8nノード実装と同じライセンスに従います。

サポート

Vavickyプラットフォームに関する問題は、こちらを参照してください。MCP関連の問題は、Anthropic MCPドキュメントを参照してください。