Onebridge

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

[English version](README_EN.md)

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

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

[](https://github.com/thmoscow-byte/onebridge/releases/latest) [](LICENSE) [](https://1c.ru) [](https://modelcontextprotocol.io/)

---

Что умеет 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](examples/prompts.md).

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

• [Установка и настройка](docs/installation.md) — подробная инструкция
• [Инструменты MCP](docs/tools.md) — описание каждого инструмента с примерами
• [Настройка Claude](docs/claude-setup.md) — Claude Code, Desktop, API
• [Решение проблем](docs/troubleshooting.md) — 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](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: thmoscow-byte
• Source: thmoscow-byte/onebridge
• License: MIT
• Homepage: https://onemanproduction.ru/onebridge/

Install and usage instructions live in the source repository linked above.