Fattureincloud MCP

🚀 Fatture in Cloud MCP Server

這是一個MCP（模型上下文協議）服務器，用於將 Fatture in Cloud 與Claude AI及其他兼容助手集成。藉助該服務器，你可以通過自然對話的方式管理意大利電子發票。

🚀 快速開始

本項目可讓你通過自然對話管理意大利電子發票，下面是使用前的準備步驟。

✨ 主要特性

📦 安裝指南

前提條件

• 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

如何獲取憑證：

1. 登錄 Fatture in Cloud。
2. 轉到 設置 > API和集成。
3. 創建具有所需權限的 手動令牌。
4. 登錄後，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. 開發，位於意大利熱那亞。