mcpField
M
ManyContacts - WhatsApp Business MCP

ManyContacts - WhatsApp Business MCP

ローカル
github.com/manycontactsビジネス・マーケティング028 週間前に更新

ManyContacts - WhatsApp Business MCP について

ManyContacts - WhatsApp Business MCP は、ManyContacts WhatsApp Business CRM を使う AI エージェント向けの MCP サーバーです。連絡先管理、メッセージ、キャンペーン、AI 自動返信のツールを提供します。

主な機能

  1. 01連絡先の管理と絞り込み
  2. 02連絡先の割り当て、タグ付け、整理
  3. 03WhatsApp メッセージの閲覧と送信
  4. 04キャンペーンの実行
  5. 05AI 自動返信の設定

活用シーン

  1. 01CRM の連絡先や営業ステージの更新
  2. 02エージェントによる WhatsApp 会話の処理
  3. 03キャンペーンと自動返信の設定

MCP 対応

連絡先、WhatsApp メッセージ、キャンペーン、AI エージェント設定など、ManyContacts CRM の操作を MCP クライアント向けツールとして提供します。

設定

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

mcp.json · 共通設定
{
"mcpServers": {
"manycontacts-whatsapp": {
"command": "npx",
"args": [
"-y",
"@manycontacts/mcp"
],
"env": {
"MC_CLI_TOKEN": "<MC_CLI_TOKEN>"
}
}
}
}
起動コマンドnpx -y @manycontacts/mcp
設定が必要な環境変数
MC_CLI_TOKENシークレットManyContacts CLI authentication token. Get one at https://manycontacts.com or via: npx @manycontacts/cli auth login

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

パッケージ
npm@manycontacts/mcp1.1.1

ツール

55

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

このツールにパラメーターはありません。

詳細

smithery badge

ManyContacts MCP サーバー

ManyContacts(WhatsApp Business CRM)向けの MCP(Model Context Protocol)サーバーです。AI エージェント(Claude、Cursor、Windsurf など)が、連絡先の管理、WhatsApp メッセージの送信、キャンペーンの実施、AI 自動返信の設定など、CRM のすべての操作をプログラムから実行できます。

クイックスタート

1. CLI トークンを取得する
npm install -g @manycontacts/cli

すでにアカウントをお持ちですか? ログインします。

mc auth login --email [email protected] --password mypassword
mc auth whoami   # verify it works

ManyContacts を初めてお使いですか? アカウントを作成して、WhatsApp チャネルを接続します。

# Register a new account
mc auth register --email [email protected] --name "My Company"

# Connect a WhatsApp Business channel (choose one method):
mc channels connect whatsapp-api      # WhatsApp Cloud API (recommended)
mc channels connect coexistence       # ManyContacts coexistence mode
mc channels connect qr                # QR code pairing

# Verify everything is set up
mc auth whoami
mc channels list
2. MCP クライアントで設定する
Claude Desktop / Claude Code

MCP の設定(~/.claude/claude_desktop_config.json など)に追加します。

{
  "mcpServers": {
    "manycontacts": {
      "command": "npx",
      "args": ["@manycontacts/mcp"],
      "env": {
        "MC_CLI_TOKEN": "your-cli-token-here"
      }
    }
  }
}
Cursor

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

{
  "mcpServers": {
    "manycontacts": {
      "command": "npx",
      "args": ["@manycontacts/mcp"],
      "env": {
        "MC_CLI_TOKEN": "your-cli-token-here"
      }
    }
  }
}

ヒント: CLI(mc auth login)からすでにログインしている場合、トークンは ~/.manycontacts/config.json に保存されており、MCP サーバーが自動的に読み込みます。そのため、MC_CLI_TOKEN 環境変数は不要です。


利用可能なツール(合計 55 個)

アカウントとコンテキスト
manycontacts.context

ManyContacts アカウントの概要を取得します。接続済みの WhatsApp Business チャネル、連絡先/ユーザー/タグの数、有効な AI エージェント、利用可能な機能が含まれます。他の操作を実行する前に、アカウントの状態を把握するために最初に使用してください。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.org.get

名前、タイムゾーン、すべての設定を含む、WhatsApp Business 組織/アカウントの情報を取得します。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.org.update

タイムゾーン、自動返信メッセージ、自動クローズの動作、Webhook の設定など、組織レベルの設定を更新します。

パラメーター型必須説明
timezonestringいいえタイムゾーン識別子(例:Europe/Madrid、America/New_York)
auto_reply_openbooleanいいえ新しいチャットが開かれたときの自動返信を有効にします
auto_reply_open_textstringいいえチャットが開かれたときに送信する自動返信メッセージ
auto_reply_closebooleanいいえチャットが閉じられたときの自動返信を有効にします
auto_reply_close_textstringいいえチャットが閉じられたときに送信する自動返信メッセージ
auto_reply_close_minutesnumberいいえ自動クローズまでの非アクティブ時間(分)
auto_reply_awaybooleanいいえ不在時/営業時間外の自動返信を有効にします
auto_reply_away_textstringいいえ不在時の自動返信メッセージ
webhooks_forwardbooleanいいえWebhook を外部 URL に転送する機能を有効にします
webhooks_forward_urlstringいいえWebhook イベントの転送先となる外部 URL

manycontacts.org.schedule.get

営業時間のスケジュールを取得します。曜日ごとに設定された営業時間を返します。この時間を使って、「不在時」の自動返信を有効にするタイミングを判定します。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.org.apikey

直接 API 連携に使用する、組織の REST API キーを取得します。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.channels.list

接続済みの WhatsApp Business チャネルと Instagram チャネルをすべて一覧表示します。WhatsApp チャネルについては電話番号と接続状態、Instagram チャネルについてはユーザー名を表示します。

パラメーター型必須説明
(なし)——パラメーターは不要です

連絡先

連絡先に関するすべての操作では、電話番号を識別子として使用します(国番号を含め、+ は付けません。例:34600000000)。

manycontacts.contacts.list

高度なフィルターを使ってWhatsApp Businessの連絡先を一覧表示します。has_more インジケーター付きで、ページネーションされた結果を返します。フィルターは自由に組み合わせられます。

パラメーター型必須説明
pagenumberいいえページ番号(デフォルト:1)
limitnumberいいえ1ページあたりの結果数。最大 200(デフォルト:50)
open"true" | "false"いいえ会話の開閉状態で絞り込みます
assigned_tostringいいえ割り当てられたユーザー ID で絞り込みます
tagsstringいいえカンマ区切りのタグ ID。連絡先は指定されたタグをすべて持っている必要があります
teamstringいいえチーム ID で絞り込みます
stagesstringいいえカンマ区切りのファネルステージ ID
date_fromstringいいえこの日付以降に更新された連絡先で絞り込みます(YYYY-MM-DD)
date_tostringいいえこの日付以前に更新された連絡先で絞り込みます(YYYY-MM-DD)
unread"true"いいえ未読メッセージがある連絡先のみ
blacklist"true"いいえブラックリストに登録された連絡先のみ
scheduled"true"いいえ送信待ちの予約済みメッセージがある連絡先のみ

Note: date_from と date_to を併用する場合、期間は90日以内にする必要があります。

レスポンス:

{
  "ok": true,
  "data": [
    {
      "name": "John Doe",
      "number": "34600000000",
      "open": true,
      "last_user_id": "uuid-of-assigned-user",
      "source": "whatsapp",
      "notes": "VIP customer",
      "customFields": {},
      "createdAt": "2026-01-15T10:30:00Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "has_more": true }
}

manycontacts.contacts.get

特定の連絡先について、タグ、チーム、ファネルステージ、カスタムフィールドを含む詳細情報を取得します。

パラメーター型必須説明
phonestringはい国番号付きの電話番号(例:34600000000)

manycontacts.contacts.create

CRMに新しいWhatsApp Businessの連絡先を作成します。電話番号は自動的に正規化されます(先頭の + は削除されます)。

パラメーター型必須説明
phonestringはい国番号付きの電話番号(例:34600000000)
namestringいいえ連絡先の表示名
notesstringいいえ連絡先に関する自由記述のメモ

manycontacts.contacts.update

既存の連絡先の名前、メモ、またはカスタムフィールドを更新します。

パラメーター型必須説明
phonestringはい更新する連絡先の電話番号
namestringいいえ新しい連絡先名
notesstringいいえ新しい連絡先メモ
customFieldsstringいいえJSON 文字列形式のカスタムフィールド(例:'{"company":"Acme"}')

manycontacts.contacts.delete

CRMから連絡先を完全に削除します。

パラメーター型必須説明
phonestringはい削除する連絡先の電話番号

manycontacts.contacts.assign

連絡先を特定のチームメンバーに割り当てます。割り当てられたユーザーは、この連絡先を個人の受信トレイで確認できます。

パラメーター型必須説明
phonestringはい連絡先の電話番号
userIdstringはい連絡先の割り当て先ユーザー ID(ID の取得には manycontacts.users.list を使用してください)

manycontacts.contacts.unassign

連絡先への現在のユーザー割り当てを解除します。連絡先は一般の未割り当て受信トレイに戻ります。

パラメーター型必須説明
phonestringはい連絡先の電話番号

manycontacts.contacts.close

WhatsAppの会話を終了します。終了した会話はアーカイブされ、アクティブな受信トレイには表示されなくなります。

パラメーター型必須説明
phonestringはい連絡先の電話番号

manycontacts.contacts.open

以前に閉じたWhatsAppの会話を再開します。連絡先が再びアクティブな受信トレイに表示されます。

パラメーター型必須説明
phonestringはい連絡先の電話番号

manycontacts.contacts.tag.add

連絡先にタグを追加します。利用可能なタグIDを取得するには、manycontacts.tags.listを使用します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
tagIdstringはい追加するタグID

manycontacts.contacts.tag.remove

連絡先からタグを削除します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
tagIdstringはい削除するタグID

manycontacts.contacts.team.add

連絡先にチームを追加します。利用可能なチームIDを取得するには、manycontacts.teams.listを使用します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
teamIdstringはい追加するチームID

manycontacts.contacts.team.remove

連絡先からチームを削除します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
teamIdstringはい削除するチームID

manycontacts.contacts.set_stage

連絡先をセールスファネル/パイプライン内の特定のステージに移動します。ファネルIDとステージIDを取得するには、manycontacts.funnels.listを使用します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
funnel_idstringはいファネルID
stage_idstringはいファネル内の移動先ステージID

manycontacts.contacts.bulk

複数の連絡先に対して一括操作を実行します。クローズ、再開、割り当て、タグ付け、チームの割り当てに対応しています。

パラメーター型必須説明
action"close" | "open" | "assign" | "add_tag" | "add_team"はい実行する一括操作
phonesstringはいカンマ区切りの電話番号(例:"34600000000,34600000001")
valuestringいいえ操作に必要な値:assignにはユーザーID、add_tagにはタグID、add_teamにはチームIDが必要です。closeまたはopenの場合は不要です。

メッセージング
manycontacts.messages.list

連絡先とのWhatsApp会話のメッセージ一覧を取得します。タイムスタンプ、ステータス、送信者情報を含む、会話に適した形式でメッセージを返します。

パラメーター型必須説明
phonestringはい連絡先の電話番号
pagenumberいいえページ番号(デフォルト:1)
limitnumberいいえ1ページあたりのメッセージ数(デフォルト:50)

manycontacts.messages.send.text

連絡先にWhatsAppのテキストメッセージを送信します。24時間の会話ウィンドウ内でのみ使用できます。このウィンドウ外で会話を開始するには、manycontacts.messages.send.templateを使用してください。

パラメーター型必須説明
phonestringはいメッセージの送信先電話番号
bodystringはいメッセージ本文

manycontacts.messages.send.note

連絡先との会話に内部メモを作成します。メモはチームメンバーのみが閲覧でき、WhatsAppの連絡先には送信されません。

パラメーター型必須説明
phonestringはい連絡先の電話番号
bodystringはい内部メモの本文

manycontacts.messages.send.template

WhatsApp Business のテンプレートメッセージを送信します。24時間の期間外に会話を開始する場合や、一括送信する場合はテンプレートが必要です。テンプレートは Meta の事前承認が必要です。

ParameterTypeRequiredDescription
phonestringYesテンプレートの送信先電話番号
templateIdstringYesテンプレート ID(ID を取得するには manycontacts.templates.list を使用)
variablesstringNoJSON 配列文字列で指定するテンプレート変数(例:'["John","20%"]')

テンプレート

WhatsApp Business のテンプレートは、24時間の会話期間外にメッセージを送信する際に必要な、事前承認済みのメッセージ形式です。

manycontacts.templates.list

WhatsApp Business のメッセージテンプレートをすべて一覧表示します。テンプレート名、コード、ステータス、コンポーネント、メディアフラグが表示されます。

ParameterTypeRequiredDescription
status"approved" | "pending" | "rejected"No承認ステータスでテンプレートを絞り込みます

manycontacts.templates.get

特定のテンプレートの詳細(コンポーネント(ヘッダー、本文、フッター、ボタン)、設定、メディア添付ファイルを含む)を取得します。

ParameterTypeRequiredDescription
idstringYesテンプレート ID

manycontacts.templates.sync

Meta Cloud API から WhatsApp Business のテンプレートを同期します。接続済みの WhatsApp Business アカウントから最新のテンプレートを取得します。Meta Business Manager でテンプレートを作成または変更した後に便利です。

ParameterTypeRequiredDescription
(none)——パラメーターは不要です

キャンペーン

キャンペーンでは、指定した日時に電話番号のリストへ WhatsApp テンプレートメッセージを一括送信できます。

manycontacts.campaigns.list

WhatsApp Business の一括メッセージ送信キャンペーンをすべて一覧表示します。統計(送信数、配信数、既読数、失敗数)、テンプレート名、予定日時が表示されます。

ParameterTypeRequiredDescription
(none)——パラメーターは不要です

manycontacts.campaigns.create

WhatsApp Business の新しい一括メッセージ送信キャンペーンを作成します。指定した日時に、指定した電話番号へテンプレートメッセージを送信します。

ParameterTypeRequiredDescription
namestringYesキャンペーン名
templateIdstringYes使用する WhatsApp テンプレート ID(approved である必要があります)
phonesstringYesカンマ区切りの電話番号(例:"34600000000,34600000001,34600000002")
datestringYesISO 形式の送信予定日時(例:"2026-12-01T09:00:00")
variablesstringNoJSON 配列文字列で指定するテンプレート変数(例:'["John","20%"]')

manycontacts.campaigns.delete

WhatsApp Business のキャンペーンを削除します。保留中(未送信)のキャンペーンのみ削除できます。

ParameterTypeRequiredDescription
idstringYes削除するキャンペーン ID

タグ

タグは、WhatsApp Business の連絡先を分類および絞り込みするための色付きラベルです(例:「VIP」、「サポート」、「見込み客」)。

manycontacts.tags.list

利用可能なタグをすべて、名前、色、ID とともに一覧表示します。

ParameterTypeRequiredDescription
(none)——パラメーターは不要です

manycontacts.tags.create

連絡先を分類するための新しいタグを作成します。

ParameterTypeRequiredDescription
namestringYesタグ名
colorstringNo16進数コードで指定するタグの色(例:"#ff0000")。デフォルトは #fab1a0 です

manycontacts.tags.update

既存のタグの名前または色を更新します。

パラメーター型必須説明
idstringはい更新するタグの ID
namestringいいえ新しいタグ名
colorstringいいえ16 進数コードで指定する新しいタグの色

manycontacts.tags.delete

タグを削除します。このタグが付いているすべての連絡先からタグが削除されます。

パラメーター型必須説明
idstringはい削除するタグの ID

チーム

チームはユーザーをグループ化し、担当者への割り当てや連絡先の整理に使用します。

manycontacts.teams.list

組織内のすべてのチームを一覧表示します。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.teams.create

新しいチームを作成します。

パラメーター型必須説明
namestringはいチーム名

manycontacts.teams.add_member

ユーザーをチームに追加します。

パラメーター型必須説明
teamIdstringはいチーム ID
userIdstringはいチームに追加するユーザーの ID

manycontacts.teams.remove_member

ユーザーをチームから削除します。

パラメーター型必須説明
teamIdstringはいチーム ID
userIdstringはいチームから削除するユーザーの ID

manycontacts.teams.delete

チームを削除します。チームのメンバーは削除されず、チームのグループ分けのみが削除されます。

パラメーター型必須説明
idstringはい削除するチームの ID

営業ファネル/パイプライン

ファネルを使うと、複数段階の営業またはサポートのパイプラインで連絡先を追跡できます(例:「新規リード」 -> 「見込み顧客」 -> 「提案」 -> 「成約」)。

manycontacts.funnels.list

すべての営業ファネル/パイプラインとそのステージを一覧表示します。

パラメーター型必須説明
(なし)——パラメーターは不要です

manycontacts.funnels.create

新しい営業ファネル/パイプラインを作成します。

パラメーター型必須説明
namestringはいファネル名

manycontacts.funnels.add_stage

既存のファネルに新しいステージを追加します。

パラメーター型必須説明
funnelIdstringはいファネル ID
namestringはいステージ名(例:「見込み顧客」、「提案送付済み」)
ordernumberはいパイプライン内のステージ位置(0 始まり)

manycontacts.funnels.update_stage

ファネル内のステージ名を更新します。

パラメーター型必須説明
funnelIdstringはいファネル ID
stageIdstringはい更新するステージの ID
namestringいいえ新しいステージ名

manycontacts.funnels.contacts

特定のファネルに現在含まれている連絡先を一覧表示します。ステージで絞り込むこともできます。ページ分けされた結果を返します。

パラメーター型必須説明
funnelIdstringはいファネル ID
stage_idstringいいえ特定のステージ IDで絞り込みます
pagenumberいいえページ番号
limitnumberいいえ1 ページあたりの結果数

manycontacts.funnels.delete

営業ファネル/パイプラインとそのすべてのステージを削除します。ファネル内の連絡先は削除されません。

パラメーター型必須説明
idstringはい削除するファネルの ID

ユーザー/チームメンバー

WhatsApp Business CRM にアクセスできるチームメンバーを管理します。

manycontacts.users.list

組織内のすべてのチームメンバー/ユーザーを、役割と詳細とともに一覧表示します。

ParameterTypeRequiredDescription
(none)——パラメーターは必要ありません

manycontacts.users.get

特定のチームメンバーの詳細を取得します。

ParameterTypeRequiredDescription
idstringYesユーザー ID

manycontacts.users.update

チームメンバーのプロフィール情報を更新します。

ParameterTypeRequiredDescription
idstringYes更新するユーザー ID
namestringNo新しいユーザー表示名

manycontacts.users.invite

メールで新しいチームメンバーを組織に招待します。参加するための招待メールが送信されます。

ParameterTypeRequiredDescription
emailstringYes招待メールの送信先メールアドレス

manycontacts.users.delete

チームメンバーを組織から削除します。そのメンバーに割り当てられていた連絡先は未割り当てになります。

ParameterTypeRequiredDescription
idstringYes削除するユーザー ID

AI エージェント

AI エージェントは、設定可能な指示とシナリオを使って、受信した WhatsApp メッセージに自動返信します。有効なエージェントのみが一覧表示されます。

manycontacts.ai_agents.list

有効な AI 自動返信エージェントを、設定とともにすべて一覧表示します。

ParameterTypeRequiredDescription
(none)——パラメーターは必要ありません

manycontacts.ai_agents.get

シナリオ(会話フロー)、指示ブロック、設定を含む、特定の AI エージェントの詳細を取得します。

ParameterTypeRequiredDescription
idstringYesAI エージェント ID(UUID)

manycontacts.ai_agents.update

AI エージェントの設定を更新します。エージェントの有効/無効を切り替えたり、指示ブロックを変更したりできます。

ParameterTypeRequiredDescription
idstringYesAI エージェント ID(UUID)
activebooleanNoエージェントを有効化(true)または無効化(false)します
block_1stringNoエージェントへの指示 — ブロック 1
block_2stringNoエージェントへの指示 — ブロック 2
block_3stringNoエージェントへの指示 — ブロック 3

manycontacts.ai_agents.feedback

AI エージェントのフィードバックと会話ログを取得します。エージェントの応答状況と、ユーザー満足度データを確認できます。

ParameterTypeRequiredDescription
idstringYesAI エージェント ID(UUID)

利用可能なプロンプト(合計 6 件)

一般的なワークフローを AI エージェントが進めるための、事前作成済みプロンプトです。複数ステップのタスクをすばやく完了するために使用します。

contact-lookup

WhatsApp の連絡先を検索し、プロフィール、タグ、ファネルの段階、最近のメッセージを含む完全な概要を取得します。

ArgumentRequiredDescription
phoneYes国際形式の電話番号(例:+34612345678)

send-campaign

WhatsApp の一括キャンペーンを作成するための手順ガイドです。利用可能なテンプレートを一覧表示し、宛先とスケジュールを尋ねた後、キャンペーンを作成します。

ArgumentRequiredDescription
(none)—対話形式のガイド付きワークフロー

daily-dashboard

チャネル、未対応の会話、チーム構成、営業ファネルなど、ManyContacts アカウントの全体像を生成します。

引数必須説明
(なし)—引数は不要です

reply-to-contact

連絡先との最近の会話履歴を確認してから、すべてのコンテキストを踏まえた WhatsApp メッセージを送信します。

引数必須説明
phoneはい国際形式の電話番号(例:+34612345678)
messageはい送信するメッセージ本文

manage-funnel

すべての営業ファネルについて、各ステージとステージごとの連絡先数を表示し、パイプラインの全体像を視覚的に把握できます。

引数必須説明
(なし)—引数は不要です

bulk-tag-contacts

複数の連絡先に一括でタグを付けます。タグを検索または作成してから、一括で適用します。

引数必須説明
phonesはいカンマ区切りの電話番号(例:+34612345678,+34698765432)
tagNameはい適用するタグの名前

環境変数

変数必須説明
MC_CLI_TOKENはい*ManyContacts CLI の認証トークン。mc auth login で取得できます。
MC_API_URLいいえAPI のベース URL(デフォルト:https://api.manycontacts.com)

*CLI でログインすると、トークンは ~/.manycontacts/config.json にローカル保存され、MCP サーバーが自動的に読み込みます。

認証

MCP サーバーは CLI トークンを使用して認証します。各トークンは組織に紐付けられ、権限を設定できます。

# Login to get a token
mc auth login --email [email protected] --password mypassword

# The token is stored at ~/.manycontacts/config.json
# Or set it explicitly via environment variable:
export MC_CLI_TOKEN=your-token-here

レート制限

  • 有料アカウント: 1 分あたり 60 リクエスト
  • 無料/トライアルアカウント: 1 分あたり 10 リクエスト

レート制限に達すると、アップグレード用のリンクを含む 429 エラーが返されます。

ライセンス

MIT

コメント

MCP は初めてですか?

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

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