JinDaGe - fattureincloud-mcp MCP Details

article

README

🚀 Fatture in Cloud MCP Server

这是一个MCP（模型上下文协议）服务器，用于将 Fatture in Cloud 与Claude AI及其他兼容助手集成。借助该服务器，你可以通过自然对话的方式管理意大利电子发票。

🚀 快速开始

本项目可让你通过自然对话管理意大利电子发票，下面是使用前的准备步骤。

✨ 主要特性

| 工具 | 描述 | |------|-------------| | list_invoices | 按年/月列出已开具发票 | | get_invoice | 获取发票完整详情 | | list_clients | 带筛选的客户列表 | | get_company_info | 获取关联公司信息 | | create_invoice | 创建新发票（草稿） | | duplicate_invoice | 复制现有发票 | | send_to_sdi | 将发票发送至SDI（意大利电子发票系统） | | get_invoice_status | 获取电子发票状态 | | send_email | 通过电子邮件发送发票副本 | | list_received_documents | 列出收到的发票（供应商发票） | | get_situation | 仪表盘：收入、收款、成本 |

📦 安装指南

前提条件

Python 3.10 及以上版本
拥有已启用API的 Fatture in Cloud 账户
安装 Claude Desktop 或其他MCP客户端

步骤

1. 克隆仓库

git clone https://github.com/aringad/fattureincloud-mcp.git
cd fattureincloud-mcp

2. 创建虚拟环境并安装依赖

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或者：venv\Scripts\activate  # Windows

pip install -r requirements.txt

3. 配置凭证

复制示例文件并填入你的数据：

cp .env.example .env

编辑 .env 文件：

FIC_ACCESS_TOKEN=a/xxxxx.yyyyy.zzzzz
FIC_COMPANY_ID=123456
FIC_SENDER_EMAIL=fatturazione@tuaazienda.it

如何获取凭证：

登录 Fatture in Cloud。
转到 设置 > API和集成。
创建具有所需权限的 手动令牌。
登录后，COMPANY_ID 可在URL中看到。

4. 配置Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "fattureincloud": {
      "command": "/percorso/completo/fattureincloud-mcp/venv/bin/python",
      "args": ["/percorso/completo/fattureincloud-mcp/server.py"],
      "env": {
        "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz",
        "FIC_COMPANY_ID": "123456",
        "FIC_SENDER_EMAIL": "fatturazione@tuaazienda.it"
      }
    }
  }
}

5. 重启Claude Desktop

完全退出Claude Desktop（Mac上使用Cmd + Q），然后重新打开。

💻 使用示例

基础用法

"Mostrami le fatture di dicembre 2024"
"Qual è la situazione finanziaria del 2025?"
"Duplica la fattura 310 cambiando 2025 in 2026"
"Invia la fattura 326 allo SDI"
"Manda la copia cortesia via email"
"Quali fatture devo ancora incassare?"

英文使用示例

"Show me invoices from December 2024"
"What's the financial situation for 2025?"
"Duplicate invoice 310 changing 2025 to 2026"
"Send invoice 326 to SDI"
"Send the courtesy copy via email"
"Which invoices are still pending payment?"

⚠️ 重要提示

⚠️ 重要提示

写操作（创建、发送至SDI）始终需要确认。

发送至SDI是不可逆的。

发票创建为草稿形式。

默认付款方式为MP05（银行转账）。

📄 许可证

本项目采用MIT许可证，详情请参阅 LICENSE。

👨‍💻 作者

本项目由 Mediaform s.c.r.l. 开发，位于意大利热那亚。

fattureincloud-mcp