vk-mcp-ru
API do VK no assistente de IA: publicações no mural, comunidades, diálogos, produtos, anúncios e estatísticas. 373 métodos, a publicação solicita confirmação.
Documentação
vk-mcp-ru
API do VK para assistentes de IA: produtos da loja da comunidade, posts, campanhas publicitárias e estatísticas, diálogos com clientes, formulários de lead. Catálogo baseado no esquema oficial, cada método com classe de acesso.
O catálogo foi montado a partir da fonte original (esquema oficial VKCOM/vk-api-schema) e está no repositório como
vk_mcp/endpoints.yaml: 373 métodos, sendo 159 de leitura,
173 de escrita e 41 irreversíveis. O servidor executa exatamente esse arquivo,
portanto a tabela abaixo não pode divergir do código.
Instalação
uvx vk-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"vk-mcp": {
"command": "uvx",
"args": ["vk-mcp-ru"],
"env": { "VK_TOKEN": "..." }
}
}
}
Chaves
dev.vk.com → aplicativo → chave de acesso de serviço, ou token da comunidade com permissões de market, messages, ads, stats. Solicite apenas as permissões realmente necessárias.
| variável | segredo | o que é |
|---|---|---|
VK_TOKEN | sim | Chave de serviço do aplicativo VK ou token da comunidade com as permissões necessárias. |
As chaves não precisam ficar no ambiente: o servidor suporta contas e as armazena em
~/.ru-mcp/cabinets.json com permissões 600, fora do repositório.
Mapa de métodos
| seção | métodos | leitura | escrita | irreversível |
|---|---|---|---|---|
| Comunidades | 51 | 20 | 25 | 6 |
| Diálogos | 48 | 21 | 22 | 5 |
| Publicidade | 47 | 24 | 16 | 7 |
| Produtos e loja | 45 | 16 | 23 | 6 |
| Fotos | 44 | 18 | 22 | 4 |
| Vídeos | 34 | 9 | 20 | 5 |
| Posts no mural | 25 | 7 | 16 | 2 |
| Discussões | 13 | 2 | 9 | 2 |
| Documentos | 12 | 7 | 4 | 1 |
| Páginas wiki | 8 | 4 | 4 | 0 |
| Formulários de lead | 7 | 3 | 3 | 1 |
| Pedidos | 7 | 5 | 2 | 0 |
| Utilitários | 7 | 6 | 0 | 1 |
| Cartões em posts | 6 | 3 | 2 | 1 |
| Usuários | 5 | 4 | 1 | 0 |
| VK Donut | 4 | 4 | 0 | 0 |
| Estatísticas | 3 | 2 | 1 | 0 |
| Armazenamento do aplicativo | 3 | 2 | 1 | 0 |
| Notificações | 3 | 1 | 2 | 0 |
| Podcasts | 1 | 1 | 0 | 0 |
| total | 373 | 159 | 173 | 41 |
Como fica no chat
Você: posts no mural da comunidade
vk_search_methods("посты на стене сообщества")
vk_wall_get POST /method/wall.get чтение
vk_wall_search POST /method/wall.search чтение
vk_wall_get_by_id POST /method/wall.getById чтение
vk_describe_method("vk_wall_get")
Returns a list of posts on a user wall or community wall.
POST api.vk.com/method/wall.get
параметры: domain, offset, count, filter, extended, fields
класс доступа: чтение
vk_call_method("vk_wall_get", {"domain": "...", "offset": "..."})
Três ferramentas em vez de 373 funções: o agente busca o método por palavras, lê o cartão dele e chama. Escrita e ações irreversíveis pedem confirmação.
O que costumam pedir:
- Consolidar pedidos e produtos da loja da comunidade em uma tabela.
- Ver estatísticas da comunidade e dos posts por período.
- Levantar gastos e indicadores das campanhas publicitárias do VK Ads.
- Analisar diálogos não lidos e preparar respostas para aprovação.
Segurança
O servidor roda na máquina do usuário, as chaves não saem para fora. Os métodos têm três classes de acesso: leitura executa imediatamente, escrita e ações irreversíveis exigem confirmação. O cabeçalho de autorização não sai dos domínios do serviço mesmo ao chamar um caminho arbitrário.
Verificar instalação
uvx vk-mcp-ru doctor
Mostra quantos métodos foram carregados, se as chaves foram encontradas e de onde. Segredos não são
exibidos. Com --live faz uma chamada real barata de leitura.
Projetos relacionados
O núcleo está extraído em schema-mcp-core. Servidores vizinhos: hh-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru. Os marketplaces ficam separados: marketplaces-mcp-ru.
MIT. Autor Ilya Utov.
Todos os projetos em uma lista, organizados por finalidade: ilyautov.github.io.