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.
Настройка клиентов
{
"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 ✓ ConnectedREADME приводит 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 и выполнение кода.
MCP BSL Platform Context
MCP-сервер со справкой по синтаксису и объектной модели платформы 1С, без доступа к базе.
Spree Commerce: открытая платформа электронной коммерции для B2B и маркетплейсов
Открытая платформа электронной коммерции Spree для B2B и маркетплейсов.
Spree Commerce: документация для ИИ-агентов
Документация Spree Commerce для агентов-программистов.