API и MCP — Mivorli

API и MCP для разработчиков

Доски Mivorli можно читать и менять из своих программ и из AI-агентов (Claude, Cursor и других, которые умеют MCP). Всё, что делает программа, участники доски видят сразу, а правки попадают в историю доски — их можно отменить.

1. Токен

Страница досок → аватар → «Профиль» → «API и MCP» → «Создать токен». Токен даёт те же права на доски, что и у вас; «Только чтение» ничего не меняет. Отозвать токен можно там же.

2. MCP — для AI-агентов

Адрес MCP-сервера (Streamable HTTP): https://mivorli.com/mcp, заголовок Authorization: Bearer mvl_…. Пример настройки клиента:

{
  "mcpServers": {
    "mivorli": {
      "type": "http",
      "url": "https://mivorli.com/mcp",
      "headers": { "Authorization": "Bearer mvl_ВАШ_ТОКЕН" }
    }
  }
}

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

list_boards	доски, к которым есть доступ
read_board	содержимое доски: стикеры, тексты, фигуры, фреймы, линии, карточки, таблицы, комментарии
search_board	поиск объектов по тексту
create_sticky_notes	добавить стикеры (без координат — сеткой справа от содержимого)
create_items	любые объекты: note, text, frame, card, rect, ellipse, diamond… и connector (from, to)
update_item	текст, положение, размер, цвет
delete_items	удалить объекты

3. REST API

Базовый адрес https://mivorli.com/api/v1, ответы — JSON.

curl -H "Authorization: Bearer mvl_…" https://mivorli.com/api/v1/boards

curl -H "Authorization: Bearer mvl_…" https://mivorli.com/api/v1/boards/ID_ДОСКИ/items?type=note

curl -X POST -H "Authorization: Bearer mvl_…" -H "Content-Type: application/json" \
  -d '{"items":[{"type":"note","text":"Идея","color":"yellow"},{"type":"rect","text":"Шаг 1","x":0,"y":300}]}' \
  https://mivorli.com/api/v1/boards/ID_ДОСКИ/items

curl -X PATCH -H "Authorization: Bearer mvl_…" -H "Content-Type: application/json" \
  -d '{"text":"Новый текст","color":"green"}' https://mivorli.com/api/v1/boards/ID_ДОСКИ/items/ID_ОБЪЕКТА

curl -X DELETE -H "Authorization: Bearer mvl_…" https://mivorli.com/api/v1/boards/ID_ДОСКИ/items/ID_ОБЪЕКТА

GET /me	владелец токена и права токена
GET /boards	список досок
GET /boards/:id	сведения о доске
GET /boards/:id/items	объекты (необязательно `?type=`)
POST /boards/:id/items	добавить объект или `{"items":[…]}` — до 200 за раз
GET / PATCH / DELETE /boards/:id/items/:item	один объект: прочитать, изменить (text, title, x, y, w, h, color), удалить

Цвета: yellow, orange, red, pink, violet, blue, cyan, teal, green, lime, gray, white или #rrggbb. Ограничение — 600 запросов в минуту на человека.

К доскам · Состояние сервиса