适合谁
- 需要全面 ERP 集成的西班牙及欧盟企业
- 需要处理财务合规（VeriFactu、TicketBAI、Facturae）的会计师
- 希望用 AI 聊天优化操作的中小型企业
- 管理劳动密集型行业（如餐饮、酒店）的门店运营
F
47FMRS · D
该官方 MCP 服务器为 Frihet ERP 提供深度集成，适合需要全面业务管理和欧洲税务合规的用户。考虑到数据敏感性，建议在使用前仔细评估。
Frihet ERP MCP 服务器（官方）将你的 AI 助手连接到 Frihet 企业资源规划系统，提供 157 个工具（另有 5 个财政别名）、11 个资源和 10 个提示词，支持用自然语言管理发票、费用、客户、CRM、产品、报价、银行、人力资源/工资、门店销售、餐饮和住宿预订。它原生支持西班牙及欧盟的财政合规，包括 VeriFactu、TicketBAI 和 Facturae/FACe。通过 stdio 或远程流式 HTTP 端点运行，可与任何兼容 MCP 的客户端配合使用。需要 Frihet 账户和 API 密钥。
工具能力
list_invoices
带分页列出发票。
get_invoice
按 ID 获取完整发票详情。
create_invoice
创建一张带有行项目的新发票。
update_invoice
delete_invoice
search_invoices
send_invoice
mark_invoice_paid
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
安装接入
- 在 app.frihet.io 注册 Frihet 账户并创建 API 密钥（以 fri_ 开头）。2. 在客户端配置文件中添加 MCP 服务器。3. 对于 Claude Code/Desktop、Cursor、Windsurf 等，使用 npm 包 @frihet/mcp-server，通过 npx 启动并设置 FRIHET_API_KEY 环境变量。4. 或者使用远程端点：https://mcp.frihet.io/mcp（通过 Bearer 令牌或 OAuth 2.0 + PKCE 认证）。5. 使用 -- 对于无需安装的演示模式，设置 FRIHET_DEMO=1 环境变量可尝试演示。
claude_desktop_config.json
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_your_key_here"
}
}
}
}
选型与风险
不适合谁
- 不需要完整 ERP 深度、只需简单任务的人
- 需要进行 OCR 或 PDF 扫描的（服务器不支持）
- 需要对账以外的复杂银行功能（未提）
所需权限
- 需要 FRIHET_API_KEY 环境变量
- 可通过 API 访问该工作区的全部业务数据
- 支持远程端点的认证（Bearer 令牌或 OAuth）
风险与副作用
- 敏感财务数据会发送给客户端 AI 服务
- 工具可修改并删除数据；标记为“TRUST AREA”的工具很敏感
- API 密钥泄露可能导致未授权的业务数据访问
- 写入操作和财政提交必须通过客户端确认
常见排障
- 如果工具未加载，请检查网络和 API 密钥格式（fri_…）
- 检查 FRIHET_API_KEY 环境变量设置是否正确
- 对于远程端点，确保有网络访问权限和认证
- 查看服务器是否支持你的 MCP 客户端版本并配置正确
使用场景
用自然语言创建和管理发票
通过对话记录和查询费用
管理客户、联系人、活动与笔记
管理产品、报价、银行交易和供应商
处理西班牙及欧盟的税务合规（VeriFactu、TicketBAI、Facturae）
管理团队、人力资源、工资和发展周期
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持
Windsurf完整支持
Cline完整支持
Codex CLI完整支持
Copilot完整支持
Gemini CLI完整支持