Fattureincloud MCP

🚀 Fatture in Cloud MCP Server

このサーバーは、Fatture in Cloud をClaude AIやその他の互換性のあるアシスタントと統合するためのMCP（Model Context Protocol）サーバーです。自然な会話を通じて、イタリアの電子請求書を管理することが可能です。

🚀 クイックスタート

Server MCP (Model Context Protocol) を使用することで、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=billing@yourcompany.com

認証情報の取得方法:

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": "/full/path/to/fattureincloud-mcp/venv/bin/python",
      "args": ["/full/path/to/fattureincloud-mcp/server.py"],
      "env": {
        "FIC_ACCESS_TOKEN": "a/xxxxx.yyyyy.zzzzz",
        "FIC_COMPANY_ID": "123456",
        "FIC_SENDER_EMAIL": "billing@yourcompany.com"
      }
    }
  }
}

5. Claude Desktopを再起動する

Claude Desktopを完全に終了し（MacではCmd+Q）、再開します。

💻 使用例

基本的な使用法

"2024年12月の請求書を見せて"
"2025年の財務状況はどうですか？"
"請求書310を複製し、2025年を2026年に変更する"
"請求書326をSDIに送信する"
"礼儀コピーを電子メールで送信する"
"まだ入金待ちの請求書はどれですか？"

⚠️ 重要提示

⚠️ 重要提示

• 書き込み操作（作成、SDIへの送信）は常に確認が必要です。
• SDIへの送信は不可逆的です。
• 請求書は下書きとして作成されます。
• デフォルトの支払い方法はMP05（銀行振込）です。

📄 ライセンス

MIT - LICENSE を参照してください。

👨‍💻 作者

このプロジェクトは、Mediaform s.c.r.l.（イタリア、ジェノバ）によって開発されました。