Документация
Подключение 1С к AI через Contexis
Пошаговое руководство: от установки расширения в 1С до работающей интеграции с Claude, Cursor и другими MCP-клиентами.
Обзор
Что делает Contexis
Contexis превращает опубликованную базу 1С в готовый MCP-сервис. AI-клиент получает каталог инструментов — запросы остатков, документов, отчётов и операций — без разработки собственного MCP-сервера.
Цепочка подключения
Быстрый старт
Три шага до работающей интеграции
Установите расширение в 1С
Скачайте расширение contexis.cfe и подключите его к базе через «Администрирование → Печатные формы, отчёты и обработки → Расширения конфигурации». Основная конфигурация не меняется.
Скачать contexis.cfeОпубликуйте базу и добавьте её в Contexis
Опубликуйте HTTP-сервис 1С в локальной сети или через VPN. В личном кабинете Contexis укажите URL базы — система создаст MCP-сервис и каталог инструментов автоматически.
Подключите AI-клиент
Скопируйте готовую MCP-конфигурацию из личного кабинета и вставьте её в Claude Desktop, Cursor или другой MCP-совместимый клиент.
1С
Публикация базы 1С
Contexis подключается к уже опубликованному HTTP-сервису. Убедитесь, что база доступна из сети, где размещён Contexis.
Требования
- HTTP-сервис 1С с опубликованным REST API
- Доступ к базе из сети, где работает Contexis
- Учётная запись с правами, достаточными для выбранных инструментов
- TLS при доступе через интернет (рекомендуется reverse proxy)
MCP-сервис
Создание и управление сервисом
После добавления URL базы Contexis автоматически обнаруживает доступные инструменты и формирует MCP-эндпоинт.
{
"mcpServers": {
"contexis-1c": {
"url": "https://hub.contexis.io/mcp/your-service-id",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Актуальный конфиг и API-ключ доступны в личном кабинете после создания MCP-сервиса.
AI-клиенты
Подключение Claude, Cursor и ChatGPT
Скопируйте конфигурацию из Contexis и добавьте её в настройки вашего AI-клиента.
~/Library/Application Support/Claude/claude_desktop_config.json
macOS и Windows. Конфигурация MCP добавляется в секцию mcpServers.
Settings → MCP → Add server
Вставьте JSON-конфигурацию из личного кабинета Contexis или укажите URL сервера.
Custom MCP connector
Поддерживается на тарифах Start и Enterprise. Используйте endpoint и ключ из Contexis.
Инструменты
Управление доступными операциями
Каждый инструмент — отдельная операция над данными 1С. Включайте только то, что нужно конкретной команде или сценарию.
- Включайте только те инструменты, которые нужны конкретной роли
- Разделяйте read-only и write-операции между разными MCP-сервисами
- Назначайте Owner, Admin и Manager для контроля доступа команды
- Следите за логами вызовов и лимитами тарифа в панели мониторинга
Безопасность
Контроль доступа к данным 1С
Принципы
- Учётные данные 1С не передаются в LLM
- ИИ видит только явно разрешённые инструменты
- Каждый вызов проходит через Contexis с аудитом
- Лимиты запросов настраиваются на уровне сервиса и пользователя
Рекомендуем начать с read-only инструментов и расширять набор операций после проверки сценариев с командой.
Возможности платформыFAQ
Частые вопросы
Нужно ли менять конфигурацию 1С?
Нет. Contexis работает через расширение конфигурации. Основная конфигурация остаётся без изменений и обновляется штатным образом.
Какие конфигурации 1С поддерживаются?
Любая конфигурация на платформе 1С:Предприятие 8.3 с возможностью публикации HTTP-сервиса: УТ, ERP, Бухгалтерия, ЗУП и другие.
Можно ли ограничить операции записи?
Да. В панели Contexis отключите write-инструменты или создайте отдельный MCP-сервис только с read-only операциями для аналитики.
Что делать, если AI-клиент не видит инструменты?
Перезапустите клиент после изменения конфигурации, проверьте доступность URL базы из сети Contexis и убедитесь, что сервис активен в личном кабинете.
Нужна помощь с подключением?
Напишите нам — поможем с расширением, публикацией базы и первым MCP-сервисом.