SkillFoxx

Начните вводить название, задачу или сервис

1С через OData: MCP-сервер на чтение

onec-odata-mcp

MCP-сервер на npx, который дает Claude доступ на чтение к базе 1С через стандартный OData без выгрузки в Excel и ручных URL

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • По умолчанию только читает данные 1С, но запись включается флагом ONEC_WRITABLE
  • Пароль пользователя 1С передается в переменных окружения MCP-клиента
Все причины и проверки
Российский стек

pyrfor/onec-odata-mcpАвтор:Aleksandr Grebeshok

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/onec-odata-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'ONEC_BASE_URL=<значение ONEC_BASE_URL>' --env 'ONEC_USERNAME=<значение ONEC_USERNAME>' --env 'ONEC_PASSWORD=<ваш ONEC_PASSWORD>' onec-odata-mcp -- npx -y onec-odata-mcp@1.1.2

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"onec-odata-mcp","type":"stdio","command":"npx","args":["-y","onec-odata-mcp@1.1.2"],"env":{"ONEC_BASE_URL":"<значение ONEC_BASE_URL>","ONEC_USERNAME":"<значение ONEC_USERNAME>","ONEC_PASSWORD":"<ваш ONEC_PASSWORD>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "onec-odata-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add onec-odata-mcp --env 'ONEC_BASE_URL=<значение ONEC_BASE_URL>' --env 'ONEC_USERNAME=<значение ONEC_USERNAME>' --env 'ONEC_PASSWORD=<ваш ONEC_PASSWORD>' -- npx -y onec-odata-mcp@1.1.2

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.onec-odata-mcp]
command = "npx"
args = ["-y", "onec-odata-mcp@1.1.2"]
env = { ONEC_BASE_URL = "<значение ONEC_BASE_URL>", ONEC_USERNAME = "<значение ONEC_USERNAME>", ONEC_PASSWORD = "<ваш ONEC_PASSWORD>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "onec-odata-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "environment": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "onec-odata-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp@1.1.2"
      ],
      "env": {
        "ONEC_BASE_URL": "<значение ONEC_BASE_URL>",
        "ONEC_USERNAME": "<значение ONEC_USERNAME>",
        "ONEC_PASSWORD": "<ваш ONEC_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ONEC_BASE_URLобязательная
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAMEобязательная
Basic auth username for the OData endpoint
ONEC_PASSWORDсекрет, обязательная
Basic auth password for the OData endpoint
ONEC_DATABASEнеобязательная
Optional database name hint
ONEC_METADATA_CACHE_TTL_MSнеобязательная
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATHнеобязательная
Optional path to JSON config file ({ baseUrl, username, password })

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 97a7f25.

Текст для агента

Опубликуй стандартный OData-интерфейс в базе 1С, затем выполни claude mcp add onec-odata -e ONEC_BASE_URL=https://1c.example.com/base/odata/standard.odata -e ONEC_USERNAME=user -e ONEC_PASSWORD=пароль -- npx -y onec-odata-mcp.

Другие способы из описания автора
claude mcp add onec-odata -e ONEC_BASE_URL=https://1c.example.com/your_db/odata/standard.odata -e ONEC_USERNAME=odata_user -e ONEC_PASSWORD=your_password -- npx -y onec-odata-mcp

Команда из README проекта для добавления сервера в Claude Code.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключается к опубликованному в 1С стандартному интерфейсу OData и переводит вопросы на естественном языке в запросы к справочникам и документам. Работает с любой конфигурацией, где включен OData: Бухгалтерия, ERP, Управление торговлей или самописные решения. По умолчанию доступ только на чтение, запись включается явно переменной ONEC_WRITABLE. Есть кеш метаданных с настраиваемым TTL и переменная ONEC_DATABASE для подсказки имени базы, если их несколько.

Для кого. Для 1С-разработчиков и аналитиков, которым нужен быстрый доступ на чтение к данным 1С из Claude без настройки отдельного MCP-сервера с нуля.

Подходит, если

  • В конфигурации уже опубликован стандартный OData-интерфейс
  • Нужен быстрый структурированный доступ к справочникам и документам вместо выгрузки в Excel
  • Достаточно готового npm-пакета без сборки из исходников

Не подходит, если

  • OData не опубликован в базе и публиковать его нельзя
  • Нужна запись в базу: по умолчанию сервер только читает, запись включается отдельно и не для всех сценариев тестировалась

Пример запроса к агенту

Покажи все документы реализации за прошлую неделю с суммой больше 100000 рублей через OData 1С

Ограничения

Нужен опубликованный стандартный OData-интерфейс 1С, логин и пароль пользователя. README отмечает, что скриншот или видео пятиминутной настройки еще не добавлены, часть примеров помечена как TODO. Запись включается флагом ONEC_WRITABLE и требует аккуратной проверки прав пользователя, от имени которого работает сервер.

Как отключить. Удалите сервер командой claude mcp remove onec-odata или уберите запись onec-odata из claude_desktop_config.json.

MCP

Транспорт
stdio
Авторизация
не нужна
Переменные окружения
ONEC_BASE_URL
обязательная		URL опубликованного OData-интерфейса базы 1С.
ONEC_USERNAME
обязательная		Логин пользователя 1С для OData.
ONEC_PASSWORD
обязательная, секрет		Пароль пользователя 1С для OData.
ONEC_DATABASE
Подсказка имени базы, если их несколько.
ONEC_METADATA_CACHE_TTL_MS
TTL кеша метаданных в миллисекундах, по умолчанию час.
ONEC_WRITABLE
Включает запись в базу, по умолчанию сервер только читает.

Проверка безопасности

  • По умолчанию только читает данные 1С, но запись включается флагом ONEC_WRITABLE
  • Пароль пользователя 1С передается в переменных окружения MCP-клиента

Коротко о README

README сразу заявляет цель: подключить 1С к Claude за пять минут через стандартный OData вместо ручных URL и выгрузок в Excel. Даны два способа подключения: командой claude mcp add и вручную в claude_desktop_config.json, обязательные переменные ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD и опциональные ONEC_DATABASE, ONEC_METADATA_CACHE_TTL_MS, ONEC_WRITABLE.

Частые вопросы

Нужно ли что-то ставить локально?

Нет, npx подтягивает пакет при первом запуске, сборка из исходников нужна только для разработки.

Можно ли писать в базу?

По умолчанию нет, сервер только читает. Запись включается переменной ONEC_WRITABLE.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний рискБез VPN292,5 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск271,4 тыс.
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний рискБез VPN139,3 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Официальный

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,6 тыс.
Foxx AI1С через OData: MCP-сервер на чтение

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.