Подключение инструментов к Claude

Инструкция для аналитика: как получить доступ к вики из Claude, чтобы модель могла читать и записывать страницы напрямую.

Инструменты предоставляет MCP-сервер ToolMesh по адресу https://mcp.ve-playground.ai.zevgen.com/mcp.

Нужно получить у администратора:

• API-ключ ToolMesh (TOOLMESH_API_KEY) — для подключения
• Свой публичный IP должен быть добавлен в allow-лист nginx — см.

Ограничение по IP ниже, это обязательный шаг

Нужен для пакета-моста 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.

ToolMesh поддерживает OAuth 2.1, и по проекту это был основной способ для Claude Desktop, но он не работает со стандартными MCP-клиентами из-за дефекта в ToolMesh: на неавторизованный запрос сервер отвечает HTTP 200 с JSON-RPC-ошибкой внутри вместо HTTP 401 с заголовком WWW-Authenticate.

Клиент не распознаёт это как «нужна авторизация» и не запускает браузерный вход — вместо этого падает на разборе ответа (ZodError, id: null).

Поэтому подключение идёт через Bearer-токен. Детали и воспроизведение — auth.

← Главная