API VEGA

ИИ-сервер MCP для управления бизнесом.

MCP-сервер с ИИ для управления бизнесом.

Совместим с Claude · ChatGPT · Cursor · Windsurf · Cline · Antigravity · Codex · Copilot · Gemini CLI — и любым клиентом, совместимым с MCP.

Распространение

КаналСтатусУстановка
npmРаботаетnpx @frihet/mcp-server
удалённая точка доступаРаботаетhttps://mcp.frihet.io/mcp (установка не требуется, OAuth или API-ключ)
SmitheryРаботаетsmithery.ai/servers/frihet/frihet-mcp
MCP RegistryРаботаетregistry.modelcontextprotocol.io
GlamaРаботаетglama.ai/mcp/servers/Frihet-io/frihet-mcp
mcp.soАвтоиндексация (непроверено)mcp.so — индексирует из npm + GitHub
PulseMCPАвтоиндексация (непроверено)pulsemcp.com — индексирует из npm + GitHub
Cursor MarketplaceСкоро доступноcursor.com/marketplace
ChatGPT AppsСкоро доступноchatgpt.com
Anthropic Claude DirectoryСкоро доступноclaude.ai/settings/connectors

Количество инструментов: пакет (1.16.5) включает все 157 инструментов, как и удалённый эндпойнт (mcp.frihet.io).

Что это

MCP-сервер, который соединяет вашего AI‑помощника с Frihet. Создавайте счета-фактуры в диалоге. Запрашивайте расходы на естественном языке. Управляйте всем бизнесом прямо из вашей IDE.

You:     "Create an invoice for TechStart SL, 40 hours of consulting at 75 EUR/hour, due March 1st"
Claude:  Done. Invoice INV-2026-089 created. Total: 3,000.00 EUR + 21% IVA = 3,630.00 EUR.

157 инструментов. 11 ресурсов. 10 подсказок. Для каждого инструмента — структурированный вывод. Без шаблонного кода.

Пробуйте прямо сейчас (без регистрации)

Попробуйте без настройки — без учётной записи, без API‑ключа:

FRIHET_DEMO=1 npx -y @frihet/mcp-server

В демо-режиме сервер отвечает на основе реалистичных примерных фикстур (используется Испанские счета-фактуры с IVA/IGIC, расходы, клиенты, продукты, банковский счёт и т.д.) — все записи имеют префикс demo_, на старте сервер выводит баннер DEMO MODE. Ничего не сохраняется, сетевые запросы не выполняются. Записи имитируются, а налоговые действия (e‑invoice, VeriFactu, TicketBAI, FACe, payroll) возвращают явно помеченную симуляцию — это не отправляется в налоговые органы.

Когда будете готовы к реальным данным, снимите флаг и добавьте ваш ключ (app.frihet.io → Settings → API keys). См. раздел Install ниже.

Установка

Однострочная установка (Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI и др.)

npx skills add Frihet-io/frihet-mcp

Плагин Claude Code (набор навыков + MCP‑сервер в одном установке)

Этот репозиторий также является плагином Claude Code (frihet-erp): установка собирает и бизнес‑управляющий навык, и MCP‑сервер.

# Попробовать локально
claude --plugin-dir /path/to/frihet-mcp

После того как плагин появится в Marketplace сообщества:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install frihet-erp@claude-community

Вызов навыка: /frihet-erp:frihet-mcp. Упакованный .mcp.json запускает @frihet/mcp-server через npx — укажите FRIHET_API_KEY в вашей среде (ключ можно получить на app.frihet.io → Settings → API keys).

Claude Code / Claude Desktop

{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["-y", "@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "fri_your_key_here"
      }
    }
  }
}
ИнструментФайл конфигурации
Claude Code~/.claude/mcp.json
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json
Cursor.cursor/mcp.json или ~/.cursor/mcp.json
Windsurf~/.windsurf/mcp.json
ClineVS Code settings or .cline/mcp.json
Codex CLI~/.codex/config.toml (MCP section)

JSON-конфигурация одинакова для всех инструментов. Путь к файлу отличается только.

Удалённо (без установки)

Используйте hosted endpoint на mcp.frihet.io — нулевые локальные зависимости, работает на Cloudflare Workers.

С API‑ключом:

{
  "mcpServers": {
    "frihet": {
      "type": "streamable-http",
      "url": "https://mcp.frihet.io/mcp",
      "headers": {
        "Authorization": "Bearer fri_your_key_here"
      }
    }
  }
}

С OAuth 2.0 + PKCE (браузерная аутентификация, API‑ключ не требуется):

Клиенты, поддерживающие OAuth (Claude Desktop, Smithery и т. д.), могут подключаться напрямую к https://mcp.frihet.io/mcp и аутентифицироваться через браузер. Сервер реализует полный поток авторизации OAuth 2.1 с PKCE.

Получить API‑ключ

  • Войдите в app.frihet.io

  • Перейдите в раздел Settings > API

  • Нажмите Create API key

  • Скопируйте ключ (начинается с fri_) — он отображается только один раз

Что можно делать

Говорите с вашим ERP. Это реальные запросы, а не маркетинговые тексты.

Инвойсы

"Show me all unpaid invoices"
"Create an invoice for Acme SL with 10h of consulting at 95/hour"
"Mark invoice abc123 as paid"
"How much has ClientName been invoiced this year?"

Расходы

"Log a 59.99 EUR expense for Adobe Creative Cloud, category: software, tax-deductible"
"List all expenses from January"
"What did I spend on travel last quarter?"

Клиенты

"Add a new client: TechStart SL, NIF B12345678, email admin@techstart.es"
"Show me all my clients"
"Update ClientName's address to Calle Mayor 1, Madrid 28001"

CRM

"Add a contact to Acme SL: Ana Garcia, CTO, ana@acme.es"
"Log a call with TechStart: discussed Q2 proposal, they're interested in upgrade"
"Add a note to ClientName: prefers invoices in English, payment NET 30"
"Show me all activities for Acme SL"

Коммерческие предложения (Quotes)

"Create a quote for Design Studio: logo design (2000 EUR) + brand guidelines (3500 EUR)"
"Show me all pending quotes"

Вебхуки

"Set up a webhook to notify https://my-app.com/hook when invoices are paid"
"List all my active webhooks"

Чего ожидать

Это MCP — структураированный интерфейс данных: вы описываете, чего хотите на естественном языке, и AI создаёт, извлекает или изменяет бизнес‑записи в Frihet. Большинство из 157 инструментов — CRUD‑операции над REST API; остальные — итоговые сводки и налоговые/электронные счета.

Подходит для:

"Create an invoice for TechStart SL, 40h consulting at 75 EUR/h"   --> creates the invoice
"Show unpaid invoices over 1,000 EUR"                               --> queries and filters
"Log a 120 EUR expense for the Madrid train, category: travel"      --> records the expense
"Update client Acme's email to billing@acme.es"                     --> modifies the record

Не делает:

  • OCR или сканирование PDF — загрузить изображение счёта и распознать текст нельзя

  • Загрузку файлов или работу с вложениями

  • Любую обработку изображений

Если нужно цифровать бумажные счета или квитанции, сначала извлеките данные (например, Claude Vision API, специализированный OCR-сервис или вручную) и затем используйте MCP для создания записи:

1. Сканируйте/фотографируйте счёт
2. Используйте Claude Vision: "Read this invoice image and extract the vendor, items, amounts, and dates"
3. Затем: "Create an expense in Frihet for [extracted data]"

Инструменты (157)

Инвойсы (12)

ИнструментЧто делает
list_invoicesСписок счетов с пагинацией
get_invoiceПолучить детальные данные счёта по ID
create_invoiceСоздать новый счет-фактуру с позиции
update_invoiceОбновить любое поле счёта
delete_invoiceБезвозвратно удалить счёт
search_invoicesНайти счета по названию клиента, дате или статусу
send_invoiceОтправить счет клиенту по электронной почте (PDF)
mark_invoice_paidПометить счёт как оплаченный с датой платежа (при желании)
get_invoice_pdfПолучить загрузочный URL для PDF счёта
get_invoice_einvoiceПолучить e‑invoice XML для заданного счёта
create_credit_noteСоздать кредит‑ноту к существующему счёту
apply_late_feeПрименить штраф за просрочку к просроченному счёту

Расходы (5)

ИнструментЧто делает
list_expensesСписок расходов с пагинацией
get_expenseДетали расхода
create_expenseЗафиксировать новый расход
update_expenseИзменить расход
delete_expenseУдалить расход

Клиенты (5)

ИнструментЧто делает
list_clientsСписок всех клиентов
get_clientДетали клиента
create_clientЗарегистрировать нового клиента
update_clientОбновить данные клиента
delete_clientУдалить клиента

CRM: Контакты (3)

ИнструментЧто делает
list_client_contactsСписок контактов клиента
create_client_contactДобавить контактного лица к клиенту
delete_client_contactУдалить контакт клиента

CRM: Активности (2)

ИнструментЧто делает
list_client_activitiesСписок CRM‑активностей (звонки, письма, встречи, задачи)
log_client_activityЗарегистрировать звонок, письмо, встречу или задачу для клиента

CRM: Примечания (3)

ИнструментЧто делает
list_client_notesСписок заметок по клиенту
create_client_noteДобавить произвольную заметку к клиенту
delete_client_noteУдалить заметку

Продукты (5)

ИнструментЧто делает
list_productsСписок продуктов и услуг
get_productДетали продукта
create_productДобавить продукт или услугу
update_productИзменить цену или детали
delete_productУдалить продукт

Коммерческие предложения (Quotes) (6)

ИнструментЧто делает
list_quotesСписок всех предложений
get_quoteДетали предложения
create_quoteСформировать новое предложение
update_quoteИзменить предложение
delete_quoteУдалить предложение
send_quoteВыслать клиенту на утверждение

Вебхуки (6)

ИнструментЧто делает
list_webhooksСписок настроенных вебхуков
get_webhookДетали вебхука
create_webhookЗарегистрировать новый веб‑хуку Endpoint
update_webhookИзменить события или URL
delete_webhookУдалить вебхук
test_webhookОтправить тестовую полезную нагрузку на вебхук

Интеллект (4)

ИнструментЧто делает
get_business_contextПолная сводка: профиль, план, активность, топ‑клиенты, текущий месяц
get_monthly_summaryЕжемесячная P&L: выручка, расходы, прибыль, налоговые обязательства, топ‑клиенты по выручке
get_quarterly_taxesКвартальная подготовка налогов: Modelo 303/130, начислено vs вычитаемо, обязательства
duplicate_invoiceКлонировать счёт для периодических платежей (копирует позиции/клиента/налоги, создание — в черновик)

Электронная торговля (E‑Invoicing) (10)

ИнструментЧто делает
send_einvoiceОтправка счёта в 11 форматах (XRechnung, Factur-X, FatturaPA, PEPPOL, Facturae, UBL, CII) по электронной почте / Chorus Pro / SDI / PEPPOL / скачивание
get_einvoice_statusМониторинг статуса выполнения Hatchet — возвращает ackId, XML URL, PDF/A-3 URL
validate_einvoice_xmlВалидировать XML на соответствие схемам + Schematron
export_datevЭкспорт данных в DATEV EXTF (Buchungsstapel / Debitoren / Kreditoren) в CP1252
einvoice_exportЭкспорт данных e‑invoice в машиночитаемых форматах (JSON/XML) для архивирования или интеграции
face_submitОтправка счёта в FACe (Испания, государственная платформа электронного счёта)
face_statusМониторинг статуса отправки в FACe
ticketbai_submitОтправка учетной записи TicketBAI в налоговую Баскской области
ticketbai_statusМониторинг статуса отправки TicketBAI — перекрёстная проверка с E‑Invoicing
ksef_submitОтправка счёта в KSeF (Польша) — заглушка: транспортная инфраструктура готова, но сейчас не доступна как рабочий эндпойнт

Учёт времени (Time Tracking) (6)

ИнструментЧто делает
list_time_entriesСписок записей времени с фильтром по пользователю, проекту, диапазону дат, оплаченности
get_time_entryДетали одной записи времени по ID
create_time_entryУчёт часов по проекту (флаг billable, описание, дата)
update_time_entryОбновить любое поле записи времени (PATCH)
delete_time_entryМягкое удаление записи времени (требуется confirm=true)
get_time_summaryСумма часов по периодам (все/оплачиваемые/неоплачиваемые) с возможностью groupBy

Повторяющиеся счета (Recurring Invoices) (8)

ИнструментЧто делает
list_recurring_invoicesСписок всех шаблонов повторяющихся счетов (активные/приостановленные)
get_recurring_invoiceДетали повторяющегося шаблона по ID
create_recurring_invoiceСоздать новый шаблон повторяющегося счета
update_recurring_invoiceОбновить поля шаблона — влияет на будущие счета
pause_recurring_invoiceПриостановить активный шаблон — счета не генерируются
resume_recurring_invoiceВозобновить приостановленный шаблон — следующий счет по расписанию
delete_recurring_invoiceБезвозвратно удалить шаблон (confirm=true)
run_recurring_nowВручную сгенерировать следующий экземпляр счета

Управление командой (Team Management) (4)

ИнструментЧто делает
list_team_membersСписок участников рабочей области с ролями и статусами приглашения
invite_team_memberПригласить нового участника по электронной почте с ролью (admin/member/viewer)
update_team_member_roleИзменить роль существующего участника
remove_team_memberУдалить участника из рабочего пространства (confirm=true)

Gestoria — бухгалтера (5)

ИнструментЧто делает
gestoria_message_sendОтправлять сообщение в контекстной ветке (documentRequest / filingItem / obligation)
gestoria_messages_listСписок сообщений в ветке, по мереNewest; пагинация назад
gestoria_template_createСоздать шаблон запроса документов с переменными + смещение по дате оплаты
gestoria_template_bulk_sendМассовая отправка шаблона до 500 рабочих пространств клиентов за один вызов
gestoria_aging_consolidatedСводный AR‑aging по разным клиентам

Audit GL (3)

ИнструментЧто делает
frihet_gl_entry_approveУтвердить проводку GL (только для gestor/admin — TRUST AREA)
frihet_gl_entry_rejectОтклонить проводку GL с обязательной причиной (TRUST AREA)
frihet_gl_entry_audit_logПолучить полный журнал аудита для проводки GL

White-label Portal Domain (3)

ИнструментЧто делает
frihet_portal_domain_addДобавить пользовательский домен в портале клиента (возвращает записи DNS CNAME)
frihet_portal_domain_verifyПроверить распространение DNS для пользовательского домена портала
frihet_portal_domain_removeУдалить пользовательский домен портала (вернуть к дефолтному субдомену Frihet)

Self-onboard & VIES (2)

ИнструментЧто делает
frihet_portal_onboard_link_generateСгенерировать ограниченно‑временную ссылку для самонастройки потенциального клиента
frihet_tax_id_vies_lookupВалидировать номер НДС ЕС (CIF intracomunitario) через VIES

IGIC — Налоги Канарских островов (4)

ИнструментЧто делает
frihet_modelo_415_summaryM415 годовые операции >€3,005 (эквивалент M347 для Canarias)
frihet_modelo_425_summaryM425 годовой обзор IGIC для бизнеса на Канарах
frihet_modelo_418_summaryM418 ежемесячный отчёт IGIC для крупных предприятий
frihet_aiem_calculateРассчитать AIEM (Arbitrio Importación) для ввезённых/произведённых в Canarias товаров

Impuesto sobre Sociedades — Корпоративный налог (2)

ИнструментЧто делает
frihet_modelo_200_summaryModelo 200 годовая декларация по подоходному налогу (налоговая база, вычеты, сумма к уплате)
frihet_modelo_202_summaryModelo 202 авансовые платежи (1P Апрель, 2P Октябрь, 3P Декабрь)

Правила банковской категоризации (2)

ИнструментЧто делает
frihet_bank_rules_listСписок правил авто‑категоризации банковских операций
frihet_bank_rule_createСоздать новое правило авто‑категоризации по описанию, сумме, противнику

Депозиты (7)

ИнструментЧто делает
list_depositsСписок депозитов с пагинацией
get_depositДанные депозита по ID
create_depositЗафиксировать новый депозит клиента
update_depositОбновить поля депозита
delete_depositУдалить депозит (confirm=true)
apply_depositПрименить баланс депозита к счету
refund_depositВернуть депозит

Контрагенты (Vendors) (5)

ИнструментЧто делает
list_vendorsСписок поставщиков
get_vendorДетали поставщика
create_vendorДобавить нового поставщика
update_vendorОбновить данные поставщика
delete_vendorУдалить поставщика

Банковские операции (Banking) (5)

ИнструментЧто делает
list_bank_accountsСписок подключённых банковских счетов
get_bank_accountДетали банковского счёта
list_transactionsСписок банковских транзакций с фильтрами
categorize_transactionНазначить категорию и тип расхода/дохода транзакции
match_transaction_to_invoiceСвязать банковскую транзакцию с существующим счетом

Фискал — Испанские налоговые модели (7)

ИнструментЧто делает
get_modelo_303_summaryКвартальная декларация IVA (Modelo 303) — начислено vs вычтенное, чистая обязанность
get_modelo_130_summaryКвартальная авансовая IRPF для самозанятых (Modelo 130)
get_modelo_390_summaryГодовой свод IVA (Modelo 390)
get_modelo_180_summaryГодовый свод удержаний для аренды (Modelo 180)
get_modelo_347_summaryЕжегодные сделки третьих лиц >€3,005 (Modelo 347)
verifactu_statusСтатус подачи VeriFactu
verifactu_resubmitПовторная подача VeriFactu
ticketbai_statusМониторинг статуса TicketBAI — перекрёстная проверка с E‑Invoicing (10); не учитывается в этом разделе

Аренда жилья / Проживание (Vacation Rentals / Stay) (5)

ИнструментЧто делает
list_reservationsСписок бронирований с фильтрами
get_reservationДетали брони
create_reservationСоздать новое бронирование
list_propertiesСписок объектов аренды
sync_channelСинхронизация каналов OTA (Airbnb, Booking.com и т. п.)

POS — Точка продаж (4)

ИнструментЧто делает
list_terminalsСписок регистрируемых POS‑терминалов
get_saleДетали продажи через POS
list_salesСписок продаж через POS с пагинацией
refund_saleВернуть деньги за продажу через POS

Кухня / Ресторан (Kitchen / Restaurant) (6)

ИнструментЧто делает
list_kitchen_ticketsСписок квитанций кухни для живой панели, фильтры по статусу/станции
get_kitchen_ticketОткрыть одну квитанцию кухни с позициями и статусами
update_kitchen_ticketОбновить статус квитанции (от очереди к готовке к подаче) или переназначить станцию
list_kitchen_stationsСписок станций кухни
list_menu_itemsСписок меню кухни с полнотекстовым поиском и активностью
kitchen_flow_summaryОбнаружение узких мест: агрегирование открытых квитанций по станциям

HR — Человеческие ресурсы (9)

ИнструментЧто делает
leave_request_createСоздать запрос на отпуск (отпуск, больничный, личный)
leave_approveУтвердить запрос на отпуск
leave_rejectОтклонить запрос на отпуск с причиной
leave_cancelОтменить утверждённый или ожидающий отпуск
leave_listСписок запросов на отпуск с фильтрами
attendance_clock_inЗаписать прибытие сотрудника на работу
attendance_clock_outЗаписать уход сотрудника
overtime_reportСформировать отчёт об-overtime за период
anomaly_listСписок аномалий учёта времени

Зарплата (Payroll) (2)

ИнструментЧто делает
payroll_exportЭкспорт данных по заработной плате за период
payroll_checklistСборник контрольных пунктов для пред‑зарплаты

Онбординг (Onboarding) (2)

ИнструментЧто делает
onboarding_statusСтатус завершения онбординга для текущего рабочего пространства
onboarding_persona_setУстановить или обновить бизнес‑персону (фрилансер, SME, gestoría и т. д.)

Привилегии (Permissions) (2)

ИнструментЧто делает
permissions_matrixПолная матрица прав для всех ролей в рабочем пространстве
permissions_meТекущие разрешения вашего API‑ключа

Закрытие периода (Period Close) (3)

ИнструментЧто делает
period_close_statusСтатус закрытия учётного периода
period_closeЗакрыть учётный период (gestor/admin — TRUST AREA)
period_reopenОткрыть закрытый период с обязательной причиной (TRUST AREA)

Все 157 инструментов возвращают структурированный вывод через outputSchema — типизированный JSON, а не чистый текст. Списки инструментов возвращают результаты с пагинацией ({ data, total, limit, offset }).

Ресурсы (11)

Контекст, который ИИ может читать для более умных решений.

Статический (описательные данные, без API-запросов):

РесурсURIЧто предоставляет
API Schemafrihet://api/schemaOpenAPI-обзор: endpoints, авторизация, лимиты, пагинация, коды ошибок
Tax Ratesfrihet://tax/ratesНалоги по регионам: IVA, IGIC, IPSI, ЕС‑обмен, IRPF
Tax Calendarfrihet://tax/calendarКрайние сроки подачи: Modelo 303, 130, 390, 420, график VeriFactu
Expense Categoriesfrihet://config/expense-categories8 категорий с правилами deductible/IVA, амортизацией
Invoice Statusesfrihet://config/invoice-statusesСтатусы (черновик → отправлен → оплачен/просрочен → отменён) и переходы
Currenciesfrihet://config/currencies40 валют с кодами ISO, символами, десятичными знаками, локалью
Countriesfrihet://config/countries61 страны с налоговыми зонами, валютами, префиксами счетов

Динамический (живые данные вашей учетной записи):

РесурсURIЧто предоставляет
Business Profilefrihet://business-profileИнформация о бизнесе, план, настройки по умолчаниям, недавняя активность, топ‑клиенты
Monthly Snapshotfrihet://monthly-snapshotТекущая месяц‑P&L: выручка, расходы, налоговые обязательства
Overdue Invoicesfrihet://overdue-invoicesВсе просроченные счета (до 100)
Plan Limitsfrihet://status/plan-limitsАктуальный уровень плана, счётчики использования, счета/мес, лимиты API

Подсказки (Prompts) (10)

Готовые рабочие процессы, которые ИИ может выполнять как пошаговые операции.

ПодсказкаЧто делаетАргументы
monthly-closeЗакрыть месяц: проверить неоплаченные счета, классифицировать расходы, проверить налоговые обязательства, сгенерировать сводкуmonth? (YYYY-MM)
onboard-clientНастроить нового клиента с правильными налоговыми ставками по местоположению, опционально создать приветственный счётclientName, country?, region?
quarterly-tax-prepПодготовить квартальную налоговую декларацию: рассчитать IVA/IGIC, выявить вычитаемые, просмотреть Modelo 303/130/420quarter?, fiscalZone?
overdue-followupНайти просроченные счета, подготовить сообщения для напоминания об оплате--
new-client-invoiceСоздать клиента и первый счёт в одном процессе с поиском налоговой ставкиclientName, country?
expense-reportСформировать отчёт по расходам с группировкой по категориям и суммам по вычетамmonth? (YYYY-MM)
year-end-closeПолное годовое закрытие: квартальный обзор, ожидающие счета, незавершённые расходы, чек‑лист на конец годаyear (YYYY)
cash-flow-forecastПрогноз денежного потока на ближайшие месяцы: повторяющиеся доходы, расходы, просроченные платежи, налоговые срокиmonths? (default: 3)
invoice-aging-reviewAR‑анализ старения: группировать неоплаченные счета по диапазонам, лидеры задолженности, действия по взысканию--
expense-batchОбработать расходы пакетно: классифицировать, применить ставки налогов, отметить отсутствующие квитанцииfiscalZone?

Как это работает

graph LR
    AI["Ваш AI‑помощник"]
    MCP["frihet-mcp"]
    API["api.frihet.io"]
    DB["Frihet ERP"]

    AI -- "create_invoice()" --> MCP
    MCP -- "POST /v1/invoices" --> API
    API --> DB
    DB -- "201 + invoice data" --> API
    API -- "structured JSON" --> MCP
    MCP -- "typed response + suggestions" --> AI

    style AI fill:#09090b,stroke:#4ade80,color:#fafafa
    style MCP fill:#09090b,stroke:#4ade80,color:#fafafa
    style API fill:#09090b,stroke:#3f3f46,color:#a1a1aa
    style DB fill:#09090b,stroke:#3f3f46,color:#a1a1aa

Сервер преобразует вызовы инструментов в REST API‑запросы. Он обеспечивает аутентификацию, контроль скорости (автоматическую повторную попытку при 429), пагинацию и сопоставление ошибок.

Два канала передачи:

  • stdio (локальный) — npx @frihet/mcp-server с FRIHET_API_KEY

  • Streamable HTTP (удалённый) — https://mcp.frihet.io/mcp с Bearer‑токеном или OAuth 2.0+PKCE

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

ПеременнаяОбязательнаПо умолчанию
FRIHET_API_KEYДа (stdio)--
FRIHET_API_URLНетhttps://api.frihet.io/v1
FRIHET_TOOL_MODEНетfull

Экспонирование инструментов: глубина по запросу

Преимущество Frihet — глубина охвата: полное покрытие налоговых требований ЕС/ИСП и нативная соответствие (VeriFactu, TicketBAI, Facturae/FACe; KSeF Польша — инфраструктура готова, активация ожидается), банковское дело, CRM, HR/зарплата, stay/PMS и POS. Но полный перечень инструментов «на старте» перегружает контекст агента и мешает выбору инструментов.

FRIHET_TOOL_MODE управляет тем, как глубина экспонируется.

РежимПоведение
full (по умолчанию)Все инструменты экспонированы со своими полными описаниями и схемами. Без изменений по сравнению с предыдущими релизами — существующие настройки не затрагиваются.
groupedПоэтапное раскрытие. Описание каждого инструмента сворачивается до одной строки [group]‑краткого описания — полный набор схем через describe_tool('name'), и добавляются три лёгких инструментов‑обзора. Агента загружает глубину только для нужных инструментов.

В режиме grouped инструменты не изменяются — те же имена, те же входные схемы, поведение. Изменяется лишь upfront‑стоимость контекста. Discovery осуществляется через три мета‑инструмента:

  • list_tool_groups() — карта домена (invoicing, expenses, fiscal/compliance, banking, CRM, HR/payroll, stay/PMS, POS, intelligence, products, platform) с однострочным резюме и количеством инструментов в каждой группе.

  • search_tools(query) — полнотекстовый поиск по названию инструмента, заголовку, резюме и группе; возвращает совпадающие инструменты с их группой, резюме, признаком read-only и входными полями. Доп. фильтры по группе и лимит.

  • describe_tool(name) — полное оригинальное описание и входные поля для инструмента по запросу, перед вызовом.

// claude_desktop_config.json — opt in to grouped mode
{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "fri_...",
        "FRIHET_TOOL_MODE": "grouped"
      }
    }
  }
}

Это опциональный слой экспозиции — он никоим образом не меняет логику, имя или поведение инструментов, и режим full остаётся идентичным предыдущей версии. Та же концепция применяется и к безопасному профилю OpenAI (FRIHET_OPENAI_MODE).

Ограничения API

ОграничениеЗначение
Запросов в минуту100 на API‑ключ
Результатов на страницумаксимум 100 (по умолчанию 50)
Тело запросамаксимум 1 МБ
Payload вебхуковмаксимум 100 КБ
Вебхуков на учётную записьмаксимум 20

Контроль скорости выполняется автоматически с экспоненциальной задержкой.

Claude Code Skill

Помимо готовых инструментов MCP, в репозитории есть навык Claude Code, который добавляет контекст бизнеса: правила налогов по Испании, рецепты рабочих процессов, финансовые отчёты и команды на естественном языке.

Установка навыка

git clone https://github.com/Frihet-io/frihet-mcp.git
ln -s "$(pwd)/frihet-mcp/skill" ~/.claude/skills/frihet

Или через универсальный установщик:

npx skills add Frihet-io/frihet-mcp

Команды

КомандаЧто делает
/frihet statusОбзор аккаунта, недавняя активность, ожидающие платежи
/frihet invoiceСоздать, списать, найти счёт-фактуру
/frihet expenseЗафиксировать и запросить расходы
/frihet clientsУправлять базой клиентов
/frihet quoteСоздавать и управлять предложениями
/frihet reportФинансовые сводки (P&L, квартальные, просрочки)
/frihet webhooksНастроить триггеры автоматизации
/frihet setupРуководство по настройке и тест подключения

Навык знает ставки IVA, удержания IRPF, подготовку Modelo 303, правила вычета расходов и требования VeriFactu.

Полная документация: docs.frihet.io/desarrolladores/skill-claude-code

Разработка

git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build

Запуск локально:

FRIHET_API_KEY=fri_xxx node dist/index.js

Проверка через MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Внесение изменений

Внесение изменений приветствуется. Предложение обсуждать через issue.

git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build   # должен успешно выполниться перед отправкой изменений

Текущие ограничения

  • Нет OCR или загрузки файлов — MCP работает с структурированными данными, а не с изображениями.
  • Одна компания — один API‑ключ соответствует одному Frihet‑рабочему пространству.
  • Требуется учётная запись Frihet — активная учётная запись на app.frihet.io и API‑ключ (начинается с fri_).

Экосистема

ПакетЧто это такое
@frihet/mcp-serverЭтот MCP‑сервер (157 инструментов, 11 ресурсов, 10 подсказок)
@frihet/sdkTypeScript SDK (frihet.invoices.create())
frihetCLI (frihet invoices list --status overdue)
n8n-nodes-frihetнода для n8n — автоматизация рабочих процессов
REST APIOpenAPI 3.1 на api.frihet.io/v1
Remote MCPХостинг‑эндпойнт на Cloudflare Workers (без установки)
WebhooksСобытия в реальном времени с HMAC-SHA256

Ссылки

Лицензия

MIT. См. LICENSE.

Собрано командой Frihet.