概要
AIをVK Teams(VK WorkSpace)でボットとして機能させ、クラウドまたはオンプレミスで動作させます: 受信メッセージやイベントを読み取り、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを検索・管理します。ボットトークン。
ガイド付きセットアップ
VK Teams を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VK Teams を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
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
AIをVK Teams(VK WorkSpace)でボットとして機能させ、クラウドまたはオンプレミスで動作させます: 受信メッセージやイベントを読み取り、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを検索・管理します。ボットトークン。
セットアップ
セットアップには約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_id0を指定すると、待機中のすべてのイベントが返されます。より高いIDを渡すと、サーバーはそれまでのイベントを忘れるため、処理後にのみ行ってください。同じボットをポーリングしている別のプログラムがこのボットからイベントを取り去ります。 - APIは拒否の場合でもHTTP 200で応答し、
ok: falseとしてdescription(例えばInvalid token)を報告します; コネクタはそれをエラーに変換します。 - ほとんどのメソッドはGETリクエストであり、送信するものも含まれます; メッセージは呼び出しが行われた瞬間に配信されます。
- フォーマット:
parse_modeを使用してMarkdownV2でフォーマットが予約している文字をエスケープするか、HTMLを使用します。HTMLの方が正しく取得しやすいです。
前提条件: VK_TEAMS_API_URL、VK_TEAMS_BOT_TOKEN
コネクタをローカルにインストールする
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
http://localhost:3000/connectors/storeを開き、VK Teamsを選択し、前提条件に記載されている環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
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; グループまたはチャンネルの場合はタイトル… |
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」が何を含んでいて、どれくらいの大きさですか?"
次のステップ
このガイドは役に立ちましたか?