← 返回目录

Frihet ERP MCP Server

官方

面向企业管理的 AI 原生 MCP 服务器，涵盖开票、税务合规与财务。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 12 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 天前
工具数: 100

47FMRS · D

该官方 MCP 服务器为 Frihet ERP 提供深度集成，适合需要全面业务管理和欧洲税务合规的用户。考虑到数据敏感性，建议在使用前仔细评估。

最强项 · 文档质量 13/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

8/20

维护活跃度

10/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 6/20: 证据有限：仅读取了README和manifest。README声称157个工具、11个资源和10个提示，但未提供实际代码验证。manifest正确声明了stdio和streamable-http传输，但无可执行测试或CI来确认服务器能干净启动和完成初始化握手。潜在不一致：提及'FRIHET_OPENAI_MODE'和'grouped'模式，但README未详细说明验证。扣除：缺少测试证据和代码审查；存在未经验证的完全成熟度声明的风险。静态校准：可靠性得分上限为12，但证据不足将其降低。
安全与权限 8/20: 观察到API密钥处理：FRIHET_API_KEY作为环境变量，示例使用'fri_your_key_here'（占位符）。危险操作需要确认标志（例如，delete_..._confirm=true，period_close，gestor/admin标志）。网络使用存在：工具调用REST API并发送webhook，但数据流已在图的'How it works'部分充分说明。远程端点支持OAuth 2.0+PKCE。演示模式不进行网络调用并模拟写入。主要风险已缓解，但权限范围（tool_mode，grouped）可能默认完全暴露。提高评分，因为承认了确认机制和限速，但没有披露任何潜在风险。
维护活跃度 10/20: 评分基于元数据：活跃仓库（未存档），MIT许可证（存在），版本1.18.0，7个未解决issue。没有证据表明发布节奏或问题响应。有文档化的安全渠道吗？README未提及。依赖未显示。在缺乏提交历史的情况下降低评分，存在治理不明确的可能。
文档质量 13/20: README非常全面：安装（本地和远程）、API密钥获取、每个工具列表、资源、提示和环境变量。包含工具模式（完整/分组）的文档。包含API限制（速率限制）。包含故障排除？没有突出问题解决指南。包含成本（价格）？没有提及，可能导致意外。扣除：API成本或详细故障排除未放；源代码已给出，但方法独立。演示模式为空白提供了轻度证据。由于分层结构和覆盖范围很好，给予高，但未披露限制。
安装易用性 10/20: 清晰的安装步骤：npm/npx，客户端配置JSON（Claude Code，Cursor等）。提供远程端点URL。环境变量记录明确。演示模式便于快速试用。要求FRIHET_API_KEY。支持流传输和HTTP。复杂度：157个工具可能对客户端造成负担，但分组模式缓解。为适用客户端提供多种配置示例。为无账户试用提供轻微加分，但无额外验证。由于超过15的上限需要执行证据，得分为10。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

需要全面 ERP 集成的西班牙及欧盟企业
需要处理财务合规（VeriFactu、TicketBAI、Facturae）的会计师
希望用 AI 聊天优化操作的中小型企业
管理劳动密集型行业（如餐饮、酒店）的门店运营

不适合谁

不需要完整 ERP 深度、只需简单任务的人
需要进行 OCR 或 PDF 扫描的（服务器不支持）
需要对账以外的复杂银行功能（未提）

所需权限

需要 FRIHET_API_KEY 环境变量
可通过 API 访问该工作区的全部业务数据
支持远程端点的认证（Bearer 令牌或 OAuth）

风险与副作用

敏感财务数据会发送给客户端 AI 服务
工具可修改并删除数据；标记为“TRUST AREA”的工具很敏感
API 密钥泄露可能导致未授权的业务数据访问
写入操作和财政提交必须通过客户端确认

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

FRIHET_API_KEY 必填密钥 Frihet API 密钥（以 fri_ 开头），必需；在 app.frihet.io 的 Settings > API 创建，只显示一次。

其他可选配置项（3 个）

FRIHET_API_URL 可选可选；覆盖 REST API 地址，默认 https://api.frihet.io/v1。

FRIHET_TOOL_MODE 可选可选；设为 grouped 可启用渐进式工具披露（发现元工具），默认 full。

FRIHET_DEMO 可选可选；设为 1 进入演示模式，使用示例数据、无网络调用、无持久化。

在 app.frihet.io 注册 Frihet 账户并创建 API 密钥（以 fri_ 开头）。
在客户端配置文件中添加 MCP 服务器。
对于 Claude Code/Desktop、Cursor、Windsurf 等，使用 npm 包 @frihet/mcp-server，通过 npx 启动并设置 FRIHET_API_KEY 环境变量。
或者使用远程端点：https://mcp.frihet.io/mcp（通过 Bearer 令牌或 OAuth 2.0 + PKCE 认证）。
使用 -- 对于无需安装的演示模式，设置 FRIHET_DEMO=1 环境变量可尝试演示。

claude_desktop_config.json

{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["-y", "@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "fri_your_key_here"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "frihet": {
      "command": "npx",
      "args": [
        "-y",
        "@frihet/mcp-server"
      ],
      "env": {
        "FRIHET_API_KEY": "fri_your_key_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add frihet -e FRIHET_API_KEY=fri_your_key_here -- npx -y @frihet/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动服务器后（npx -y @frihet/mcp-server，设置 FRIHET_API_KEY），在客户端工具列表中确认 list_invoices 和 get_business_context 等工具已出现；也可以先用 FRIHET_DEMO=1 启动进行免密钥测试，并应看到 DEMO MODE 启动横幅。

常见排障

如果工具未加载，请检查网络和 API 密钥格式（fri_…）
检查 FRIHET_API_KEY 环境变量设置是否正确
对于远程端点，确保有网络访问权限和认证
查看服务器是否支持你的 MCP 客户端版本并配置正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出所有未支付的发票，并标记金额超过 1000 欧元的那些。
为 TechStart SL 创建一张发票：40 小时咨询，每小时 75 欧元。
把发票 INV-2026-089 标记为已支付，付款日期是今天。
本月开销汇总是什么？包括税负和利润。

工具能力 100

list_invoices 只读

带分页列出发票。

get_invoice 只读

按 ID 获取完整发票详情。

create_invoice 写入

创建一张带有行项目的新发票。

update_invoice 写入

delete_invoice 破坏性

search_invoices 只读

send_invoice 破坏性

mark_invoice_paid 写入

展开其余 92 个工具

get_invoice_pdf 只读

get_invoice_einvoice 只读

create_credit_note 写入

apply_late_fee 写入

list_expenses 只读

get_expense 只读

create_expense 写入

记录新费用。

update_expense 写入

delete_expense 破坏性

list_clients 只读

列出所有客户。

get_client 只读

create_client 写入

注册新客户。

update_client 写入

delete_client 破坏性

list_client_contacts 只读

create_client_contact 写入

delete_client_contact 破坏性

list_client_activities 只读

log_client_activity 写入

list_client_notes 只读

create_client_note 写入

delete_client_note 破坏性

list_products 只读

get_product 只读

create_product 写入

update_product 写入

delete_product 破坏性

list_quotes 只读

get_quote 只读

create_quote 写入

update_quote 写入

delete_quote 破坏性

send_quote 破坏性

list_webhooks 只读

get_webhook 只读

create_webhook 写入

update_webhook 写入

delete_webhook 破坏性

test_webhook 写入

get_business_context 只读

get_monthly_summary 只读

get_quarterly_taxes 只读

duplicate_invoice 写入

send_einvoice 破坏性

以 11 种格式（XRechnung、Factur-X、FatturaPA、PEPPOL、Facturae 等）发送电子发票。

get_einvoice_status 只读

validate_einvoice_xml 只读

export_datev 只读

einvoice_export 只读

face_submit 破坏性

face_status 只读

ticketbai_submit 破坏性

ticketbai_status 只读

ksef_submit 破坏性

list_time_entries 只读

get_time_entry 只读

create_time_entry 写入

update_time_entry 写入

delete_time_entry 破坏性

get_time_summary 只读

list_recurring_invoices 只读

get_recurring_invoice 只读

create_recurring_invoice 写入

update_recurring_invoice 写入

pause_recurring_invoice 写入

resume_recurring_invoice 写入

delete_recurring_invoice 破坏性

run_recurring_now 写入

list_team_members 只读

invite_team_member 写入

update_team_member_role 写入

remove_team_member 破坏性

gestoria_message_send 破坏性

gestoria_messages_list 只读

gestoria_template_create 写入

gestoria_template_bulk_send 破坏性

gestoria_aging_consolidated 只读

frihet_gl_entry_approve 写入

frihet_gl_entry_reject 写入

frihet_gl_entry_audit_log 只读

frihet_portal_domain_add 写入

frihet_portal_domain_verify 只读

frihet_portal_domain_remove 破坏性

frihet_portal_onboard_link_generate 写入

frihet_tax_id_vies_lookup 只读

frihet_modelo_415_summary 只读

frihet_modelo_425_summary 只读

frihet_modelo_418_summary 只读

frihet_aiem_calculate 只读

frihet_modelo_200_summary 只读

frihet_modelo_202_summary 只读

frihet_bank_rules_list 只读

frihet_bank_rule_create 写入

使用场景

用自然语言创建和管理发票

通过对话记录和查询费用

管理客户、联系人、活动与笔记

管理产品、报价、银行交易和供应商

处理西班牙及欧盟的税务合规（VeriFactu、TicketBAI、Facturae）

管理团队、人力资源、工资和发展周期

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

Cline

Codex

GitHub Copilot

Gemini CLI

依据项目文档列出，未经本站实测。

详细介绍

Frihet ERP MCP 服务器（官方）将你的 AI 助手连接到 Frihet 企业资源规划系统，提供 157 个工具（另有 5 个财政别名）、11 个资源和 10 个提示词，支持用自然语言管理发票、费用、客户、CRM、产品、报价、银行、人力资源/工资、门店销售、餐饮和住宿预订。它原生支持西班牙及欧盟的财政合规，包括 VeriFactu、TicketBAI 和 Facturae/FACe。通过 stdio 或远程流式 HTTP 端点运行，可与任何兼容 MCP 的客户端配合使用。需要 Frihet 账户和 API 密钥。