Fatture in Cloud MCP Server

肥胖包括mcp

  

连接Claude（桌面、代码或任何MCP客户端）的MCP服务器 FattureInCloud，意大利领先的电子发票SaaS。通过自然语言管理发票、信用票据、形式发票、客户、供应商、成本/收入中心和供应商费用。意大利通过Sistema di Interscambio（SDI）强制实施B2B/B2C电子发票——该服务器将人工智能辅助计费带入了合规驱动的工作流程。

⚠️ 非官方整合。 不隶属于FattureInCloud商标所有者TeamSystem S.p.A.，也不由其背书或赞助。该商标仅用于描述目的。

功能（23工具）

将支付标记为“已支付”是故意不暴露的：FatureInCloud API需要一个无法通过SDK可靠检索的支付帐户。使用FattureInCloud web面板进行该操作。

安装

选项1-Claude桌面（MCPB捆绑包，推荐）

1. 下载最新 fattureincloud.mcpb 从 .
2. 拖动 .mcpb 文件到克劳德桌面，或使用 设置→ 扩展→ 从文件安装.
3. 提示时，填写FatureInCloud API令牌、公司ID和（可选）发件人电子邮件。

就是这样——没有Python设置，没有virtualenv。

选项2——通过PyPI手动安装

适用于Claude Code用户或任何读取以下内容的MCP客户端 claude_desktop_config.json-样式配置：

pip install fattureincloud-mcp

然后添加到您的MCP客户端配置中（对于Claude Desktop， ~/Library/Application Support/Claude/claude_desktop_config.json 在macOS或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "fattureincloud": {
      "command": "python",
      "args": ["-m", "fattureincloud_mcp"],
      "env": {
        "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz",
        "FIC_COMPANY_ID": "123456",
        "FIC_SENDER_EMAIL": "billing@yourcompany.com"
      }
    }
  }
}

编辑配置后重新启动MCP客户端。

配置

如何获取FattureInCloud凭据： 登录 FattureInCloud首选 *设置→ API和集成*，创建一个 手动令牌 拥有您所需的权限。这 COMPANY_ID 位于URL之后 /c/ 一旦你选择了一家公司。

使用示例

示例1——为已知客户创建发票

“找到客户‘Acme Srl’，并为2026年11月的咨询服务创建一张1500欧元+增值税的发票草稿，在30天内支付给收入中心‘Project Alpha’。”

克劳德将：

1. 呼叫 list_clients （缓存）并选择匹配的客户端
2. 呼叫 list_cost_centers （缓存）以验证 Project Alpha 存在
3. 呼叫 create_invoice 随着 client_id、项目、日期、付款条件，以及 revenue_center="Project Alpha"
4. 返回草稿编号并询问是否将其发送给SDI

示例2——成本中心分析

“2025年，我在‘阿尔法项目’收入中心的账单是多少？按月细分。”

克劳德将：

1. 呼叫 list_cost_centers 确认标签
2. 呼叫 list_invoices 2025年（结果包括 revenue_center 每张发票（设置时）
3. 筛选依据 revenue_center == "Project Alpha" 按月汇总

示例3——重复发票回放

“复制2025年10月向‘经常性客户公司’开具的每张发票，将新日期设置为11月，保留30天的付款期限。”

克劳德将：

1. 呼叫 list_invoices 随着 query="Recurring Customer Co" 和 month=10, year=2025
2. 对于每个结果，调用 duplicate_invoice 随着 new_date 设定于11月
3. 返回新发票草稿列表，并在发送前询问

缓存

为了最大限度地减少对FatureInCloud API的冗余调用，此服务器将客户端查找和成本中心列表缓存为本地JSON文件（默认位置 ~/.fattureincloud-mcp/cache/，范围按 company_id24小时TTL）。缓存是透明的：工具签名不会改变。

# Force refresh:
rm -rf ~/.fattureincloud-mcp/cache

# Disable temporarily:
export FIC_CACHE_DISABLED=1

成本/收入中心

FattureInCloud为成本中心（在供应商文件上）和收入中心（在已发布的文件上）使用一个共享注册表。使用此服务器，您可以：

• list_cost_centers --读取注册表
• revenue_center="" --分配时间 create_invoice, create_credit_note, create_proforma, convert_proforma_to_invoice, update_document, duplicate_invoice
• cost_center="" --分配时间 create_received_document

标签必须已经存在；中心由FattureInCloud的web UI（设置→ 成本中心）。传递未知标签会在错误消息中返回有效标签的列表。

隐私和数据处理

• API调用go 直接 从您的计算机到FattureInCloud的服务器(api-v2.fattureincloud.it).没有数据通过Mediaform或任何第三方服务器路由。
• 本地缓存是主目录中的纯文本JSON。你控制它。
• 凭据仅存在于您的 .env （gitignored）、shell或MCP客户端 user_config。它们从未被记录或传输给FattureInCloud以外的任何人。
• 完整隐私政策： https://media-form.it/privacy-policy.html
• 另见 docs/PRIVACY.md 获取策略的镜像副本。

已知问题

• 对于某些客户，发票复制可能会失败。 特定的客户端配置会触发尚未再现的故障路径。解决方法：从FattureInCloud web面板手动复制。已追踪 docs/KNOWN_ISSUES.md --请通过以下方式报告一个可重复的案例 .

贡献

问题和拉取请求欢迎访问https://github.com/aringad/fattureincloud-mcp.

对于任何代码更改：

1. 叉和分支从 main (feat/..., fix/..., docs/...).
2. 跑 pytest tests/ --所有39项测试必须保持绿色。
3. 针对成本中心/缓存/新工具的新代码应随测试一起提供（新模块的目标覆盖率≥80%）。
4. 常规提交风格(feat:, fix:, docs:, chore:, test:).
5. 打开一个PR。维护人员根据FatureInCloud API合同审查更改。

安全

有关漏洞披露，请参阅 SECURITY.md.首选频道： .

许可证

麻省理工学院——见 LICENSE.

商标

“FattureInCloud”是TeamSystem S.p.a.的商标。这是一个独立的、社区构建的集成。它不隶属于TeamSystem S.p.A.，也不由其背书或赞助。该商标仅用于描述目的（表示该软件可与之互操作的第三方服务）。

作者/支持

• 维护人员： Mediaform s.c.r.l。 --意大利热那亚
• 问题：https://github.com/aringad/fattureincloud-mcp/issues
• 电子邮件：assistenza@mediaform.it