mcpField
M
mcp-z-api

mcp-z-api

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

mcp-z-api について

mcp-z-api は、WhatsApp メッセージングプラットフォーム Z-API の MCP サーバーです。複数種類のメッセージ送信と、連絡先・チャット・グループ・ラベルの管理に対応しています。WhatsApp で顧客とやり取りする AI エージェントやワークフローに適しています。

主な機能

  1. 01テキスト・画像・ドキュメント・音声・位置情報の送信
  2. 02連絡先・チャット・既読状態の管理
  3. 03グループの作成とメンバー管理
  4. 04チャットへのラベル付与
  5. 05ボタンおよびオプションリストの送信

活用シーン

  1. 01エージェントによる顧客への WhatsApp 自動返信
  2. 02グループメンバーとラベルの一括管理

MCP 対応

Z-API の WhatsApp 機能を 27 個の MCP ツールとして公開し、MCP クライアントから呼び出せるようにします。

設定

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

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

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

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

ツール

27

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

パラメーター型必須説明
phonestringはい国番号付きの電話番号（例：5511999999999）
messagestringはいテキストメッセージの内容

詳細

@codespar/mcp-z-api

Z-API 用 MCP サーバー — WhatsApp メッセージングプラットフォーム

npm License: MIT

クイックスタート

Claude Desktop

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

{
  "mcpServers": {
    "z-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-z-api"],
      "env": {
        "ZAPI_INSTANCE_ID": "your-instance-id",
        "ZAPI_TOKEN": "your-token"
      }
    }
  }
}
Claude Code
claude mcp add z-api -- npx @codespar/mcp-z-api
Cursor / VS Code

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

{
  "servers": {
    "z-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-z-api"],
      "env": {
        "ZAPI_INSTANCE_ID": "your-instance-id",
        "ZAPI_TOKEN": "your-token"
      }
    }
  }
}

ツール（27）

ツール用途
send_textWhatsApp でテキストメッセージを送信します
send_imageWhatsApp で画像メッセージを送信します
send_documentWhatsApp でドキュメントを送信します
send_audioWhatsApp で音声メッセージを送信します
get_contactsWhatsApp のすべての連絡先を取得します
check_number電話番号が WhatsApp に登録されているか確認します
get_profile_picture電話番号に対応するプロフィール画像の URL を取得します
get_messages電話番号に対応するメッセージを取得します
send_button_listWhatsApp でボタンリストメッセージを送信します
get_statusWhatsApp インスタンスの接続状態を取得します
create_groupWhatsApp グループを作成します
get_group_metadataグループのメタデータと参加者を取得します
add_group_participantWhatsApp グループに参加者を追加します
remove_group_participantWhatsApp グループから参加者を削除します
send_locationWhatsApp で位置情報メッセージを送信します
send_contactWhatsApp で連絡先カードを送信します
add_labelチャットにラベル／タグを割り当てます
get_labels利用可能なすべてのラベル／タグを一覧表示します
read_messageメッセージを既読にします
delete_messageメッセージを削除します
get_contact_metadata1 件の連絡先のメタデータ（名前、WhatsApp の表示名、プロフィール画像、ステータス）を取得します
add_contacts1 件以上の連絡先を WhatsApp のアドレス帳に追加します。
list_chatsページネーション付きで WhatsApp のすべてのチャットを一覧表示します
mark_chat_as_readチャット全体を既読または未読にします
list_groupsページネーション付きで WhatsApp のすべてのグループを一覧表示します
send_option_listインタラクティブな選択肢リスト（WhatsApp ネイティブリスト）を送信します。
send_button_actionsインタラクティブなアクションボタン（CALL、URL、REPLY）を送信します。

認証

Z-API では、リクエスト URL に埋め込まれたインスタンス ID とトークンを使用します。

サンドボックス／テスト

Z-API では、テスト用の無料トライアルを利用できます。アカウントを作成して開始してください。

認証情報の取得
  1. Z-API Developer Portal にアクセスします
  2. アカウントを作成し、無料トライアルを開始します
  3. インスタンス ID とトークンを取得します
  4. 環境変数を設定します

環境変数

変数必須説明
ZAPI_INSTANCE_IDはいZ-API インスタンス ID
ZAPI_TOKENはいZ-API インスタンストークン

ロードマップ

v0.2（予定）
  • send_sticker — WhatsApp でスタンプメッセージを送信します
  • send_reaction — メッセージにリアクションを送信します
  • get_chat_history — 連絡先とのチャット履歴全体を取得します
  • update_group_settings — グループ名、説明、設定を更新します
  • leave_group — WhatsApp グループから退出します
v0.3（予定）
  • bulk_messaging — 複数の連絡先にメッセージを送信します
  • template_management — メッセージテンプレートを作成、管理します
  • catalog_products — WhatsApp Business カタログの商品を管理します

コントリビューションをご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

エンタープライズ

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

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

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

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