インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Zalo Official Account をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
Zalo Official Account（ベトナム）: OA のプロフィールとメッセージクォータ、詳細とラベル付きのフォロワーとユーザー、最近のチャットと会話、テキストまたは画像付きの相談メッセージ、OA の記事。貼り付けた OA アクセストークン（有効期間は約 25 時間）を使います。
こう聞いてみよう
Zalo Official Account のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Zalo Official Account をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Zalo Official Account + Claude
Zalo Official Account（ベトナム）: OA のプロフィールとメッセージクォータ、詳細とラベル付きのフォロワーとユーザー、最近のチャットと会話、テキストまたは画像付きの相談メッセージ、OA の記事。貼り付けた OA アクセストークン（有効期間は約 25 時間）を使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
ZALO_OA_ACCESS_TOKEN
ステップ 1 — 認証情報を取得
設定は約 5 分ですが、トークンは毎日更新する必要があります（下記参照）。Zalo Official Account と、権限を承認する OA 管理者が必要です。
- https://developers.zalo.me でアプリを作成するか既存のアプリを開き、Official Account に紐付けて、Official Account > OA permissions でコネクタが使う権限グループを申請します。OA 情報の管理、ユーザー情報の管理、ユーザーメッセージの管理、OA 経由のメッセージと通知の送信、記事の管理です。OA 管理者がそれらを承認します。
- Tools > API Explorer（https://developers.zalo.me/tools/explorer）を開き、アプリを選んで、アクセストークンの種類 OA Access Token を選択し、OA を選び、申請した権限を許可して、access token をコピーします。
- それを
ZALO_OA_ACCESS_TOKENに貼り付けます。Zalo が要求するaccess_tokenヘッダーで送られます。 - コネクタをインストールし、
zalo_oa_get_oa_infoを実行して確認します。
トークンの有効期間は約 25 時間です。 Zalo は OA アクセストークンを独自の OAuth v4 フローでしか更新できず、AnythingMCP はこのコネクタでそのフローを実行できないため、トークンは貼り付けて使います。呼び出しがエラー -216 または -220 を返したら、API Explorer で新しいトークンを作成し、コネクタの設定に保存してください。自社のシステムでトークンを更新している場合は、新しいトークンをそのたびに AnythingMCP API で ZALO_OA_ACCESS_TOKEN に書き込めます。
読み取れるデータ: OA のプロフィール（名前、ID、認証、フォロワー、サービスパッケージ）とメッセージクォータ、OA をフォローしているか OA と会話したユーザー（1 ページ 50 人、ラベル、最終やり取り、フォロワー状態で絞り込み可能）、1 人のユーザーの名前、エイリアス、フォロワー状態、最終やり取り日、ラベル、メモ、共有情報、OA のラベル、全チャットの最新メッセージと 1 人のユーザーとのメッセージ（1 回 10 件）、そして OA の記事と動画とその本文です。
書き込める内容: ユーザー情報（エイリアス、自社の顧客 ID、共有情報）とラベルです。AI はユーザーにラベルを付け（ラベルがなければ作成します）、または外します。zalo_oa_send_text は相談テキストを送り、必要に応じてユーザーのメッセージを引用します。zalo_oa_send_image は画像 1 枚付きの相談メッセージを送ります。どちらも実在の人に届くため、AI はテキストを示してあなたの同意を待ちます。
相談メッセージを送れる条件: 過去 7 日以内に OA とやり取りしたユーザーにだけ送れます。2026 年 1 月 1 日からは、ユーザーの最後のやり取りから 48 時間以内の相談メッセージは無料かつ無制限で、それ以降のものは OA パッケージのクォータを消費するか、課金されます。zalo_oa_get_user_quota で、そのユーザーにまだ何を送れるかがわかります。エラー -230 または -232 はユーザーの最後のやり取りが古すぎること、-213 はユーザーが OA をフォローしていないことを意味します。
インストール時はオフ: zalo_oa_delete_tag です。OA と、そのラベルが付いたすべてのユーザーからラベルを削除し、元に戻せません。
形式: どの応答にも error（0 = 成功）と message があり、ペイロードは data にあります。エラーは HTTP 200 と負の error で返ります。ユーザー、OA、メッセージの ID は長い数字の文字列です。メッセージでは、ユーザーが送ったものは src が 1、OA が送ったものは 0 です。メッセージの時刻は Unix ミリ秒で、user_last_interaction_date は dd/MM/yyyy です。
制限: アプリあたり毎分 4,000 リクエストに加え、OA パッケージに応じた OA ごとの制限があります。エラー -32 は次の 1 分まで待つ必要があることを意味します。ユーザー一覧で取得できるのは最初の 10,000 人までです。
よくあるエラー: -216 または -220 は無効または期限切れのトークン（新しいトークンを貼り付けてください）、-223 は OA がアプリに付与していない権限、-224 は OA パッケージに含まれない機能、-201 は無効なパラメータ、-211 はクォータを使い切ったことを意味します。
このコネクタは、トランザクション、プロモーション、ZNS テンプレートのメッセージ、ファイル、スタンプは送信せず、グループチャット、通話、記事の作成、OA ショップには対応していません。Webhook は Zalo のアプリ設定で構成します。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Claude にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（
https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
推奨ルート：設定ファイルを触らずに claude.ai web で動作します。
- Claude で Customize → Connectors を開きます。
- + をクリックし、Add custom connector を選びます。
- 名前（例:
Zalo Official Account）とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン（OAuth）してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| Tool | What it does |
|---|---|
zalo_oa_get_oa_info | Profile of the Official Account the token belongs to: OA id (oaid), name, description, alias, verification status, OA type, category… |
zalo_oa_get_quota | Message quota of the OA or the app: one row per quota asset with the product type (cs = consultation, transaction), the quota source… |
zalo_oa_get_user_quota | What the OA can still send to one user: the time of the user's last interaction with the OA (last_interaction, Unix milliseconds) and the… |
zalo_oa_list_users | Page through the users who interacted with the OA (followers and people who messaged it) |
zalo_oa_filter_users | Page through the OA's users with filters: by label (tag), by when they last interacted, or by whether they follow the OA |
zalo_oa_get_user | Details of one user: display name, alias, your own customer id (user_external_id), whether the user follows the OA, last interaction date… |
zalo_oa_update_user | Update what the OA stores about a user: the alias, your own customer id (user_external_id, unique per user) and the shared information… |
zalo_oa_list_tags | All labels (tags) defined in the OA, as a list of label names |
zalo_oa_tag_user | Put a label on a user |
zalo_oa_untag_user | Remove a label from one user |
zalo_oa_delete_tag | Delete a label from the OA, which also takes it off every user who has it |
zalo_oa_list_recent_chats | The latest messages across all of the OA's conversations, newest first: sender and recipient ids and names, direction (src 1 = from the… |
zalo_oa_get_conversation | Messages between the OA and one user, newest first, 10 at most per call: message_id (use it as quote_message_id to reply), direction… |
zalo_oa_send_text | Send a consultation (customer care) text message from the OA to a user, optionally as a reply quoting one of the user's messages |
zalo_oa_send_image | Send a consultation message with one image (JPG or PNG, at most 1 MB, best at 16:9) and an optional caption |
zalo_oa_list_articles | The OA's published content: articles (type normal) or videos (type video), with id, title, status, views, shares, creation and update… |
zalo_oa_get_article | One article with its title, author, cover, description, status, comment setting and body blocks (text, images, videos) |
プロンプトの例
- 「過去 24 時間に OA にメッセージを送ったユーザーは誰で、何を尋ねていましたか？」
- 「このユーザーとの会話を表示し、最後の質問への返信の下書きを作ってください。」
- 「今週配送について質問した全員に、ラベル delivery-question を付けてください。」
- 「OA の相談メッセージのクォータはあとどれくらい残っていますか？」
- 「OA の記事のうち、最も多く閲覧された 5 件を一覧にしてください。」
FAQ
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?