wazionapps

WAzion MCP Server

AI アシスタントを WAzion に接続します。WAzion は、AI コパイロット、自動化ワークフロー、一斉マーケティング、CRM などを備えた WhatsApp Business プラットフォームです。この MCP サーバーは 240 以上のツールを提供し、MCP 対応クライアントから自然言語で WhatsApp Business の業務を管理できます。

---

クイックスタート

方法 1：直接 HTTP（推奨 — インストール不要）

WAzion の MCP エンドポイントは Streamable HTTP トランスポートに対応しているため、ほとんどのクライアントは何もインストールせずに直接接続できます。

Claude Code:

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop（claude_desktop_config.json）:

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

方法 2：npm パッケージ（stdio のみ対応するクライアント向け）

クライアントが stdio トランスポートにのみ対応している場合は、ブリッジとして npm パッケージを使用します。

npx -y @wazion/mcp-server

WAZION_API_KEY 環境変数を設定する必要があります。

---

クライアント別のセットアップ

Claude Code

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

ChatGPT

ChatGPT の設定で コネクター に移動し、新しい Streamable HTTP 接続を追加します。

• URL: https://www.wazion.com/api/mcp/
• 認証: API キーを使用した Bearer トークン

Cursor

プロジェクトのルートにある .cursor/mcp.json を作成または編集します。

{
  "mcpServers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf / VS Code

settings.json に追加します。

{
  "mcp.servers": {
    "wazion": {
      "type": "url",
      "url": "https://www.wazion.com/api/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

stdio のみ対応する任意のクライアント

stdio トランスポートにのみ対応するクライアント（HTTP 非対応）では、npm パッケージを使用します。

WAZION_API_KEY=your_key npx -y @wazion/mcp-server

または、クライアントの設定に追加します。

{
  "mcpServers": {
    "wazion": {
      "command": "npx",
      "args": ["-y", "@wazion/mcp-server"],
      "env": {
        "WAZION_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

---

利用可能なツール

WAzion は、24 のカテゴリーにわたって244 個のツールを提供しています。主なツールは次のとおりです。

カテゴリー	ツール数	説明
マスマーケティング	39	WhatsApp の一斉キャンペーン、連絡先リスト、送信設定、配信停止管理、キャンペーン統計
WhatsApp の操作	27	セッションのステータス、メッセージログ、メッセージの送信、ワークフローの実行、接続管理
プラグイン	18	商品に関する Q&A、ウェブチャット、ドキュメントに関する Q&A — プラグインのインストール、設定、監視
自動化	16	WhatsApp Auto のワークフロー — トリガー、条件、AI による返信、スケジュール済みメッセージの作成
統計	15	会話の指標、応答時間、エージェントのパフォーマンス、利用状況の分析
一般設定	13	言語、タイムゾーン、日付形式、Shopify 連携、ビジネス設定
顧客	13	顧客情報、メモ、タグ、検索、アラート、会話履歴
AI プロンプト	12	システムプロンプト、カスタム指示、AI モデルの設定、応答動作
ストレージ	12	クラウドストレージ内のファイルのアップロード、一覧表示、削除、管理
エージェント	11	サポートエージェントの作成、編集、管理（役割と権限の設定を含む）
会話	9	顧客との会話の検索、表示、分析
アクティビティ	8	日次・週次の概要、傾向、運用指標
AI 分析	7	感情分析、会話の要約、AI を活用したインサイト
詳細設定	6	Webhook、カスタム関数（関数呼び出し）、CRM エンドポイント
スマートフォローアップ	6	AI による購入意向の検出、自動フォローアップメッセージ
タスク	6	担当者と期限を設定できる顧客タスクとリマインダー
連携	5	Shopify 接続、外部サービス、サードパーティプラットフォーム
通知	5	システム通知の管理と設定
カレンダー	4	顧客に関連付けられたイベントと予定
ナレッジベース	3	AI による回答に使用するドキュメントのアップロードと管理
アカウント	3	アカウントの詳細、請求、サブスクリプション情報
紹介	3	紹介プログラム — リンクの生成とコミッションの追跡
商品	2	商品検索と問い合わせ統計
サポート	1	WAzion サポートへの問い合わせ

---

API キーの取得

1. wazion.com で登録します
2. QR コードをスキャンして WhatsApp 番号を接続します
3. Settings > Developer に移動し、API キーをコピーします

API キーは、ダッシュボードで使用するものと同じトークンです。このキーによって、ショップとその設定が一意に識別されます。

---

環境変数

変数	必須	説明
WAZION_API_KEY	はい	WAzion API キー（Settings > Developer で取得）
WAZION_API_URL	いいえ	カスタムエンドポイント URL（デフォルト：https://www.wazion.com/api/mcp/）。セルフホストのインスタンスで使用します。

---

使用例

接続すると、AI アシスタントに次のようなことを依頼できます。

メッセージを送信する：

「+34612345678 に『ご注文の商品を発送しました！』と WhatsApp メッセージを送って」

会話を確認する：

「今日の最新の会話を表示して」

自動化を作成する：

「営業時間外に顧客からメッセージが届いたとき、AI が自動返信するワークフローを作成して」

キャンペーンを実施する：

「VIP リストに『今週末限定、20％オフ！』というメッセージを送るマスマーケティングキャンペーンを開始して」

パフォーマンスを分析する：

「今週のアクティビティ（メッセージ、応答時間、感情）の概要を教えて」

---

確認

データを変更する操作（ワークフローの削除、エージェントの削除、リストの消去など）では、2 段階の確認フローを使用します。

1. 最初の呼び出しで、実行される操作の説明を含む警告が返されます
2. confirm: true を指定して 2 回目の呼び出しを行うと、操作が実行されます

これにより、誤ってデータを破壊する操作を防止できます。この確認は AI クライアントが自動的に処理します。

---

セルフホスト

WAzion は、お使いのインフラストラクチャ上でセルフホストできます。セルフホストインスタンスを実行している場合は、WAZION_API_URL 環境変数を設定して、サーバーを指定してください。

WAZION_API_URL=https://your-instance.example.com/api/mcp/

すべてのツールは、セルフホスト環境でも同じように動作します。

---

トラブルシューティング

「Unauthorized」または 401 エラー

• API キーが正しいことを確認します（ダッシュボードの「設定」>「開発者」）
• Authorization: Bearer ヘッダーが正しい形式で設定されていることを確認します
• アカウントが有効であることを確認します

接続タイムアウト

• ネットワークから https://www.wazion.com にアクセスできることを確認します
• プロキシ経由の場合は、それに応じて HTTP クライアントを設定します
• stdio トランスポートの場合は、Node.js >= 18 がインストールされていることを確認します

ツールが表示されない

• MCP サーバーが接続されていることを確認します（クライアントの MCP ステータスを確認してください）
• 設定を追加した後、AI クライアントを再起動します
• API キーがローテーションされていないことを確認します

WhatsApp メッセージが送信されない

• WhatsApp セッションが接続されていることを確認します（必要に応じて QR コードをスキャンしてください）
• アカウントに十分なクレジットがあることを確認します
• 電話番号に国番号が含まれていることを確認します（例：+34612345678）

---

リンク

• WAzion ウェブサイト
• API ドキュメント
• 開発者向け連携ガイド
• GitHub の課題

---

ライセンス

MIT - 詳細は LICENSE を参照してください。