tech:connect

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-входа недоступна.

File → Settings → Connectors → Add → Add Custom Connector

После добавления Claude откроет в браузере страницу OAuth-провайдера — логин и пароль вводятся там. Креды — в группе VAS AI Lab.

Если с первого раза подключение не прошло (ошибка авторизации, пустой список инструментов) — повторить попытку. Со второго раза обычно проходит.

Нужен для пакета-моста mcp-remote. Скачать LTS-версию: https://nodejs.org

После установки, в новом окне терминала:

node --version
npx --version

Если npx не находится — перезагрузить машину (обновление PATH не всегда подхватывается без ребута).

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>

Файл уже содержит настройки приложения (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\\...''

Именно полностью закрыть — правой кнопкой по иконке в трее → Quit. Закрытие окна крестиком не перезапускает MCP-серверы.

Эндпоинт /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.

← Главная

  • tech/connect.1785243981.txt.gz
  • Last modified: 2026/07/28 15:06
  • by vas_admin