MCP-сервер: Claude и другие ассистенты

Как подключить Claude Desktop, Claude Code или другой MCP-клиент к вашему Rivo: финансы и нетворк по API-токену.

MCP-сервер Rivo даёт Claude Desktop, Claude Code или любому MCP-клиенту доступ к вашему дашборду: «покажи мои балансы», «добавь расход интернет 800», «найди лидов в статусе call».

Что нужно

  1. API-токен — Настройки → Доступ → API-токены, шаблон «MCP финблока» (финансы) или «MCP Нетворка» (контакты и лиды). Как выпускать — API-токены и OpenAPI.
  2. Сервер MCP — небольшая программа на Node.js, которая работает на вашем компьютере и ходит в Rivo по API. В комплект установки она не входит: запросите её на [email protected], затем один раз выполните npm install в её папке.

Подключение

Переменные окружения:

  • RIVO_API_URL — адрес вашего Rivo, например https://имя.me.rivo.day;
  • RIVO_TOKEN — API-токен ocd_….

Claude Code:

claude mcp add rivo-fin --scope user -e RIVO_API_URL=https://имя.me.rivo.day -e RIVO_TOKEN=ocd_… -- node /path/to/mcp/server.mjs

Claude Desktop — тот же запуск (node /path/to/mcp/server.mjs с двумя переменными) в разделе mcpServers файла claude_desktop_config.json, после правки перезапустите Claude.

Финансы (fin_*)

Нужны области fin:read и fin:write (шаблон «MCP финблока»).

  • счета, категории, сводка, прогноз, конверты и их расписание;
  • операции: расход или доход, перевод, обмен, отмена, сверка остатка;
  • обязательства: список, добавить, изменить, закрыть;
  • план платежей: провести или пропустить платёж, запустить генератор;
  • разбор фразы о деньгах («оплатил садик 300 лари»).

Счёт и категорию можно называть по имени. Повторный вызов не создаёт дубль; две одинаковые траты за день ассистент передаёт с разными ключами. Миграции, синхронизация банков и правка справочников токену закрыты.

Нетворк (net_*)

Нужна область crm (шаблон «MCP Нетворка»).

  • поиск лидов с фильтрами и счётчиками;
  • карточка лида целиком;
  • смена статуса воронки (new, written, replied, call, deal, no), заметка, теги.

Удалять лидов и править досье через MCP нельзя.

Прочее

Документы, задачи, календарь и ассистент доступны инструментам MCP, если у токена есть области docs, tasks, calendar, assistant. Без нужной области инструмент ответит «токену не хватает области…» — выпустите токен с ней.