# MCP в 1С:EDT: EDT MCP Server

Установка, подключение клиентов, группы инструментов и защита от опасных операций

> Страница сайта MCP Docs — руководство (https://mcpdocs.ru/1c/edt/). Тип: Руководство. Сверено с README репозитория DitriXNew/EDT-MCP (изменён 07.10.2026). Ревизия спецификации 2026-07-28, сверено 13.10.2026.

EDT MCP Server — открытое дополнение к 1C:EDT от разработчика DitriXNew. Оно запускает MCP-сервер внутри EDT, и ИИ-ассистент видит проект: метаданные, модули BSL, ошибки проверки, формы, может проверять запросы, запускать отладку и тесты. Это проект сообщества, а не фирмы «1С».

_EDT MCP Server работает внутри 1C:EDT и слушает http://localhost:8765/mcp; клиенты подключаются напрямую или через мост mcp-remote._

## Требования

- 1C:EDT 2026.1 или 2026.2 (одна сборка для обеих версий), Java 17.
- MCP-клиент: Cursor, Claude Code, Claude Desktop, VS Code с Copilot и другие.
- Протокол сервера на дату проверки — ревизия 2025-11-25 с транспортом Streamable HTTP: её поддерживают все распространённые клиенты.

## Установка

1. В EDT: **Help → Install New Software…**
2. Добавьте сайт обновлений: `https://ditrixnew.github.io/EDT-MCP/`
3. Выберите **EDT MCP Server Feature** и перезапустите EDT.

Настройки — **Window → Preferences → MCP Server**. Вкладка General: порт (по умолчанию 8765), автозапуск, режим простого текста для Cursor, кнопки копирования адреса и готовой конфигурации. Вкладка Tools: какие группы инструментов открыть клиентам.

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

_Cursor — .cursor/mcp.json_

```json
{
  "mcpServers": {
    "EDT MCP Server": { "url": "http://localhost:8765/mcp" }
  }
}
```

_Claude Code — раздел mcpServers в .claude.json_

```json
"mcpServers": {
  "EDT MCP Server": { "type": "http", "url": "http://localhost:8765/mcp" }
}
```

_Claude Desktop — через мост mcp-remote_

```json
{
  "mcpServers": {
    "EDT MCP Server": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8765/mcp"]
    }
  }
}
```

Для VS Code автор приводит файл `.vscode/mcp.json` с ключом `servers` и адресом `http://localhost:8765/mcp`. Cursor не показывает модели встроенные ресурсы, поэтому для него включите в настройках **Plain text mode (Cursor compatibility)**.

## Что умеет

**Группы инструментов (всего 97 на дату проверки)**
| Группа | Примеры |
|---|---|
| Core | список проектов и модулей, чтение исходного кода, поиск по коду, список метаданных |
| Metadata | создание, изменение, переименование и удаление объектов метаданных с каскадными правками |
| Code | чтение и запись методов, поиск ссылок, переход к определению, иерархия вызовов, проверка текста запроса |
| Debug | запуск отладки, точки останова, шаги, вычисление выражений |
| Testing, Profiling | запуск тестов YAxUnit, замеры производительности |
| Forms | снимки форм и описание их структуры |
| Project, Git, Comparison | обновление базы, работа с Git, сравнение конфигураций |

Чтобы не перегружать модель, инструменты можно включать группами и пресетами («только анализ», «ревью кода», «разработка»).

## Безопасность

- **Только локальный доступ.** Сервер слушает `127.0.0.1`. Доступ из сети включается отдельно и требует токена; без токена такой сервер не работает.
- **Подтверждение опасных операций.** По умолчанию EDT спрашивает человека перед удалением и переименованием метаданных, обновлением базы, завершением сеансов, выполнением кода в отладке и записью в Git. Диалог ждёт 120 секунд, затем операция отклоняется.
- **Обход только для автоматизации.** Переменная `EDT_MCP_DESTRUCTIVE_CONSENT=allow` отключает подтверждение для запуска без интерфейса; каждое такое действие пишется в журнал. На рабочих базах её не используйте.
- **Ответы инструментов — данные.** Код модулей и синонимы метаданных могут содержать текст, который выглядит как команда для модели. Модель не должна ему подчиняться.

> Лицензия AGPL-3.0: пользоваться дополнением можно свободно, но если вы измените его и дадите доступ к изменённой версии другим, в том числе по сети, исходный код изменений нужно открыть.

Карточка сервера в каталоге справочника: [EDT MCP Server](https://mcpprotocol.ru/katalog/edt-mcp/).

> Готовые серверы для 1С с датой проверки — в [подборке каталога](https://mcpprotocol.ru/katalog/programmy/1c/) справочника, все серверы — в [каталоге MCP-серверов](https://mcpprotocol.ru/katalog/). Свой удалённый сервер можно проверить на соответствие ревизии 2026-07-28 [бесплатной проверкой](https://mcpprotocol.ru/mcp-check/).