OneScan OneScan

Агент сам отправляет документы в OneScan

MCP — это способ дать AI-агенту инструменты вашего сервиса. Агент в Cursor, Claude или другой программе подключается к https://onescan.by/mcp и работает с документами одной организации.

Токен тот же, что у внешней обработки 1С. Отдельный ключ и отдельный тариф не нужны: канал «API 1С».

30 документов в месяц, без карты

ООО «ПК-АДМИН», Минск. Тарифы в BYN. 30 документов бесплатно.

Агент
onescan.by/mcp

Загрузи чек и подготовь к выгрузке в 1С

upload_document чек.pdf
Чек СККО
№ 1842
готов
УНП191234567
РН СККО123456789
Итого18,40 BYN

get_document вернул поля, обработка 1С может забрать документ

Что умеет агент

Это те же операции, что у API для 1С. Агент не видит чужие организации: токен привязан к одной.

Как подключить

  1. 1 В кабинете OneScan откройте организацию и скопируйте API-токен.
  2. 2 В настройках агента добавьте удалённый MCP: адрес https://onescan.by/mcp.
  3. 3 В заголовок Authorization передайте Bearer и токен организации.
  4. 4 Попросите агента загрузить документ и дождаться статуса «Готов».

Распознавание идёт в очереди. Загрузка сразу возвращает номер документа, готовые поля агент забирает отдельным запросом. Подробности — в кабинете, раздел «MCP для агентов».

Примеры подключения

Cursor

Настройки Cursor → MCP, либо файл .cursor/mcp.json в проекте.

{
  "mcpServers": {
    "onescan": {
      "url": "https://onescan.by/mcp",
      "headers": {
        "Authorization": "Bearer <api_token>"
      }
    }
  }
}

Claude

В Claude откройте Customize → Connectors → Add custom connector. Адрес: https://onescan.by/mcp. Аутентификация: без входа. В Request headers имя Authorization, значение — строка ниже. Если блока Request headers нет, на этом аккаунте он ещё недоступен: подключите сервер через Claude Code одной командой.

Authorization: Bearer <api_token>

claude mcp add --transport http onescan https://onescan.by/mcp --header "Authorization: Bearer <api_token>"

VS Code

Файл .vscode/mcp.json или команда «MCP: Open User Configuration». При первом запуске VS Code спросит токен и подставит его в заголовок. Вводить нужно сам токен, без слова Bearer.

{
  "servers": {
    "onescan": {
      "type": "http",
      "url": "https://onescan.by/mcp",
      "headers": {
        "Authorization": "Bearer ${input:onescan-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "onescan-token",
      "description": "API-токен организации OneScan",
      "password": true
    }
  ]
}

Вместо <api_token> подставьте API-токен организации из кабинета. Не сохраняйте файл с токеном в общий репозиторий.

Кому это нужно

Чем MCP отличается от API

API для 1С — это адреса, которые вызывает обработка. MCP — те же действия, но в виде инструментов, которые агент выбирает сам.

Обработку 1С менять не нужно. Агент пользуется тем же токеном и той же квотой.

Сколько стоит

Отдельной платы за MCP нет. Документ списывается с той же месячной квоты, что загрузка через API. На Free можно прогнать до 30 документов.

Все тарифы на главной

Free

0 BYN

в месяц

Стартовый тариф

  • ✓30 документов / мес
  • ✓1 орг.
  • ✓Веб-интерфейс
  • ✓API 1С
Попробовать бесплатно
Популярный

Pro

59 BYN

в месяц

Для малого бизнеса

  • ✓100 документов / мес
  • ✓5 орг.
  • ✓Веб-интерфейс
  • ✓Почта (входящие документы)
  • ✓API 1С
  • ✓Telegram-бот
Выбрать

Business

199 BYN

в месяц

Безлимит и все каналы

  • ✓1 000 документов / мес
  • ✓100 орг.
  • ✓Веб-интерфейс
  • ✓Почта (входящие документы)
  • ✓Telegram-бот
  • ✓API 1С
  • ✓Приложение для телефона
  • ✓Приложение для ПК
Выбрать

Ultra

599 BYN

в месяц

  • ✓10 000 документов / мес
  • ✓∞ организаций
  • ✓Веб-интерфейс
  • ✓Почта (входящие документы)
  • ✓Telegram-бот
  • ✓Приложение для ПК
  • ✓Приложение для телефона
  • ✓API 1С
Выбрать

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

Нужен ли отдельный ключ для агента?

Нет. Берётся API-токен организации из кабинета, тот же, что для 1С.

Агент видит все наши организации?

Нет. Токен открывает только одну организацию. Для другой — другой токен и другое подключение.

Можно ли отправить PDF на 50 МБ?

Да, до 50 МБ на файл после распаковки. В аргумент агент кладёт содержимое в base64, поэтому настройка клиента должна пропускать такой объём.

Документ распознаётся сразу в ответе?

Нет. Сначала возвращается номер и статус. Когда статус станет «Готов», агент читает карточку документа.

Где посмотреть точные имена инструментов?

В кабинете: Документация → MCP для агентов. Там адрес, заголовок и список из восьми инструментов.

Ещё по теме

Попробуйте на своих документах

Попробовать бесплатно

30 документов в месяц, без карты

Войти