# VS Code

> Подключение MMW к VS Code (режим агента) напрямую по HTTP через файл mcp.json.

Из этой страницы вы узнаете, как подключить MMW к VS Code напрямую по HTTP, не храня ключ в открытом виде в репозитории, и как проверить подключение.

## Что вы получите

- Инструменты `remember`, `search`, `forget`, `validate_memory`, `gateway_call` в чате VS Code в режиме агента.
- Общую память с Claude Code, Cursor, Codex и claude.ai при ключе того же аккаунта и проекта.
- Ничего не нужно устанавливать: подключение прямое, по HTTPS.

## Что нужно

- API-ключ MMW (начинается с `mmw_`) — см. [Быстрый старт](/start/quickstart/).
- VS Code с поддержкой MCP-серверов и чатом в режиме агента.

Формат `mcp.json` в VS Code менялся между версиями. Ниже — актуальный на момент написания вариант: корневой ключ `servers`, у сервера поля `type`, `url`, `headers`. Если ваша версия использует другие имена, сверьтесь с документацией VS Code по MCP — адрес сервера и заголовок останутся теми же.

## Подключение

1. Создайте в корне проекта файл `.vscode/mcp.json`. Чтобы MMW работал во всех проектах, используйте вместо него пользовательскую конфигурацию MCP (команда палитры «MCP: Open User Configuration» в версиях, где она есть).

2. Добавьте сервер. Ключ лучше не писать в файл, а запрашивать при запуске:

   ```json title=".vscode/mcp.json"
   {
     "inputs": [
       {
         "type": "promptString",
         "id": "mmw-key",
         "description": "API-ключ MMW",
         "password": true
       }
     ],
     "servers": {
       "mmw": {
         "type": "http",
         "url": "https://mcp.mmwhub.ru/mcp",
         "headers": { "Authorization": "Bearer ${input:mmw-key}" }
       }
     }
   }
   ```

   VS Code спросит ключ при первом запуске сервера и сохранит его в своём защищённом хранилище.

3. Запустите сервер: над блоком `mmw` в редакторе файла появится ссылка «Start», или выполните команду «MCP: List Servers» и запустите `mmw` оттуда.

## Проверка

1. Откройте чат VS Code и переключите его в режим агента.

2. Нажмите кнопку выбора инструментов: в списке должен быть сервер `mmw` с инструментами `remember`, `search`, `forget`, `validate_memory`, `gateway_call`.

3. Попросите:

   ```text
   Запомни в MMW: staging выкатывается через systemd-юнит app-staging. Ключ факта: deploy-staging.
   ```

   VS Code может попросить подтвердить вызов `remember`; после подтверждения запись сохранится со статусом `unverified`.

4. В новом чате спросите:

   ```text
   Как у нас выкатывается staging? Посмотри в MMW.
   ```

   Ожидаемый ответ: агент вызывает `search` и отвечает, что staging выкатывается через `app-staging`.

## Типичные проблемы

Проверьте URL (`https://mcp.mmwhub.ru/mcp`, с `/mcp` на конце) и что в заголовке стоит `Bearer`, пробел и ключ. Если вы ввели ключ с ошибкой, сбросьте сохранённое значение ввода в VS Code и запустите сервер снова.

Если ключ записан в `.vscode/mcp.json` открытым текстом и файл закоммичен, отзовите ключ в кабинете и выпустите новый. Используйте `inputs`, как в примере выше.

Инструменты MCP доступны только в режиме агента. В обычном режиме вопросов чат их не вызывает.

## Что дальше