Frihet MCP

AI-native MCP server for business management.

Servidor MCP nativo con IA para gestión empresarial.

=18">

______________________________________________________________________

分布

______________________________________________________________________

这是什么

将您的AI助手连接到的MCP服务器 自由.通过谈话创建发票。用自然语言查询费用。从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.

127工具。8资源。7个提示。每个工具的结构化输出。零样板。

______________________________________________________________________

安装

一行代码（Claude Code、Cursor、Copilot、Codex、Windsurf、Gemini CLI等）

npx skills add Frihet-io/frihet-mcp

克劳德代码/克劳德桌面

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

JSON配置对所有工具都是相同的。只有文件路径会更改。

远程（无需安装）

在以下位置使用托管端点 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 并通过浏览器进行身份验证。服务器使用PKCE实现了完整的OAuth 2.1授权代码流。

获取API密钥

1. 登录 App.frihet.io
2. 首选 设置>API
3. 点击 创建API密钥
4. 复制密钥（以开头 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"

客户关系管理

"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"

语录

"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是 结构化数据接口 --你用自然语言描述你想要什么，人工智能在Frihet中创建、查询或修改业务记录。所有125个工具都是通过REST API进行的CRUD操作。

效果很好：

"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. Scan/photograph the invoice
2. Use Claude Vision: "Read this invoice image and extract the vendor, items, amounts, and dates"
3. Then: "Create an expense in Frihet for [extracted data]"

______________________________________________________________________

工具（127）

发票（6）

费用（5）

客户（5）

CRM：联系人（3）

客户关系管理：活动（2）

CRM：笔记（3）

产品（5）

引文（5）

挂钩（5）

情报（4）

电子发票（4）

状态：β-CF终点将于2026年4月21日至2026年04月28日推出。 工具调用 api.frihet.io/v1/einvoice/* 直接。如果端点尚未部署（404），则工具将回退到 { _stub: true, _note: "CF endpoint pending deploy", _plannedEndpoint: "..." } 因此服务器在运输船上仍然可用。

时间追踪（6）

状态：存根 — /v1/time/* 计划终点。工具表面404，直到后端发货。

经常性发票（8）

状态：存根 — /v1/recurring/* 计划终点。工具表面404，直到后端发货。

团队管理（4）

状态：存根 — /v1/team/* 计划终点。工具表面404，直到后端发货。

Gestoria-会计师（5）

状态：存根 — /v1/gestoria/* REST表面已关闭Wave Fase 1（PR#383批量发送、#384老化、#385消息传递）。工具表面404，直到后端发货。

审计总账（3）

状态：存根 — /v1/gl/* 可调用代理 approveGLEntry, rejectGLEntry, getGLEntryAuditLog （第395页）。工具表面404，直到后端发货。

白标签门户域（3）

状态：存根 — /v1/portal/domain/* 可调用代理 addCustomPortalDomain, verifyCustomPortalDomain, removeCustomPortalDomain （第397页）。

自驾游和VIES（2）

状态：存根 — /v1/portal/onboard/* 可调用代理 generatePortalOnboardLink, lookupTaxIdViaVIES （第398页）。公共门户流不包括在MCP中。

IGIC-加那利群岛间接税（4）

状态：存根 — /v1/igic/* 服务层读取（PR#390）。ATC SOAP除外（内部下文）。

公司税-公司税（2）

状态：存根 — /v1/is/* 服务层读取西班牙语SL/SA（PR#392）。

银行分类规则（2）

状态：存根 — /v1/banking/rules Q3已标记（PR#394）。Webhook处理程序已排除。

全部127个工具返回 结构化输出 通过 outputSchema --键入JSON，而不是原始文本。列表工具返回分页结果({ data, total, limit, offset }).

______________________________________________________________________

资源（8）

AI可以阅读上下文以做出更明智的决策。

静态 （参考数据，无API调用）：

动态的 （来自您帐户的实时数据）：

______________________________________________________________________

提示（7）

人工智能可以执行预先构建的工作流，作为引导的多步操作。

______________________________________________________________________

运作原理

graph LR
    AI["Your AI assistant"]
    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:#fafafa,color:#fafafa
    style API fill:#09090b,stroke:#3f3f46,color:#a1a1aa
    style DB fill:#09090b,stroke:#3f3f46,color:#a1a1aa

服务器将工具调用转换为REST API请求。它处理身份验证、速率限制（429上回退的自动重试）、分页和错误映射。

两种运输方式：

• 标准 （本地）-- npx @frihet/mcp-server 随着 FRIHET_API_KEY
• 流式HTTP （远程）-- https://mcp.frihet.io/mcp 使用Bearer令牌或OAuth 2.0+PKCE

环境变量

______________________________________________________________________

API限值

速率限制是通过指数回退自动处理的。

______________________________________________________________________

克劳德代码技能

除了原始的MCP工具，这个仓库还包括 Claude代码技能 它添加了业务上下文：西班牙税务规则、工作流配方、财务报告和自然语言命令。

安装技能

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

命令

该技能了解IVA费率、IRPF保留、Modelo 303准备、费用扣除规则和VeriFactu合规性。

完整文档： docs.frihet.io/开发人员/技能-克劳德-代码

______________________________________________________________________

发展

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检查员:

npx @modelcontextprotocol/inspector node dist/index.js

______________________________________________________________________

贡献

欢迎捐款。请先打开一个问题，讨论您想更改的内容。

git clone https://github.com/Frihet-io/frihet-mcp.git
cd frihet-mcp
npm install
npm run build   # must pass before submitting

______________________________________________________________________

当前限制

• 无OCR或文件上传 --MCP处理结构化数据，而不是图像或PDF。计划在未来发布。
• 单一公司 --一个API键映射到一个Frihet工作空间。多公司支持尚不可用。
• 需要Frihet帐户 --您需要一个活跃的帐户 App.frihet.io 和一个API密钥（以 fri_).

______________________________________________________________________

生态系统

链接

• 自由 --产品
• 文档 --完整文档
• API 参考 --REST API
• MCP服务器文档 --安装指南、故障排除
• --包注册表
• 铁匠铺 --史密斯利市场
• 远程端点 --托管MCP服务器（Cloudflare Workers）
• OpenAPI规范 --可机读API定义

______________________________________________________________________

许可证

MIT。看 许可证.

建造于 自由.