This is an old revision of the document!
Подключение инструментов к Claude
Инструкция для аналитика: как получить доступ к вики из Claude, чтобы модель могла читать и записывать страницы напрямую.
Инструменты предоставляет MCP-сервер ToolMesh по адресу
https://mcp.ve-playground.ai.zevgen.com/mcp.
Прежде чем начать
Нужно получить у администратора:
Свой публичный IP должен быть добавлен в allow-лист nginx, при условии использования НЕ vpn nl, последний уже добавлен в список.
Набор доступов зависит от тарифа.
Тариф Team
- *API-ключ ToolMesh** - запросить в группе VAS AI Lab.
Личный тариф
- *Логин и пароль для OAuth** - запросить в группе VAS AI Lab.
Для обоих вариантов: браузер должен ходить через NL VPN — без него страница OAuth-входа недоступна.
Claude Desktop (личный тариф)
Добавить коннектор
File → Settings → Connectors → Add → Add Custom Connector
- Name:
ve-playground-protocols - Client ID / Client Secret (имя пользователя и пароль) — не заполнять
Войти
После добавления Claude откроет в браузере страницу OAuth-провайдера — логин и пароль вводятся там. Креды — в группе VAS AI Lab.
Если с первого раза подключение не прошло (ошибка авторизации, пустой список инструментов) — повторить попытку. Со второго раза обычно проходит.
Claude Desktop (тариф Team)
Шаг 1. Установить Node.js
Нужен для пакета-моста mcp-remote. Скачать LTS-версию: https://nodejs.org
После установки, в новом окне терминала:
node --version npx --version
Если npx не находится — перезагрузить машину (обновление PATH не всегда
подхватывается без ребута).
Шаг 2. Найти файл конфигурации
Windows (MSIX-сборка из Store):
C:\Users\<user>\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
Windows (обычная установка):
%APPDATA%\Claude\claude_desktop_config.json
plication Support/Claude/claude_desktop_config.json </code>
Шаг 3. Добавить блок mcpServers
Файл уже содержит настройки приложения (preferences, coworkUserFilesPath).
Ключ mcpServers добавляется рядом с ними, на верхнем уровне — существующее
содержимое не удалять.
{ "mcpServers": { "toolmesh": { "command": "cmd", "args": ["/c", "npx", "-y", "mcp-remote", "https://mcp.ve-playground.ai.zevgen.com/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer СЮДА_TOOLMESH_API_KEY" } } }, "preferences": { ... }, "coworkUserFilesPath": "..." }
Два нюанса, из-за которых чаще всего не работает:
- В
“Authorization:${AUTH_HEADER}”нет пробела после двоеточия —
пробел ломает разбор аргумента в mcp-remote. Пробел между Bearer и
ключом ставится внутри ''env'', там он безопасен. * Обратные слэши в путях JSON экранируются: ''C:\\Users\\...''
Шаг 4. Перезапустить Claude Desktop
Именно полностью закрыть — правой кнопкой по иконке в трее → Quit. Закрытие окна крестиком не перезапускает MCP-серверы.
Ограничение по IP
Эндпоинт /mcp закрыт allow-листом на уровне nginx. Разрешены:
- диапазоны Anthropic (
160.79.104.0/21,2607:6bc0::/48) — для API и
коннекторов claude.ai
- localhost
- явно добавленные IP отдельных сотрудников — для
mcp-remote
/authorize и /token открыты всем.
Причина: mcp-remote работает на машине аналитика и обращается к серверу
с его собственного адреса, а не через облако Anthropic. Поэтому каждому, кто
подключается через Claude Desktop, нужно индивидуально добавить IP.