Armavita Quo Mcp

armavita-quo-mcp

ArmaVita.com が提供します

カスタム実装が必要ですか？お問い合わせください。

armavita-quo-mcp は、Quo API のワークフロー（メッセージング、通話、連絡先、ユーザー、電話番号、ウェブフック）向けのローカルファーストな MCP サーバーです。

• MCP トランスポート：ローカル stdio
• ランタイム：Node.js 18+
• 認証：QUO_API_KEY
• ライセンス：AGPL-3.0-only

インストール

npm install

実行

bash ./run.sh

run.sh は Node/npm を確認し、必要に応じて依存関係をインストールしてから、MCP サーバーを起動します。

必須環境変数

• QUO_API_KEY：すべての API 呼び出しに使用する Quo API キーです。

任意：

• QUO_HTTP_TIMEOUT_MS：リクエストのタイムアウト（ミリ秒、デフォルト：30000）。

MCP クライアントの簡易設定

MCP クライアントの設定では、次の形式を使用してください。

{
  "mcpServers": {
    "armavita-quo-mcp": {
      "command": "bash",
      "args": ["/absolute/path/to/armavita-quo-mcp/run.sh"],
      "env": {
        "QUO_API_KEY": "YOUR_QUO_API_KEY"
      }
    }
  }
}

クライアントをこのフォルダーから起動する場合は、次のように指定できます。

{
  "mcpServers": {
    "armavita-quo-mcp": {
      "command": "bash",
      "args": ["./run.sh"],
      "env": {
        "QUO_API_KEY": "YOUR_QUO_API_KEY"
      }
    }
  }
}

ツールの対応範囲

• メッセージ：send_text、list_messages、get_message
• 会話：list_conversations
• 連絡先：create_contact、list_contacts、get_contact、update_contact、delete_contact、get_contact_custom_fields
• 通話：list_calls、get_call、get_call_recordings、get_call_summary、get_call_transcription、get_voicemail
• 電話番号：list_phone_numbers、get_phone_number
• ユーザー：list_users、get_user
• ウェブフック：list_webhooks

ページネーション

• リストエンドポイントでは、maxResults や pageToken などの Quo ページネーションパラメーターを使用できます。
• ページネーションを続けるには、返されたページトークンを保持して次のリクエストに渡してください。

使用上の注意

• 電話番号が必要な場合は、E.164 形式を使用してください（例：+18325551234）。
• update_contact では、少なくとも 1 つのフィールドを更新する必要があります。
• API エラーでは Quo のステータスとレスポンスの詳細が返されます。サーバーのエラー処理ではシークレットが伏せられます。

セキュリティ

• 実際の QUO_API_KEY の値をコミットしないでください。
• 認証情報はソースファイルではなく、クライアント／サーバーの環境設定に保存してください。
• 開発環境、ステージング環境、本番環境では別々のキーを使用してください。

ドキュメント

• 認証
• ツールリファレンス

対象範囲

• このリポジトリは、オープンソースのローカル MCP サーバーです。
• トランスポートモードはローカル stdio のみです。
• ツールのエイリアスは意図的に公開していません。

開発

構文チェック：

npm run check

直接起動：

npm start

ライセンス

GNU Affero General Public License v3.0（AGPLv3）。LICENSE を参照してください。