Подключение MCP-клиентов к VK Workspace MCP

Разработчики и продвинутые пользователи могут воспользоваться Workspace MCP (Model Context Protocol): через него к данным VK WorkSpace можно подключить внешние ИИ-инструменты.

Официальный MCP-сервер VK WorkSpace доступен по адресу:

 
https://ai.workspace.vk.ru/mcp

1. Выполните:

    
   claude mcp add --transport http --scope user vk-workspace https://ai.workspace.vk.ru/mcp

2. Затем в интерфейсе выполните команду /mcp, выберите vk-workspace → Authenticate и пройдите OAuth-авторизацию в браузере.

Работает одинаково на macOS, Linux и Windows.

Claude Desktop имеет две вкладки с разными механизмами подключения MCP: Home и Code.

Chat и Cowork — это режимы работы на вкладке Home, они используют общий конфигурационнй файл Desktop. Кастомный коннектор из Customize → Connectors с этим сервером не работает, поэтому сервер подключается через прокси-пакет mcp-remote.

Отдельно ставить mcp-remote не нужно: npx -y в конфигурационном файле ниже сам скачает и запустит пакет при первом обращении. Установить нужно только Node.js 18+ — вместе с ним приходит npx.

1. Проверить:

    
   node --versionnpx --version

2. Откройте конфигурационный файл Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Добавьте или дополните секцию mcpServers:

 
{  "mcpServers": {    "vk-workspace": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://ai.workspace.vk.ru/mcp"]    }  }}

4. Перезапустите Claude Desktop — при первом обращении к инструментам откроется браузер для OAuth-авторизации.

Вкладка Code использует конфигурационный файл Claude Code CLI: сервер, добавленный по разделу Claude Code выше, появится и здесь.

Авторизацию сервера можно пройти прямо из приложения. После входа в браузере страница Вход выполнен откроет Claude сама или по кнопке Вернуться в приложение. Браузер может спросить разрешение открыть приложение. Если вход из приложения не завершился, авторизуйтесь в CLI через /mcp: вкладка Code использует тот же токен.

1. Выполните:

 
codex mcp add vk-workspace --url https://ai.workspace.vk.ru/mcp

2. Перезапустите Codex — авторизация пройдёт автоматически в браузере.

Codex Desktop имеет две вкладки — ChatGPT и Codex. Обе используют тот же конфигурационный файл, что и Codex CLI. Если CLI уже настроен по инструкции выше, отдельно добавлять сервер не нужно.

Если Codex CLI не установлен, добавьте сервер через интерфейс: Настройки → Плагины → MCP → Добавить

• Название: vk-workspace
• URL: https://ai.workspace.vk.ru/mcp
• Тип: HTTP

После добавления сервер появится в списке с кнопкой Аутентифицировать — нажмите её и пройдите OAuth-авторизацию в браузере. На этом подключение закончено.

В ChatGPT сервер подключается как коннектор в режиме разработчика. Названия пунктов меню зависят от версии ChatGPT, ниже путь на момент написания.

1. В настройках ChatGPT найдите раздел приложений и коннекторов и включите режим разработчика (обычно в дополнительных настройках этого раздела).

2. Создайте новый коннектор и заполните поля:

   • Название: vk-workspace
   • URL MCP-сервера: https://ai.workspace.vk.ru/mcp
   • Аутентификация: OAuth

3. Подтвердите создание и войдите в открывшемся окне браузера.

После входа коннектор появится в списке, и его можно будет выбрать в чате.

1. Выполните:

 
opencode mcp add vk-workspace --url https://ai.workspace.vk.ru/mcpopencode mcp auth vk-workspace

2. Проверьте, что сервер появился в списке:

 
opencode mcp list

1. Откройте Cursor Settings → MCP и добавьте HTTP-сервер:

• Name: vk-workspace
• Type: http
• URL: https://ai.workspace.vk.ru/mcp

Либо вручную отредактируйте файл конфигурации MCP:

• macOS / Linux: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

 
{  "mcpServers": {    "vk-workspace": {      "url": "https://ai.workspace.vk.ru/mcp"    }  }}

2. Перезапустите Cursor — авторизация пройдёт в браузере при первом обращении к инструментам.

• После добавления или изменения конфигурации MCP обязательно перезапустите клиент.
• Если что-то не работает — сначала проверьте сетевую доступность до https://ai.workspace.vk.ru.