概要
AIをVK Teams(VK WorkSpace)でボットとして機能させ、クラウドまたはオンプレミスで、受信メッセージやイベントを読み取り、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを検索・管理します。ボットトークン。
ガイド付きセットアップ
VK Teams を Claude に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VK Teams を接続して、MCP URL を Claude に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
こう聞いてみよう
VK Teams のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?直接cloud.anythingmcp.comを使用してください。 サインインし、Connectors → VK Teamsをクリックし、Bot APIアドレスとMetabotからのボットトークンを入力し、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
VK Teams + Claude
AIをVK Teams(VK WorkSpace)でボットとして機能させ、クラウドまたはオンプレミスで、受信メッセージやイベントを読み取り、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを検索・管理します。ボットトークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアに表示されます)。このコネクタに必要な環境変数は次のとおりです:
VK_TEAMS_API_URL, VK_TEAMS_BOT_TOKEN
ステップ1 — 認証情報を取得する
設定には約3分かかります。
- VK TeamsでMetabotとのチャットを開き(
@metabotで検索)、/newbotを送信します。名前とbotで終わるニックネームを選択します。Metabotはボットトークン(例:001.2659914704.0218887601:747432131)で応答します。 - トークンを
VK_TEAMS_BOT_TOKENに貼り付けます。これはすべての呼び出しのtokenクエリパラメータとして送信されるため、各リクエストのURLに表示されます:以下のアドレスは信頼できるインフラストラクチャとして扱ってください。 VK_TEAMS_API_URLをBot APIアドレスに設定します。VK Teamsクラウドの場合はhttps://myteam.mail.ru/bot/v1です。オンプレミスのインストールには/bot/v1で終わる独自のアドレスがあります;あなたのVK Teams管理者が知っています。AnythingMCP Cloudでは、アドレスはインターネットからアクセス可能でなければなりません。- ボットがグループやチャンネルで機能するように、Metabotでグループに参加することを許可し(
/setjoingroups)、その後メンバーとして追加します(ピン留め、名前変更、メンバーリストのために管理者として)。
開始する場所:vk_teams_get_selfはトークンとアドレスを確認します。vk_teams_get_eventsはボットに送信された内容と必要なIDを返します:チャットの場合はpayload.chat.chatId、メッセージの場合はpayload.msgIdです。ボットのチャットをリストする呼び出しはないため、見えるIDを保持してください。
メッセージ:vk_teams_send_text(プレーン、MarkdownV2またはHTML;返信、転送、インラインボタン)、vk_teams_edit_text、vk_teams_delete_messages(インストール時にオフ)。ファイル:vk_teams_upload_fileはURLからファイルを取得して送信します;vk_teams_send_fileはサーバー上に既にあるファイルをfileIdで送信します;vk_teams_get_file_infoは誰かが送信したfileIdを名前、サイズ、ダウンロードリンクに変換します。vk_teams_answer_callback_queryはボタンの押下に応答し、vk_teams_send_chat_actionsはタイピングを表示します。
グループとチャンネル:vk_teams_get_chat_info、vk_teams_list_chat_admins、vk_teams_list_chat_members、vk_teams_list_blocked_users、vk_teams_list_pending_users、vk_teams_pin_message、vk_teams_unpin_message、vk_teams_set_chat_titleおよびvk_teams_set_chat_about。
フィールドノート
chatId:人はユーザーID(VK Teamsでは通常企業のメールアドレス)または@nickで指定されます;グループまたはチャンネルIDは@chat.agentで終わります。msgIdは64ビットの数値です。受信した通りのテキストとして渡してください;コネクタもそのような数値をテキストとして返すため、数字が失われることはありません。- イベント:
vk_teams_get_eventsでlast_event_idが0の場合、待機中のすべてを返します。より高いIDを渡すと、サーバーはそれまでのイベントを忘れるため、処理後にのみ行ってください。同じボットをポーリングしている別のプログラムは、このボットからイベントを奪います。 - APIは拒否に対してもHTTP 200で応答し、
ok: falseとしてdescription(例えばInvalid token)を報告します;コネクタはそれをエラーに変換します。 - ほとんどのメソッドはGETリクエストであり、送信するものも含まれます;メッセージは呼び出しが行われた瞬間に配信されます。
- フォーマット:
parse_modeを使用してMarkdownV2でフォーマットが予約している文字をエスケープするか、HTMLを使用します。HTMLの方が正しく取得しやすいです。
ステップ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 で Plugins(一部のプランではまだ Customize)→ Connectors を開きます。
- + Add をクリックし、Add custom connector を選びます。
- 名前(例:
VK Teams)とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Continue をクリックし、検出された設定のまま、もう一度 Continue をクリックします。 - Sign in now を選んで Add をクリックし、AnythingMCP にサインイン(OAuth)してアクセスを許可します。
以下のすべてのツールがチャットに表示されます:プロンプトの入力を開始してください。
利用可能なツール
| ツール | 何をするか |
|---|---|
vk_teams_get_self | トークンの背後にあるボットを読み取ります:userId、nick、firstName、about、photo。トークンとAPIアドレスを確認するために使用します。読み取り専用 |
vk_teams_get_events | ボットを待機中のイベントを読み取ります(ロングポーリング):events[]にはeventId、type(newMessage、editedMessage、deletedMessage、pinnedMessageなど)が含まれます |
vk_teams_send_text | ボットとしてユーザー、グループ、またはチャンネルにテキストメッセージを送信します。オプションでフォーマット、返信、転送、またはインラインボタンを使用できます。返されるもの… |
vk_teams_send_file | VK Teamsサーバー上に既にあるファイルをfileIdで送信します。オプションでキャプションを付けることができます。fileIdは以前のアップロードから来ます… |
vk_teams_upload_file | URLからファイルをアップロードし、ボットとしてユーザー、グループ、またはチャンネルに送信します。オプションでキャプションを付けることができます。コネクタはファイルをダウンロードします(アップ… |
vk_teams_edit_text | ボットが送信したメッセージのテキストを変更し、オプションでインラインボタンも変更します。okを返します。ボット自身のメッセージのみが編集可能です |
vk_teams_delete_messages | チャットから1つまたは複数のメッセージを全員のために削除します。ボットは48時間以内に自分のメッセージを削除でき、管理者としてグループのメッセージも削除できます。 |
vk_teams_answer_callback_query | インラインボタンの押下に応答します(callbackQueryイベント):ユーザーに短い通知やアラートを表示するか、URLを開きます。okを返します。応答… |
vk_teams_send_chat_actions | チャットでボットが何をしているかを約10秒間表示します:メッセージを入力中またはチャットを見ている状態。表示を停止するには空のリストを渡します… |
vk_teams_get_chat_info | チャットを読み取ります:タイプ(プライベート、グループ、またはチャンネル)および、個人の場合はfirstName、lastName、nick、about、isBot;グループまたはチャンネルの場合はtitle… |
vk_teams_list_chat_admins | グループまたはチャンネルの管理者をリストします:admins[]にはuserIdとcreator(所有者の場合はtrue)が含まれます。ボットはメンバーでなければなりません。読み取り専用 |
vk_teams_list_chat_members | グループまたはチャンネルのメンバーをリストします:members[]にはuserIdとcreatorおよびadminフラグが含まれ、さらに続く場合はカーソルが表示されます。ボットは… |
vk_teams_list_blocked_users | グループまたはチャンネルでブロックされたユーザーをリストします:users[]にはuserIdが含まれます。ボットはそこで管理者でなければなりません。読み取り専用 |
vk_teams_list_pending_users | グループまたはチャンネルへの参加承認を待っているユーザーをリストします:users[]にはuserIdが含まれます。ボットはそこで管理者でなければなりません… |
vk_teams_pin_message | グループまたはチャンネルでメッセージをピン留めし、上部に固定します。ボットはそこで管理者でなければなりません。okを返します |
vk_teams_unpin_message | グループまたはチャンネルでピン留めされたメッセージのピンを外します;メッセージ自体はそのままです。ボットはそこで管理者でなければなりません。okを返します |
vk_teams_set_chat_title | グループまたはチャンネルのタイトルを変更します。すべてのメンバーは新しいタイトルを一度に見るため、ユーザーに確認してください。ボットは管理者でなければなりません… |
vk_teams_set_chat_about | グループまたはチャンネルの説明(aboutテキスト)を変更します。ボットはそこで管理者でなければなりません。okを返します |
vk_teams_get_file_info | VK Teamsサーバー上のファイルの詳細をfileIdで読み取ります:タイプ(画像、動画、音声など)、バイト単位のサイズ、ファイル名、URL、… |
例のプロンプト
- "今朝からボットに人々が何を書いたか?"
- "メッセージ「Release 2.4 is live」をグループ「Dev Announcements」に送信します。"
- "チャンネル「Sales Team」の管理者とメンバーは誰ですか?"
- "グループ「Dev Announcements」で最後のメッセージをピン留めします。"
- "ボットに送信されたファイル「Anna」が何で、どれくらいの大きさですか?"
FAQ
Claude CodeとClaude Desktopの両方で動作しますか? はい、両方をhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDにポイントしてください。
トークンとアドレスはどこから来ますか? VK TeamsでMetabot(@metabot)に/newbotと入力し、名前とbotで終わるニックネームを選択し、応答されたトークンをコピーします。VK TeamsクラウドのBot APIアドレスはhttps://myteam.mail.ru/bot/v1です;オンプレミスのインストールには/bot/v1で終わる独自のアドレスがあります。AnythingMCP Cloudでは、そのアドレスはインターネットからアクセス可能でなければなりません。
ボットは何を見たり、何ができますか? すべてはボットとして行われます:ボットに送信されたイベントを読み取り、最初に書き込んだユーザーや追加されたチャットにアクセスし、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを読み取り・管理します(ピン留め、タイトル、メンバーリストには管理者権限が必要です)。ボットのチャットをリストする呼び出しはなく、同じボットをポーリングしている別のプログラムはこのボットからイベントを奪います。
どのツールがオフになっていますか? vk_teams_delete_messages。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。メッセージは呼び出しが行われた瞬間に送信されるため、AIは最初に各メッセージを表示します。
次のステップ
このガイドは役に立ちましたか?