Factuarea

Factuarea MCP

只需连接一个 MCP 服务，即可管理整个后台。
开具 VeriFactu 发票、管理采购、目录、税务申报、工时记录和自动化
专为西班牙企业打造，并可作为工具供 Claude、ChatGPT、Cursor、VS Code 和任何 MCP 客户端使用。

English · 西班牙语

650+ 个工具 · 41 个领域 · 9 项税务防护措施 · 5 个引导式工作流 · 线上和沙盒环境

Factuarea 是面向西班牙企业和自由职业者的发票与管理平台。这是其官方的 Model Context Protocol 服务——由 Factuarea 团队在生产环境中运行，而不是基于其构建的封装层。无论你能在 Factuarea 仪表板或通过其 REST API 完成什么，你的 Agent 都能通过对话完成：从开具 VeriFactu 发票到查询今天早上谁打了卡。

连接

服务地址为 https://mcp.factuarea.com。将其添加到客户端，并使用你的 Factuarea 账户登录——无需安装，也无需复制密钥。在授权页面中，你可以选择公司、环境（live 或 test）以及要授予的具体权限。

所有 Factuarea 套餐均包含 MCP 访问权限，试用期间也不例外。

claude mcp add --transport http factuarea https://mcp.factuarea.com \
  --header "Authorization: Bearer fact_test_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "factuarea": {
      "command": "npx",
      "args": ["-y", "@factuarea/mcp"],
      "env": { "FACTUAREA_API_KEY": "fact_test_xxxxxxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

“为 Talleres Ruiz 开具昨天送货单的发票，并通过电子邮件发送给他们。”

“本季度哪些发票仍未付款？给每位客户发送提醒。”

“将报价单 2026-014 转为发票，但把到期日改为 30 号。”

“登记这张供应商发票，并标记为已通过银行转账付款。”

“将批发价目表中的所有价格上调 5 %。”

“准备第三季度的 Modelo 303 工作簿。”

“为什么 WooCommerce 订单 #1042 没有生成发票？”

“团队中今天谁还没有打卡？”

“在项目 DEV 中创建一个明天到期的任务，并分配给 Ana。”

“为我们发送给 Talleres Ruiz 的每份报价单使用带有我们徽标的新模板。”

涵盖内容

除了工具之外，该服务还以资源的形式发布了 9 份税务指南 （factuarea://guardrails/…：开具、作废与更正的区别、发票类型、明细行与金额、增值税制度代码、编号系列、买方身份识别、VeriFactu 前置条件、多家公司），以及作为提示词的 5 个引导式工作流：开具发票、修复开具失败的发票、通过税号登记客户、连接网店，以及追踪一笔从未开具发票的订单。

专为处理真实资金的 Agent 设计

不会破坏税务记录。 发票一旦存在于税务机构系统中，有些错误就无法撤销：删除已开具的发票而非将其作废、编辑已不再是草稿的发票、作废更正发票。服务会在执行任何操作前拒绝这些调用；拒绝响应（mcp_guardrail_violation）会指出违反的规则（rule_id）以及说明正确处理方式的指南（guardrail_uri），让 Agent 能够自行调整处理方式。

重试不会生成第二张发票。 无法撤销的操作需要提供 idempotency_key。如果 Agent 在超时后重复调用，就会收到标记为重放的原始结果，而不是重复文件。

只能查看你允许的内容。 每个凭据只会列出其作用域所允许的工具，并且每次调用都会再次检查权限。通过 OAuth 连接的第三方应用会获得经过筛选的目录；最敏感的操作——VeriFactu 写入、GDPR 数据擦除、付款、API 密钥和受管理公司——需要使用所有者自己的 API 密钥。任何凭据都无法访问未授权给它的公司数据。

先在副本上练习。 测试凭据可用于公司沙盒副本，该副本继承公司的套餐：不会向 AEAT 发送任何内容，不会向客户发送电子邮件，不会发出 webhook，FACe 提交也会进行模拟。

安全与隐私

采用 OAuth 2.1、PKCE 和轮换刷新令牌；API 密钥仅显示一次，以哈希形式存储，并可设置过期时间和 IP 允许列表；可从控制面板撤销已连接的应用。 隐私政策：factuarea.com/privacidad。 漏洞报告：请遵循 SECURITY.md。

Factuarea 为开发者提供的更多内容

• 文档 — REST API 参考、指南、错误代码和 llms.txt
• SDK — TypeScript 和 PHP
• CLI — 在终端中使用 API
• Claude Code 插件 — 此服务以及用于构建集成的技能
• 集成 — n8n 和 WooCommerce

常见问题

参与贡献

此仓库包含 npm 程序包和注册表清单；服务本身运行在 Factuarea 平台上。请阅读 CONTRIBUTING.md 以设置项目（如果您使用编码 Agent，请阅读 AGENTS.md），并在参与前阅读行为准则。更改记录列于 CHANGELOG。

许可证

此仓库中的代码采用 MIT 许可证。使用托管服务和 Factuarea 须遵守 Factuarea 的服务条款。