Summary
Let your AI work as a bot in VK Teams (VK WorkSpace), in the cloud or on-premise: read incoming messages and events, send and edit messages, send files, answer button presses, and look up and manage groups and channels. Bot token.
Guided setup
Connect VK Teams to Microsoft Copilot in 2 minutes
Start a free trial on AnythingMCP Cloud, connect VK Teams in the guided setup, then add your MCP URL to Microsoft Copilot. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for VK Teams
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → VK Teams, enter the Bot API address and the bot token from Metabot, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
VK Teams + Microsoft Copilot
Let your AI work as a bot in VK Teams (VK WorkSpace), in the cloud or on-premise: read incoming messages and events, send and edit messages, send files, answer button presses, and look up and manage groups and channels. Bot token.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
VK_TEAMS_API_URL, VK_TEAMS_BOT_TOKEN
Step 1 — Get credentials
Setting up takes about 3 minutes.
- In VK Teams open a chat with Metabot (search for
@metabot) and send/newbot. Choose a name and a nick ending inbot. Metabot answers with the bot token, which looks like001.2659914704.0218887601:747432131. - Paste the token into
VK_TEAMS_BOT_TOKEN. It is sent as thetokenquery parameter of every call, so it shows up in the URL of each request: treat the address below as trusted infrastructure only. - Set
VK_TEAMS_API_URLto the Bot API address. For the VK Teams cloud it ishttps://myteam.mail.ru/bot/v1. An on-premise installation has its own address ending in/bot/v1; your VK Teams administrator knows it. On AnythingMCP Cloud the address must be reachable from the internet. - To let the bot work in a group or channel, allow it to join groups in Metabot (
/setjoingroups), then add it as a member (as an administrator for pinning, renaming and the member lists).
Where to start: vk_teams_get_self checks token and address. vk_teams_get_events returns what people wrote to the bot and the ids you need: payload.chat.chatId for a chat and payload.msgId for a message. There is no call that lists the bot's chats, so keep the ids you see.
Messages: vk_teams_send_text (plain, MarkdownV2 or HTML; reply, forward and inline buttons), vk_teams_edit_text, vk_teams_delete_messages (switched off at install). Files: vk_teams_upload_file fetches a file from a URL and sends it; vk_teams_send_file sends a file that is already on the server by its fileId; vk_teams_get_file_info turns a fileId somebody sent into name, size and a download link. vk_teams_answer_callback_query answers a button press, vk_teams_send_chat_actions shows typing.
Groups and channels: 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 and vk_teams_set_chat_about.
Field notes
chatId: a person is addressed by user id (in VK Teams usually the corporate e-mail address) or@nick; a group or channel id ends in@chat.agent.msgIdis a 64-bit number. Pass it as text exactly as received; the connector also returns such numbers as text so no digit is lost.- Events:
vk_teams_get_eventswithlast_event_id0 returns everything waiting. Once you pass a higher id, the server forgets the events up to it, so only do that after handling them. Another program polling the same bot takes events away from this one. - The API answers HTTP 200 even for a refusal and reports it as
ok: falsewith adescription(for exampleInvalid token); the connector turns that into an error. - Most methods are GET requests, including the ones that send; a message is delivered the moment the call is made.
- Formatting: with
parse_modeMarkdownV2 escape the characters the format reserves, or use HTML, which is easier to get right.
Step 2 — Install the adapter
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
Step 3 — Add the connector in Microsoft Copilot
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Microsoft Copilot uses MCP servers through agents built in Copilot Studio: you add AnythingMCP to an agent as a tool, then publish the agent to Microsoft 365 Copilot and Teams. Copilot Studio connects from Microsoft's cloud over Streamable HTTP, which AnythingMCP supports.
- In Copilot Studio, open your agent (or create one), go to Tools and choose Add a tool → New tool → Model Context Protocol.
- Enter a Server name (for example
AnythingMCP), a Server description that says what the connector does, and the Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio uses the description to decide when to call the server. - Under authentication, choose API key, set Type to Header and the header name to
X-API-Key, then select Create. - In Add tool, choose Create a new connection, paste an MCP API key from AnythingMCP (MCP Servers → your server → API keys) and select Add to agent.
- Try it in the agent's Test pane: ask for something that needs the
VK Teamstools. - Select Publish, then Channels → Microsoft 365 and Microsoft Teams, keep Make agent available in Microsoft Copilot selected and choose Add channel. See agent in Teams installs it for you; in Microsoft 365 Copilot, type @ and pick the agent.
Prefer per-user sign-in? Choose OAuth 2.0 → Dynamic discovery instead of an API key: each user then signs in to AnythingMCP the first time the agent calls it.
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Copilot Studio connects from Microsoft's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
vk_teams_get_self | Read the bot behind the token: userId, nick, firstName, about and photo. Use it to check the token and the API address. Read-only |
vk_teams_get_events | Read the events waiting for the bot (long polling): events[] with eventId, type (newMessage, editedMessage, deletedMessage, pinnedMessage… |
vk_teams_send_text | Send a text message as the bot to a user, group or channel, optionally formatted, as a reply, as a forward, or with inline buttons. Returns… |
vk_teams_send_file | Send a file that is already on the VK Teams servers, by its fileId, with an optional caption. The fileId comes from an earlier upload… |
vk_teams_upload_file | Upload a file from a URL and send it as the bot to a user, group or channel, with an optional caption. The connector downloads the file (up… |
vk_teams_edit_text | Change the text of a message the bot sent, and optionally its inline buttons. Returns ok. Only the bot's own messages can be edited |
vk_teams_delete_messages | Delete one or more messages from a chat for everyone. The bot can delete its own messages within 48 hours and, as an administrator of a… |
vk_teams_answer_callback_query | Answer the press of an inline button (a callbackQuery event): show the user a short notice or an alert, or open a URL. Returns ok. Answer… |
vk_teams_send_chat_actions | Show what the bot is doing in a chat for about 10 seconds: typing a message or looking at the chat. Pass an empty list to stop showing it.… |
vk_teams_get_chat_info | Read a chat: type (private, group or channel) and, for a person, firstName, lastName, nick, about and isBot; for a group or channel, title… |
vk_teams_list_chat_admins | List the administrators of a group or channel: admins[] with userId and creator (true for the owner). The bot must be a member. Read-only |
vk_teams_list_chat_members | List the members of a group or channel: members[] with userId and the flags creator and admin, plus cursor when more follow. The bot must… |
vk_teams_list_blocked_users | List the users blocked in a group or channel: users[] with userId. The bot must be an administrator there. Read-only |
vk_teams_list_pending_users | List the users waiting for approval to join a group or channel with join moderation: users[] with userId. The bot must be an administrator… |
vk_teams_pin_message | Pin a message in a group or channel so it stays at the top. The bot must be an administrator there. Returns ok |
vk_teams_unpin_message | Unpin a pinned message in a group or channel; the message itself stays. The bot must be an administrator there. Returns ok |
vk_teams_set_chat_title | Change the title of a group or channel. Every member sees the new title at once, so confirm it with the user. The bot must be an… |
vk_teams_set_chat_about | Change the description (about text) of a group or channel. The bot must be an administrator there. Returns ok |
vk_teams_get_file_info | Read the details of a file on the VK Teams servers by its fileId: type (image, video, audio and so on), size in bytes, filename and url, a… |
Example prompts
- "What did people write to the bot since this morning?"
- "Send the message Release 2.4 is live to the group Dev Announcements."
- "Who are the admins and members of the channel Sales Team?"
- "Pin the last message in the group Dev Announcements."
- "What is in the file Anna sent to the bot, and how large is it?"
FAQ
Where do the token and address come from? Write /newbot to Metabot (@metabot) in VK Teams, choose a name and a nick ending in bot, and copy the token it answers with. The Bot API address of the VK Teams cloud is https://myteam.mail.ru/bot/v1; an on-premise installation has its own address ending in /bot/v1. On AnythingMCP Cloud that address must be reachable from the internet.
What can the bot see and do? Everything happens as the bot: it reads the events sent to it, reaches users who wrote to it first and chats it was added to, sends and edits messages, sends files, answers button presses and reads and manages its groups and channels (pinning, titles and member lists need admin rights). There is no call that lists the bot's chats, and another program polling the same bot takes events away from this one.
Which tools install switched off? vk_teams_delete_messages. Switch it on on the connector page only if the AI should use it. Messages leave the moment the call is made, so the AI shows you each one first.
Which Copilot is this for? Microsoft 365 Copilot at work, through agents built in Copilot Studio. The Microsoft Copilot app for personal accounts has no option to add your own MCP server.
What do I need? A work account with access to Copilot Studio (a license or a trial) to build the agent. People who use it in Microsoft 365 Copilot or Teams need access to the agent: share it with them, or ask an admin to publish it to the organization. If your organization applies data policies to Power Platform connectors, they cover MCP servers too.
The agent doesn't call the tools. Check that the header name is exactly X-API-Key and that the key belongs to the same MCP server as the URL, and make the server description specific: Copilot Studio uses it to decide when to call the server. Publish the agent again after each change; in an open chat, type "start over" to get the new version.
Next steps
Was this guide helpful?