インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Viber Bot をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
Viber REST Bot API で、Viber ボットからメッセージを送ります。キーボード付きのテキスト、画像、動画、ファイル、リンク、連絡先、位置情報、スタンプ、リッチメディアカルーセル、最大 300 人の購読者への一斉送信、購読者の詳細とオンライン状態、ボットの Webhook に対応します。ボットの認証トークンを使います。
こう聞いてみよう
Viber Bot のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Viber Bot をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Viber Bot + Claude
Viber REST Bot API で、Viber ボットからメッセージを送ります。キーボード付きのテキスト、画像、動画、ファイル、リンク、連絡先、位置情報、スタンプ、リッチメディアカルーセル、最大 300 人の購読者への一斉送信、購読者の詳細とオンライン状態、ボットの Webhook に対応します。ボットの認証トークンを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
VIBER_AUTH_TOKEN
ステップ 1 — 認証情報を取得
ボットがあれば、設定は約 5 分です。
- 既存の Viber ボットが必要です。2024 年 2 月 5 日以降、Viber は新しいボットを商用条件でのみ作成しています。Rakuten Viber またはその公式パートナーを通じて申し込んでください(https://developers.viber.com/docs/api/rest-bot-api/ を参照)。以前からある無料のボットは引き続き使えます。
- ボットの認証トークン(app key)をコピーします。ボットの管理者として Viber アプリの More > Settings > Bots > Edit Info > Your app key、または Viber Admin Panel で確認できます。
- それを
VIBER_AUTH_TOKENに貼り付け、コネクタをインストールし、viber_get_account_infoを実行して確認します。 - Viber では、Webhook が設定された後でなければ、ボットはユーザーにメッセージを送れません。ボットにまだ Webhook がない場合は
viber_set_webhookで設定します。URL は Viber の確認に HTTP 200 で応答し、信頼された CA の証明書を持っている必要があります。
このコネクタは送信を行い、受信は行いません。Viber は受信メッセージとイベントを、ボットの Webhook(自分で用意する公開 HTTPS エンドポイント)にだけ届けます。
メッセージを受け取れる人: ボットを購読しているユーザーだけです。ユーザーはボットにメッセージを送るか購読をタップすると購読者になり、いつでも購読を解除できます。購読者を一覧にする API はなく、ユーザー ID は Webhook に届くため、AI が送信先に使う ID はそこから取得したものでなければなりません。それ以外の相手への送信は receiverNotSubscribed(6)または receiverNotRegistered(5)で失敗します。電話番号宛てのメッセージ送信は別の有料製品(Viber Business Messages)で、このコネクタには含まれません。
送信できるもの: 1 人の購読者に、最大 7,000 文字のテキスト(返信ボタンのキーボードも付けられます)、画像、動画、ファイル、リンク、連絡先カード、位置情報、スタンプ、画像とボタン付きのカードを並べたリッチメディアカルーセルを送れます。どの送信でも、受信者のユーザー ID と最大 28 文字の送信者名を指定します。viber_broadcast_message は 1 回の呼び出しで最大 300 人の購読者に同じメッセージを送り、テキストで指定された箇所に各受信者の名前または ID を差し込み、届かなかった受信者を一覧にします。
読み取れるデータ: Webhook、イベントタイプ、購読者数を含むボットアカウント、1 人の購読者の名前、国、言語、デバイス、Viber のバージョン(ユーザーごとに 12 時間で最大 2 回)、そして最大 100 人の購読者のオンライン状態です。Webhook の設定や削除もできます。削除すると、ユーザーとボットの 1 対 1 チャットが閉じられます。
送信の前に必ず確認: どのメッセージも実在の人に届き、商用ボットでは、ユーザーが開始したセッションの外で送るメッセージに料金がかかります。AI はテキストと受信者を示し、あなたの同意を待ちます。
形式: どの応答にも status(0 = ok)と status_message があり、それ以外のステータスはエラーとして返ります。送信したメッセージは message_token を返します。billing_status が 0 から 4 なら課金なし、5 はセッション外の課金メッセージです。時刻は Unix ミリ秒です。
制限: リクエストは 30 KB 未満でなければなりません。画像は JPEG、PNG、静止画の GIF で、iOS では 1 MB まで(Android では 3 MB まで)、URL に拡張子が必要です。動画は MP4 で 26 MB、180 秒まで、ファイルは 50 MB までです(実行ファイルは拒否されます)。一斉送信は 10 秒間に 500 リクエストまでです。freeMessagesExceeded(23)または noBalance(24)は、毎月の無料メッセージまたは残高を使い切ったことを意味します。
よくあるエラー(status): 2 は無効なトークン、5 は受信者が Viber を使っていない、6 は受信者が購読していない、7 はボットがブロックされている、9 はボットが停止されている、10 は Webhook が設定されていない、11 は受信者の Viber が古すぎる、12 はリクエストが多すぎる、21 は国が対応していないことを意味します。
このコネクタは受信メッセージの受け取りや読み取り、購読者の一覧、電話番号宛てのメッセージ送信は行いません。
ステップ 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 を選びます。
- 名前(例:
Viber Bot)とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン(OAuth)してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| Tool | What it does |
|---|---|
viber_get_account_info | Details of the bot account: id, name, uri, icon, category, country, the webhook URL and its event_types, and subscribers_count |
viber_get_user_details | Details of one subscribed user: name, avatar, country, language, primary device OS, device type, Viber and API version |
viber_get_online | Online status of up to 100 subscribed users. online_status: 0 online, 1 offline (with last_online in Unix ms), 2 hidden by the user, 3 try… |
viber_send_text | Send a text message (up to 7,000 characters) to one subscribed user, optionally with a keyboard of reply buttons |
viber_send_picture | Send a picture (JPEG, PNG or static GIF from a URL) with a caption to one subscribed user |
viber_send_video | Send an MP4 video (H.264, up to 26 MB and 180 seconds) from a URL to one subscribed user |
viber_send_file | Send a file (up to 50 MB, from a URL) to one subscribed user, e.g. a PDF invoice |
viber_send_url | Send a link (up to 2,000 characters) to one subscribed user; Viber shows a preview |
viber_send_contact | Send a contact card (name and phone number) to one subscribed user |
viber_send_location | Send a location pin (latitude and longitude) to one subscribed user |
viber_send_sticker | Send a Viber sticker by its numeric sticker id to one subscribed user |
viber_send_rich_media | Send a rich media message (a carousel of cards with images, text and buttons) to one subscribed user |
viber_broadcast_message | Send the same message to up to 300 subscribed users in one call |
viber_set_webhook | Set the bot's webhook, the HTTPS endpoint where Viber delivers incoming messages and events |
viber_remove_webhook | Remove the bot's webhook |
プロンプトの例
- 「Viber ボットの購読者は何人いて、どの Webhook を使っていますか?」
- 「購読者 01234567890A== に『ご注文の商品を発送しました。』というテキストを、『はい』と『いいえ』の返信ボタン付きで送ってください。」
- 「週末の営業時間をこの 120 個の購読者 ID に一斉送信し、失敗したものを教えてください。」
- 「この 20 人の購読者のうち、今オンラインなのは誰ですか?」
- 「3 つの商品のカルーセルを送ってください。それぞれに画像、価格、商品ページを開く『購入』ボタンを付けてください。」
FAQ
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?