← All help topics

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:

  1. Set environment variables: TESTIP_API_BASE (your TestIP address) and TESTIP_TOKEN (project token from step 1).
  2. Run the bridge — locally with node server.mjs (port 8080, webhook path /marusia) or on Yandex Cloud Functions (entry point yandex-cloud-function.handler; one function serves Marusia, Alice and Salut — the platform is detected automatically).
  3. 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/posts with {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:

  1. Open dev.vk.com/ru/marusia → create a skill.
  2. Set its «Webhook URL» — your webhook address (path /marusia for the ready bridge).
  3. Save and test it in the built-in console.
  4. 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