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

Этот сервер реализует Model Context Protocol (MCP) и доступен по адресу:

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

Claude Code

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

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

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

Claude Desktop

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

Вкладка Home (режимы Chat и Cowork)

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

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

node --version
npx --version

Откройте конфиг-файл Claude Desktop:

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

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

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

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

Вкладка Code

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

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

Codex CLI

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

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

Codex Desktop

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

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

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

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

ChatGPT

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

1. В настройках ChatGPT найдите раздел приложений и коннекторов и включите режим разработчика (обычно в дополнительных настройках этого раздела).
2. Создайте новый коннектор и заполните поля:
   • Название: vk-workspace
   • Урл MCP-сервера: https://ai.workspace.vk.ru/mcp
   • Аутентификация: OAuth
3. Подтвердите создание и войдите в открывшемся окне браузера.

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

OpenCode

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

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

opencode mcp list

Cursor

Откройте 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"
    }
  }
}

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

Общее

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