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

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

Инструменты предоставляет MCP-сервер [[tech:server:toolmesh|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''

  * **URL:** ''https://mcp.ve-playground.ai.zevgen.com/mcp''
  * **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

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

<code>
node --version
npx --version
</code>

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

==== Шаг 2. Найти файл конфигурации ====

Windows (MSIX-сборка из Store):

<code>
C:\Users\<user>\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
</code>

Windows (обычная установка):

<code>
%APPDATA%\Claude\claude_desktop_config.json
</code>

plication Support/Claude/claude_desktop_config.json
</code>


==== Шаг 3. Добавить блок mcpServers ====

Файл уже содержит настройки приложения (''preferences'', ''coworkUserFilesPath'').
Ключ ''mcpServers'' добавляется **рядом с ними**, на верхнем уровне — существующее
содержимое не удалять.

<code javascript>
{
  "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": "..."
}
</code>


Два нюанса, из-за которых чаще всего не работает:

  * В ''"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 NL VPN
  * явно добавленные IP отдельных сотрудников — для ''mcp-remote''

''/authorize'' и ''/token'' открыты всем.

Причина: ''mcp-remote'' работает **на машине аналитика** и обращается к серверу
с его собственного адреса, а не через облако Anthropic. Поэтому каждому, кто
подключается через Claude Desktop, нужно индивидуально добавить IP.





[[start|← Главная]]