Как устроена доска

Для чего эта доска

Бесконечный холст, рассчитанный на работу вдвоём с ИИ-агентом: вы раскладываете материал руками, агент читает разложенное и дописывает своё. Отсюда две особенности, которые определяют всё остальное в этой документации.

Первая — доска читается агентом целиком, а не как список объектов. Через MCP он видит вложенность (что лежит внутри области), соседство и цветовые группы, а коннектор ведёт к конкретной строке таблицы, а не к таблице вообще. Поэтому положить на холст требования и сказать «сделай по ним» дешевле, чем пересказывать их в чате.

Вторая — доска живёт без вашей вкладки. Содержимое держит хранилище PRONA, и агент пишет на доску, пока вы заняты другим. Своё хранилище подключают, когда упираются в лимиты бесплатного или когда данные обязаны лежать только у себя, — см. Варианты хранения.

Командная работа — не про эту доску: ролей, прав доступа и истории версий здесь нет, они есть в платформе PRONA, где доска связана с задачами, документами и перепиской проекта.

Что кладут на доску

Доска принимает разные форматы — от короткой заметки до многостраничного документа со схемами. Всё это одинаково доступно человеку (панель инструментов и меню по правой кнопке) и агенту через MCP.

Модель данных

Всё, что делает агент и человек, сводится к четырём сущностям. Содержимое — общий CRDT-документ: правки агента и команды сливаются без конфликтов.

Быстрый старт

От пустого холста до доски, которую ведёт агент. Про хранилище думать не надо: доски с первой минуты пишутся в хранилище PRONA, поэтому агент работает и при закрытой вкладке.

Подключение по MCP

Доски отдаются агенту как удалённый MCP-сервер (streamable HTTP). Конфигурация одинакова для любого клиента, поддерживающего Model Context Protocol — Claude Code, Cursor и других. Готовый сниппет с вашим токеном выдаёт кнопка «Настроить MCP» на главной.

{
  "mcpServers": {
    "prona-board": {
      "type": "http",
      "url": "https://board-mcp.prona.space/mcp",
      "headers": { "Authorization": "Bearer <токен пространства>" }
    }
  }
}

Инструменты MCP

Отдельного «языка разметки» учить не нужно — агент вызывает инструменты как обычные функции, а правила ведения доски сервер отдаёт ему сам (промпт board_task_workflow).

Варианты хранения

По умолчанию доски хранятся у PRONA: снимок доски и десять последних версий лежат на серверах сервиса. Скажем прямо: содержимое там не шифруется — технически операторы PRONA могут его прочитать. Если это не подходит или вы упёрлись в лимиты бесплатного хранения, подключите своё облако мастером «Подключить хранилище» на главной: тогда снапшоты пишутся к вам, а у PRONA остаются только зашифрованные ключи доступа.

Хранилище PRONA

Подключать его не надо и отказаться нельзя: пространство досок регистрируется в хранилище PRONA при первом заходе на главную, дальше снимки уходят туда сами. За это вы получаете три вещи: доска переживает чистку данных браузера и смену устройства (в пределах ключа пространства), гостевые ссылки открываются круглосуточно, а ИИ-агент по MCP пишет на доску, даже когда ваша вкладка закрыта.

Supabase

Самый быстрый вариант: бесплатный проект создаётся за две минуты, из настроек нужны два значения. Мастер сам создаст приватный бакет prona-board и проверит доступ.

Project URL       = https://abcdefgh.supabase.co
service_role      = eyJhbGciOi••••••••

S3-совместимое хранилище

Подходит любой сервис с S3 API: AWS S3, Cloudflare R2, Yandex Object Storage, MinIO в собственном контуре. Снапшоты пишет коннектор со стороны сервера, поэтому настраивать CORS на бакете не нужно.

endpoint    = https://storage.yandexcloud.net
region      = ru-central1
bucket      = prona-boards
access_key  = YCAJE••••••••
secret_key  = ••••••••••••

Ключу достаточно прав на объекты этого бакета:

s3:GetObject  s3:PutObject  s3:DeleteObject  s3:ListBucket

GitHub

Доски хранятся в приватном репозитории — рядом с кодом, который они описывают. Каждое сохранение становится коммитом, поэтому история доски читается через git log.

boards/
├── 8f2c41…d4e1.pronaboard
└── 1a9b02…77c3.pronaboard
registry.pronaboard

Подключение — по fine-grained токену с правом «Contents: Read and write» только на этот репозиторий. Создайте отдельный приватный репозиторий под доски, чтобы токен не касался кода.

Перенос и восстановление

При подключении своего хранилища мастер сам выполняет первичную синхронизацию: все доски, которые сейчас есть у вас — в хранилище PRONA и в кэше браузера, — копируются в ваше хранилище, дальше снапшоты идут туда автоматически.

Формат .pronaboard

Один файл — вся доска. Внутри — сигнатура и CRDT-состояние (Yjs-документ): формат одинаков для экспорта из меню, снапшотов в хранилище и открытия кнопкой «Открыть файл .pronaboard». Лимит — 64 МБ.

PRONABOARD1\n   ← сигнатура формата (12 байт)
<Yjs update>     ← полное состояние доски одним CRDT-обновлением

CRDT-состояние самодостаточно: файл можно открыть в любом браузере, слить с более старой копией без потерь и продолжить работу — история правок сходится автоматически.

Доступ и безопасность

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