Вкратце
Коммерческий hosted MCP-сервер для интеграции AI-агентов с 1С:Предприятие 8 (Бухгалтерия, УТ, ЗУП, КА). Read/write через OData + REST. SaaS или on-premise.
Источник данных: 1С:Предприятие 8 . Atomno Labs не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-1c-bridge": {
"command": "uvx",
"args": ["atomno-mcp-1c-bridge"],
"env": {
"MCP_1C_BRIDGE_API_KEY": "<your-value>",
"MCP_1C_BRIDGE_BASE_URL": "<your-value>"
}
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-1c-bridge": {
"command": "uvx",
"args": ["atomno-mcp-1c-bridge"],
"env": {
"MCP_1C_BRIDGE_API_KEY": "<your-value>",
"MCP_1C_BRIDGE_BASE_URL": "<your-value>"
}
}
}
} В терминале (Claude Code CLI):
claude mcp add atomno-1c-bridge -- uvx atomno-mcp-1c-bridge -e MCP_1C_BRIDGE_API_KEY=<your-value> -e MCP_1C_BRIDGE_BASE_URL=<your-value>
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-1c-bridge": {
"command": "uvx",
"args": ["atomno-mcp-1c-bridge"],
"env": {
"MCP_1C_BRIDGE_API_KEY": "<your-value>",
"MCP_1C_BRIDGE_BASE_URL": "<your-value>"
}
}
}
} Конфигурация (env vars)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_1C_BRIDGE_API_KEY | API key Atomno Labs hosted MCP | Sales-команда (после demo) | yes | — |
| MCP_1C_BRIDGE_BASE_URL | URL базы 1С (OData endpoint) | IT-отдел клиента | yes | — |
| MCP_1C_BRIDGE_LOG_LEVEL | Уровень логирования | — | no | INFO |
Тулзы MCP-сервера
Сервер регистрирует 4 тула для AI-агента. Все валидируются через Pydantic v2.
list_catalog async tool Получить элементы справочника 1С.
catalog_name: str, filter?: dict list[CatalogItem] get_document async tool Получить документ по UUID/номеру.
doc_type: str, identifier: str Document create_document async tool Создать документ (read/write tier).
doc_type: str, data: dict Document query_register async tool Запрос к регистру (накопления / сведений).
register_name: str, filter?: dict, period?: str list[RegisterRecord] Pricing
Hosted SaaS, on-premise или enterprise-лицензия — выберите формат. Все тиры включают sandbox-доступ для отладки + production endpoint.
Hosted Read-only
Read-доступ к справочникам и документам. До 5K запросов/мес.
- Read-only access
- 5 000 запросов/мес
- 1 база 1С
- Email support
Hosted Read/Write
Полный read/write. До 20K запросов/мес. Аудит изменений.
- Read + write
- 20 000 запросов/мес
- До 5 баз 1С
- Audit log
- Telegram support
- Webhooks
On-premise / Enterprise
Установка в контур клиента. Без лимитов. Custom-разработка.
- Без лимитов
- Установка в контур
- Любое количество баз
- 24/7 phone support
- Custom-разработка
- SLA 99.95%
Примеры использования
Реальные prompt'ы для AI-агента в Cursor / Claude Code:
- list_catalog: «Используй mcp-1c-bridge тул
list_catalogи получить элементы справочника 1с.» - get_document: «Используй mcp-1c-bridge тул
get_documentи получить документ по uuid/номеру.» - create_document: «Используй mcp-1c-bridge тул
create_documentи создать документ (read/write tier).»
Troubleshooting
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
3. Ошибка авторизации (401 / 403)
Проверьте переменные окружения MCP_1C_BRIDGE_API_KEY, MCP_1C_BRIDGE_BASE_URL.
Они должны быть доступны в окружении процесса Cursor (часто требует перезапуска IDE
после установки переменных).
Полный troubleshooting-гайд → /docs/troubleshooting
FAQ
Как установить mcp-1c-bridge? +
Какой Python нужен? +
Что нужно настроить перед запуском? +
Это open-source? +
Где сообщить о баге? +
Запросить демо
mcp-1c-bridge — коммерческий hosted MCP. Sandbox-доступ для разработки бесплатный. Production-доступ — после демо и обсуждения нагрузки.
Changelog
Версия пока не опубликована — проект в active development. Полная история — GitHub Releases.
Source code & issues
- GitHub: atomno-labs/mcp-1c-bridge
- Issues: atomno-labs/mcp-1c-bridge/issues
- Discussions: atomno-labs/mcp-1c-bridge/discussions
Disclaimer
Atomno Labs не аффилирован с 1С:Предприятие 8. mcp-1c-bridge использует публичные / коммерческие интерфейсы провайдера. Ответственность за соблюдение лимитов и ToS провайдера — на пользователе. Лицензия: Commercial (Atomno Labs).