概要
AIをVK Teams(VK WorkSpace)でボットとして機能させ、クラウドまたはオンプレミスで、受信メッセージやイベントを読み取り、メッセージを送信・編集し、ファイルを送信し、ボタンの押下に応答し、グループやチャンネルを検索・管理します。ボットトークン。
ガイド付きセットアップ
VK Teams を Microsoft Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで VK Teams を接続して、MCP URL を Microsoft Copilot に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 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 + Microsoft Copilot
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 — Microsoft Copilotにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。
- Copilot Studio でエージェントを開き(または新規作成し)、Tools で Add a tool → New tool → Model Context Protocol を選びます。
- Server name(例:
AnythingMCP)、コネクタでできることを説明する Server description、Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。 - 認証で API key を選び、Type を Header、ヘッダー名を
X-API-Keyにして Create を選びます。 - Add tool で Create a new connection を選び、AnythingMCP の MCP API キー(MCP Servers → 対象のサーバー → API keys)を貼り付けて Add to agent を選びます。
- エージェントの Test ウィンドウで試します。
VK Teamsのツールが必要になる依頼をしてみましょう。 - Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。
ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。
セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。
利用可能なツール
| ツール | 何をするか |
|---|---|
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
トークンとアドレスはどこから来ますか? 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は最初に各メッセージを表示します。
どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。
何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント(ライセンスまたは試用版)が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。
エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。
次のステップ
このガイドは役に立ちましたか?