Frihet ERP

Frihet ERP — официальный MCP-сервер от Frihet-io. ERP Frihet: счета, предложения, расходы, клиенты, CRM, банк и налоговые сводки для Испании. Ставится через npx. Доступен и как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Frihet-io
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: high

ERP Frihet: счета, налоги Испании, банк, POS; внешние действия с confirm=true.

Настройка клиентов

codex
{
    "code": "codex mcp add frihet --env FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server",
    "lang": "bash",
    "verified": "docs"
}

Что умеет

frihet-mcp — MCP-сервер для Frihet, ERP-системы с ИИ для бизнеса любого размера. Сервер подключает ассистента к вашему рабочему пространству Frihet: можно спрашивать и создавать счета, расходы, клиентов, коммерческие предложения, банковские операции и налоговые сводки обычным языком. Каталог содержит 158 базовых операций, 5 налоговых псевдонимов и 10 подсказок. Локальный пакет отдаёт 11 ресурсов, размещённый сервер — 7.

Основные области:

  • Счета: создание (по умолчанию — черновик без фискального номера), отправка клиенту по почте, отметка об оплате, пени за просрочку, регулярные счета.
  • Расходы, клиенты и CRM: контакты, звонки, заметки, товары и услуги, коммерческие предложения.
  • Электронные счета: отправка в 11 форматах (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, UBL, CII), подача в FACe и TicketBAI, экспорт DATEV.
  • Налоги Испании: сводки по моделям 303, 130, 390 и 347, статус VeriFactu, налог IGIC для Канарских островов, налог на прибыль.
  • Банк: подключённые счета, транзакции, сопоставление платежей со счетами, правила автоматической категоризации.
  • Прочее: учёт времени, кадры и подготовка к расчёту зарплаты, POS-продажи, ресторанная кухня, посуточная аренда с синхронизацией с Airbnb и Booking.com, вебхуки, закрытие периода, работа бухгалтеров.

У каждой записи tools/list есть метаданные: пишет ли инструмент во Frihet и затрагивает ли внешний мир — почту клиента, вебхук, деньги или налоговую.

Кому подойдёт

Предпринимателям, фрилансерам и бухгалтерам, которые ведут учёт во Frihet, особенно в Испании и ЕС, и хотят выставлять счета и смотреть отчёты через агента. Нужен аккаунт Frihet: один ключ API соответствует одному рабочему пространству. Похожие серверы — в категории финансы.

Установка

Проще всего добавить размещённый сервер https://mcp.frihet.io/mcp в клиент с поддержкой OAuth и войти через браузер. Ничего ставить и копировать не нужно. Для локального запуска нужен Node.js (22.23.4+, 24.22.1+ или 26.12.1+) и ключ API: app.frihet.io → Settings → API → Create API key. Ключ начинается с fri_ и показывается один раз. Без аккаунта можно попробовать демо-режим FRIHET_DEMO=1 npx -y @frihet/mcp-server: он отвечает на примерах, ничего не сохраняет и не ходит в сеть. Сервер не распознаёт документы — бумажные счета сначала нужно оцифровать.

Подключение к клиентам

Конфигурации из README. Подробнее — в инструкции как подключить MCP.

claude mcp add frihet -s user -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server
claude mcp list          # verify: frihet ✓ Connected

README приводит JSON для Claude Desktop, Cursor (.cursor/mcp.json), Windsurf и Cline. Для Codex используйте команду: JSON-блок в ~/.codex/config.toml сломает файл. Размещённый сервер в Claude Code подключается командой claude mcp add --transport http frihet https://mcp.frihet.io/mcp.

Как устроена оплата

Сервер не проводит платежи сам. Он работает с учётными записями о деньгах: mark_invoice_paid отмечает счёт оплаченным, match_transaction_to_invoice связывает банковскую транзакцию со счётом, refund_deposit записывает возврат депозита в учёт с confirm=true и не переводит деньги. refund_sale оформляет возврат по POS-продаже. Отправка счёта клиенту (send_invoice), подача в налоговые органы и запуск регулярного счёта (run_recurring_now) требуют confirm=true. Лимиты запросов зависят от тарифа Frihet.

Проверка

После claude mcp list должно быть frihet ✓ Connected. Попросите агента вызвать get_business_context — он вернёт профиль, тариф и недавнюю активность.

Примеры задач

Покажи все неоплаченные счета и составь напоминания по просроченным.
Подготовь сводку по IVA за квартал (модель 303) и отчёт о прибылях и убытках за месяц.

Риски

  • Внешние последствия. Некоторые инструменты отправляют письма клиентам, подают данные в налоговые органы и вызывают вебхуки. Подтверждайте confirm=true только после проверки.
  • Деньги и возвраты. refund_sale и операции со счетами меняют финансовый учёт.
  • Удаление. Можно удалять клиентов, расходы, товары и черновики. Отправленные и оплаченные счета не удаляются, а отменяются.
  • Ключ API даёт доступ ко всему рабочему пространству — храните его в переменной окружения.

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

Можно ли попробовать без аккаунта?

Да, демо-режим FRIHET_DEMO=1 работает на примерах и ничего не сохраняет.

Отправит ли агент счёт сам?

Новые счета создаются черновиками, а отправка требует confirm=true.

Распознаёт ли сервер сканы счетов?

Нет, OCR и загрузки файлов нет.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

1C MCP Toolkit

MCP и REST API сервер для баз 1С во внешней обработке: запросы, метаданные, журнал, справка BSL и выполнение кода.

Риск: high Лицензия: GPL-3.0 ★ 371

MCP BSL Platform Context

MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.

Риск: medium Лицензия: MIT ★ 209

Источники