OneBridge — MCP-сервер для подключения Claude к 1С

English version

OneBridge подключает Claude (Code, Desktop, API) к вашей базе 1С:Предприятие через протокол MCP. AI видит метаданные, регистры, документы — и генерирует точный код с учётом реальной конфигурации.

Бесплатно. Работает с любой конфигурацией: БП, ЗУП, УТ, ERP, УНФ, КА и другими.

---

Что умеет OneBridge

Инструмент	Описание
execute_query	Выполняет запросы на языке 1С и возвращает результат
execute_code	Запускает произвольный код 1С на сервере
get_metadata	Читает структуру метаданных: справочники, документы, регистры
get_event_log	Получает журнал регистрации с фильтрацией
get_object_by_link	Находит объект по навигационной ссылке
get_link_of_object	Возвращает ссылку на объект для навигации
find_references_to_object	Ищет все ссылки на объект в базе
get_access_rights	Проверяет права доступа к объектам метаданных

Быстрый старт

1. Скачайте OneBridge

Скачать через Telegram-бот @onebridge1c_bot — получите EPF-файл, инструкцию и набор промтов.

Или скачайте EPF из GitHub Releases.

2. Запустите в 1С

1. Откройте базу 1С в режиме «Предприятие»
2. Меню → Файл → Открыть → выберите OneBridge.epf
3. Нажмите «Запустить сервер»
4. Сервер запустится на порту 1414 (по умолчанию)

3. Подключите Claude

Claude Code (в терминале):

Добавьте в файл .mcp.json в корне вашего проекта:

{
  "mcpServers": {
    "onebridge": {
      "type": "sse",
      "url": "http://localhost:1414/mcp"
    }
  }
}

Claude Desktop:

Откройте Settings → Developer → Edit Config и добавьте:

{
  "mcpServers": {
    "onebridge": {
      "type": "sse",
      "url": "http://localhost:1414/mcp"
    }
  }
}

Перезапустите Claude — инструменты OneBridge появятся автоматически.

4. Начните работать

Примеры запросов к Claude:

• «Покажи структуру справочника Номенклатура»
• «Найди все документы реализации за март 2026»
• «Напиши обработку для загрузки прайс-листа из Excel»
• «Проверь, есть ли ошибки в журнале регистрации за сегодня»

Больше примеров — в examples/prompts.md.

Документация

• Установка и настройка — подробная инструкция
• Инструменты MCP — описание каждого инструмента с примерами
• Настройка Claude — Claude Code, Desktop, API
• Решение проблем — FAQ и типичные ошибки

Архитектура

┌──────────────┐     MCP (SSE)      ┌──────────────┐     COM/HTTP     ┌──────────────┐
│              │ ◄────────────────► │              │ ◄──────────────► │              │
│    Claude    │    порт 1414       │  OneBridge   │                  │   База 1С    │
│  Code/Desktop│                    │   (EPF)      │                  │  БП/ЗУП/ERP  │
│              │ ◄────────────────► │              │ ◄──────────────► │              │
└──────────────┘   JSON-RPC 2.0    └──────────────┘                  └──────────────┘

OneBridge работает как внешняя обработка (EPF) внутри 1С и поднимает HTTP-сервер, совместимый с протоколом MCP. Claude подключается через SSE и получает доступ к инструментам для работы с базой.

Системные требования

• 1С:Предприятие 8.3.20 или выше
• Windows (для запуска EPF)
• Любая конфигурация 1С: Бухгалтерия, ЗУП, Управление торговлей, ERP, УНФ, КА и др.
• Claude Code, Claude Desktop или любой MCP-совместимый клиент

Благодарности

OneBridge создан на основе 1c-mcp-toolkit от ROCTUP. Спасибо за отличный фундамент!

Ссылки

• Сайт проекта — лендинг OneBridge
• Telegram-бот — скачать OneBridge + промты
• Telegram-канал — новости и обновления
• YouTube — видео-инструкции
• Статья: MCP-сервер для 1С — подробный разбор

Лицензия

MIT