1C OData MCP

Name: 1C OData MCP
Author: pyrfor

제작자: pyrfor버전 1.0.1i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.alexgrebeshok-coder/onec-odata-mcp

설치

개요

제작자가 쓴 설명(영어 원문)

Read-only MCP server for 1C:Enterprise via OData with metadata and query builder tools.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 0개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i아직 측정 안 함★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 기타
입력해야 할 값: ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 0개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
직접 입력할 값: ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD, ONEC_DATABASE, ONEC_METADATA_CACHE_TTL_MS, ONEC_CONFIG_PATH

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

{
  "mcpServers": {
    "onec-odata": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp"
      ],
      "env": {
        "ONEC_BASE_URL": "your-value",
        "ONEC_USERNAME": "your-value",
        "ONEC_PASSWORD": "your-value",
        "ONEC_DATABASE": "your-value",
        "ONEC_METADATA_CACHE_TTL_MS": "your-value",
        "ONEC_CONFIG_PATH": "your-value"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

claude mcp add onec-odata --env ONEC_BASE_URL=your-value --env ONEC_USERNAME=your-value --env ONEC_PASSWORD=your-value --env ONEC_DATABASE=your-value --env ONEC_METADATA_CACHE_TTL_MS=your-value --env ONEC_CONFIG_PATH=your-value -- npx -y onec-odata-mcp

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

{
  "mcpServers": {
    "onec-odata": {
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp"
      ],
      "env": {
        "ONEC_BASE_URL": "your-value",
        "ONEC_USERNAME": "your-value",
        "ONEC_PASSWORD": "your-value",
        "ONEC_DATABASE": "your-value",
        "ONEC_METADATA_CACHE_TTL_MS": "your-value",
        "ONEC_CONFIG_PATH": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

{
  "servers": {
    "onec-odata": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "onec-odata-mcp"
      ],
      "env": {
        "ONEC_BASE_URL": "your-value",
        "ONEC_USERNAME": "your-value",
        "ONEC_PASSWORD": "your-value",
        "ONEC_DATABASE": "your-value",
        "ONEC_METADATA_CACHE_TTL_MS": "your-value",
        "ONEC_CONFIG_PATH": "your-value"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

ONEC_BASE_URL 필수 env
1C OData endpoint URL (e.g. https://host/db/odata/standard.odata)
ONEC_USERNAME 필수 env
Basic auth username for the OData endpoint
ONEC_PASSWORD 비밀 필수 env
Basic auth password for the OData endpoint
ONEC_DATABASE env
Optional database name hint
ONEC_METADATA_CACHE_TTL_MS env
Metadata cache TTL in milliseconds (default 3600000)
ONEC_CONFIG_PATH env
Optional path to JSON config file ({ baseUrl, username, password })

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 7일 점검

! 주의
제작자와 저장소 일치
게시자(alexgrebeshok-coder)가 저장소 소유자(pyrfor)가 아니에요. 다른 사람이 등록했을 수 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 18326개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 18326개 중 15%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 18326개 중 25%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

1C OData MCP, 안전한가요?

해당하는 기본 점검 1개 중 0개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: ONEC_BASE_URL, ONEC_USERNAME, ONEC_PASSWORD

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.0.1)은 4개월 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Signoff

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트

설치

Remote Desktop Commander

제작자: desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

클라우드에서 실행★ 211그저께 업데이트

설치

Signoff

제작자: ayuanxx-max

Five gates that make an agent's 'done' provable: run them, read the verdict, audit the record.

내 컴퓨터에서 실행오늘 업데이트

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

onec-odata-mcp

Подключи 1С к Claude за 5 минут

Даёт Claude (Desktop, Code, любой MCP-клиент) доступ на чтение к базе 1С:Предприятие через стандартный OData. Вместо выгрузки в Excel или ручного написания OData-урлов — спрашиваешь по-русски, получаешь структурированные данные из справочников и документов.

Работает с любой конфигурацией 1С, где опубликован OData (Бухгалтерия, ERP, Управление торговлей, самописные конфигурации).

📸 TODO: скриншот/видео 5-минутной настройки — добавить после первого прогона с реальной базой.

Шаг 1 — установка

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

One-liner (after npm publish):

npx -y onec-odata-mcp

Set ONEC_BASE_URL, ONEC_USERNAME, and ONEC_PASSWORD in your MCP client config (see below).

From source:

npx -y onec-odata-mcp

(Для разработки из исходников: npm install && npm run build.)

Шаг 2 — подключи к Claude

Вариант А — командой `claude mcp add` (Claude Code):

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

Вариант Б — вручную в `claude_desktop_config.json` (Claude Desktop: Settings → Developer → Edit Config):

"mcpServers": { "onec-odata": { "command": "npx", "args": ["-y", "onec-odata-mcp"], "env": { "ONEC_BASE_URL": "https://1c.example.com/your_db/odata/standard.odata", "ONEC_USERNAME": "odata_user", "ONEC_PASSWORD": "your_password" } } } }

Готовый сниппет лежит в examples/claude_desktop_config.json.

Опционально: ONEC_DATABASE (подсказка имени базы), ONEC_METADATA_CACHE_TTL_MS (TTL кэша метаданных, по умолчанию 1 час), ONEC_WRITABLE=true (разрешить реальную запись через odata_write; по умолчанию false). Либо вместо переменных окружения — JSON-файл ~/.onec-odata/onec-config.json с полями baseUrl, username, password (и опционально "writable": true), путь к которому задаётся через ONEC_CONFIG_PATH.

Шаг 3 — первый запрос

Перезапусти Claude и спроси:

«Какие справочники и документы есть в базе 1С?»

Claude вызовет odata_list_entities, увидит список и дальше сам подберёт нужные инструменты под конкретный вопрос — без знания синтаксиса OData с твоей стороны.

Больше готовых промптов — в examples/prompts.md.

Инструменты

Инструмент	Что делает	Пример вопроса
`odata_config`	Проверяет статус подключения и настройки	«Проверь, подключена ли 1С»
`odata_list_entities`	Список всех доступных OData-сущностей	«Какие справочники и документы есть в базе?»
`odata_metadata`	Типы и наборы сущностей из `$metadata` (кэш, TTL 1ч)	вызывается автоматически перед сложными запросами
`odata_explain_entity`	Поля, типы, ключи, связи конкретной сущности	«Какие поля у справочника Контрагенты?»
`odata_build_query`	Строит и проверяет `$filter`/`$select`/`$orderby` из структурированных параметров запроса	вызывается автоматически — Claude сам переводит «за июнь» в даты, тул собирает и валидирует фильтр
`odata_query`	Запрос к сущности с готовыми OData-параметрами	«Покажи остатки по счёту 51 за июнь»
`odata_count`	Количество записей, опционально с фильтром	«Сколько контрагентов зарегистрировано в этом году?»
`odata_write`	Создание/изменение/удаление сущности (POST/PATCH/DELETE)	«Создай контрагента…» — сначала dry-run-превью
`odata_financial_summary`	Автообнаружение типовых финансовых сущностей + счётчики	«Дай сводку по счетам, реализациям и контрагентам»

Обычно агент сам комбинирует odata_build_query → odata_query/odata_count, тебе достаточно спросить своими словами.

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

По умолчанию только чтение. Флаг writable в конфиге базы (env ONEC_WRITABLE=true / "writable": true в ~/.onec-odata/onec-config.json) по умолчанию false. Без него реальные POST/PATCH/DELETE не уходят в 1С.
Запись — только через `odata_write`. У инструмента dryRun по умолчанию true: всегда сначала превью {dryRun: true, wouldExecute: …} без сетевого вызова. Реальная запись требует и writable: true на этой базе, и явного dryRun: false.
Пароль передаётся Basic Auth (base64 в заголовке каждого запроса — как требует OData) и хранится либо в env-переменных конфига твоего MCP-клиента (рекомендуется), либо в локальном файле ~/.onec-odata/onec-config.json. Сервер не логирует и не возвращает пароль в ответах инструментов.
Поля-секреты (password, token, apikey, secret и т.п. в названиях) автоматически исключены из подсказок «возможно, вы имели в виду» (src/query/fuzzy.ts), чтобы агент не подсвечивал их случайно.
Рекомендация: заведи в 1С отдельного OData-пользователя с ролью только на чтение для обычной работы; writable-учётку и ONEC_WRITABLE=true включай только осознанно.

Требования

Node.js ≥ 18
1С:Предприятие с опубликованным OData-интерфейсом (веб-публикация → standard.odata)

Разработка

npm install

npm run build # type-check + сборка в dist/ npm test

Детали и правила вклада — в CONTRIBUTING.md.

License

MIT

English (short)

MCP server giving Claude (or any MCP client) access to a 1C:Enterprise database via its standard OData endpoint. Read-only by default (writable: false); writes go through odata_write and always dry-run first unless you explicitly enable writable: true and pass dryRun: false. No spreadsheet exports, no hand-written OData URLs — ask in natural language, get structured data from catalogs and documents.

npx -y onec-odata-mcp

Configure via ONEC_BASE_URL / ONEC_USERNAME / ONEC_PASSWORD env vars (see the Russian quick-start above for claude mcp add and claude_desktop_config.json snippets — the JSON is language-agnostic). Optional: ONEC_WRITABLE=true to allow real writes. Published on npm as onec-odata-mcp and listed in the official MCP Registry as io.github.alexgrebeshok-coder/onec-odata-mcp.

1C OData MCP

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

기타 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Spec Driven Development

Remote Desktop Commander

Signoff

제작자의 README

onec-odata-mcp

Подключи 1С к Claude за 5 минут

Шаг 1 — установка

Шаг 2 — подключи к Claude

Шаг 3 — первый запрос

Инструменты

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

Требования

Разработка

License

English (short)