
Voice control with Marusia / VK Kapsula (RU)
Manage posts by voice via VK's "Marusia" assistant and "VK Kapsula" speakers (a Russian platform), using the same actions as the MCP server. Setup is in the Russian help.
1How it works
Marusia doesn't call «MCP-мост и AI-агенты» directly — you need a Marusia skill with an HTTPS webhook. The chain is simple:
- 🗣️ you say a phrase to a VK Kapsula speaker or the Marusia app;
- 🔗 Marusia sends the recognized phrase to your webhook;
- 🤖 the webhook calls the same TestIP actions as MCP (approve / reject / find / create a post) via the project token;
- 📣 a short reply comes back and Marusia reads it aloud.
Handy detail: Marusia's skill protocol matches the Yandex Dialogs format (request.command in, response.text out), so the bridge is almost identical to Alice's.
2Easiest way — the ready-made bridge (no coding)
Ready bridge: voice-bridges.zip (same as for Alice and Salut). Step by step:
- Set environment variables:
TESTIP_API_BASE(your TestIP address) andTESTIP_TOKEN(project token from step 1). - Run the bridge — locally with
node server.mjs(port 8080, webhook path/marusia) or on Yandex Cloud Functions (entry pointyandex-cloud-function.handler; one function serves Marusia, Alice and Salut — the platform is detected automatically). - Paste the bridge URL into the skill's «Webhook URL» field (step 3).
Russian commands are built in. See voice-bridges/README.md. The steps below are for a custom webhook.
3Step 1. Create a project API token
Open «Информация о проекте» → «API tokens for AI agents» → «Create token». It's the same token as the MCP server, Alice and Salut. 🔒 Copy it once (shown a single time) and keep it secret.
4Step 2. Host a bridge webhook
You need an HTTPS endpoint that accepts Marusia skill requests (JSON with request.command — the recognized phrase, session.new — dialog start, version) and returns { version, session, response: { text, tts, end_session } } — same shape as Alice. Inside, by phrase it calls the same endpoints as MCP (header Authorization: Bearer <token>):
- 🔍
GET {BASE}/api/agent/posts?status=draft— find drafts; - ✅
PATCH {BASE}/api/agent/posts/{id}with{"action":"approve"|"reject"}— approve/reject; - ➕
POST {BASE}/api/agent/postswith{title,body}— create a draft.
The ready bridge already implements all of this — you only need the token and address.
5Step 3. Create the Marusia skill
Step by step:
- Open dev.vk.com/ru/marusia → create a skill.
- Set its «Webhook URL» — your webhook address (path
/marusiafor the ready bridge). - Save and test it in the built-in console.
- Launch on a device by saying «Маруся, запусти <skill name>».
6Step 4. Commands (example phrases)
Same as Alice/Salut (shared bridge):
- 📝 «how many drafts» / «what's in the queue» → show drafts;
- ✅ «approve the latest post» → approve the freshest one;
- ⛔ «reject the post about …» → find by topic and reject;
- ➕ «create a draft …» → capture an idea by voice.
Keep replies short — Marusia reads them aloud on VK Kapsula.
7Step 5. Testing, account linking, publishing
Where to test and how to use it:
- 🔍 test the skill in the VK developer console, the Marusia app and a VK Kapsula speaker (Mini/Neo);
- 👤 for personal use the token in the bridge config is enough (one skill — one project);
- 🧩 for multiple users set up account linking on VK's side.
Until the skill is submitted for moderation and published, it's private to you — that's enough for your own channel.
8Security
The token = access to the project's posts (create, approve, scheduled publishing). Rules:
- 🔒 keep the webhook and token secret, use HTTPS, never log the token;
- 🔁 revoke the token anytime in «Информация о проекте» («API tokens» → delete) — the skill then stops working;
- ✅ voice is great for approving/rejecting and asking status, while risky bulk actions are better left to the dashboard.
Didn't find an answer? Write to us — we'll help.
Contact support