mcpField
M
mcp-zenvia

mcp-zenvia

ローカル
github.com/codesparコミュニケーション2754 週間前に更新
リポジトリ

mcp-zenvia について

mcp-zenvia は、Zenvia のマルチチャネルメッセージングプラットフォーム向けの MCP サーバーです。MCP クライアントから SMS、WhatsApp、RCS、メール、音声、Facebook Messenger のメッセージを送信できます。テンプレート、レポート、Webhook サブスクリプション、連絡先の管理にも対応しています。

主な機能

  1. 01SMS、WhatsApp、RCS、メールなど複数チャネルに対応
  2. 02承認済みテンプレートによるWhatsAppメッセージ送信
  3. 03IDによるメッセージ配信ステータスの確認
  4. 04Webhookサブスクリプションの作成と管理
  5. 05連絡先と配信停止リストの管理

活用シーン

  1. 01AI アシスタントから顧客へWhatsApp や SMS で通知を送信
  2. 02配信ステータスの確認とレポートエントリの確認
  3. 03連絡先の管理と配信停止リクエストの記録

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-zenvia": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zenvia"
      ],
      "env": {
        "ZENVIA_API_TOKEN": "<ZENVIA_API_TOKEN>"
      }
    }
  }
}
起動コマンドnpx -y @codespar/mcp-zenvia
設定が必要な環境変数
ZENVIA_API_TOKENシークレットAPI key for zenvia

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-zenvia0.2.2

ツール

18

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
tostringはい国番号付きの受信者の電話番号（例：5511999999999）
fromstringはい送信者 ID
textstringはいメッセージ本文

詳細

@codespar/mcp-zenvia

Zenvia 向け MCP サーバー — マルチチャネルメッセージング（SMS、WhatsApp、RCS）

npm License: MIT

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}
Claude Code
claude mcp add zenvia -- npx @codespar/mcp-zenvia
Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}

ツール（18）

ツール目的
send_smsSMS メッセージを送信します
send_whatsappWhatsApp メッセージを送信します
send_rcsRCS（リッチコミュニケーションサービス）メッセージを送信します
send_emailトランザクションメールを送信します
send_voiceTTS または録音済み音声 URL を使って音声メッセージを送信します
send_facebook_messageFacebook Messenger メッセージを送信します
get_message_statusID でメッセージの配信状況を取得します
list_channels利用可能なメッセージングチャネルを一覧表示します
create_subscriptionメッセージイベント用の Webhook サブスクリプションを作成します
list_subscriptionsすべての Webhook サブスクリプションを一覧表示します
delete_subscriptionID で Webhook サブスクリプションを削除します
list_contactsコンタクトベースから連絡先を一覧表示します
create_contactコンタクトベースに連絡先を作成します
delete_contactID で連絡先を削除します
send_templateWhatsApp テンプレートメッセージ（事前承認済み）を送信します
list_templates承認済みメッセージテンプレート（WhatsApp/SMS/RCS）を一覧表示します
get_report_entries指定した期間のメッセージレポート項目を取得します
add_opt_out電話番号をオプトアウトリストに追加します（以後のメッセージ送信を抑止します）

認証

Zenvia は、X-API-TOKEN ヘッダーで渡す API トークンを使用します。

サンドボックス／テスト

Zenvia は、メッセージのテスト用にダッシュボードからサンドボックスを提供しています。

認証情報の取得
  1. Zenvia にアクセスします
  2. アカウントを作成します
  3. ダッシュボードから API トークンを取得します
  4. ZENVIA_API_TOKEN 環境変数を設定します

環境変数

変数必須説明
ZENVIA_API_TOKENはいZenvia ダッシュボードから取得した API トークン

ロードマップ

v0.2（予定）
  • create_contact_list — キャンペーン用のコンタクトリストを作成します
  • send_batch — コンタクトリストに一括メッセージを送信します
  • get_report — メッセージ配信レポートを取得します
  • create_flow — 会話フローを作成します
  • list_templates — 承認済みメッセージテンプレートを一覧表示します
v0.3（予定）
  • chatbot_integration — Zenvia チャットボットビルダーと連携します
  • analytics_dashboard — チャネル分析と指標を取得します

貢献をご希望ですか？PR を送信するか、ツールをリクエストしてください。

リンク

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。