eqvitta-mcp

Eqvitta Accounting MCP Server

Eqvitta Cloud Accounting & GST Billing 向けの公式 Model Context Protocol (MCP) サーバーです。

Claude Desktop、Claude Code、および MCP に準拠したあらゆる AI クライアントを、Eqvitta の会計記録に直接接続できます。GST 売上・仕入請求書の作成、元帳の管理、領収・支払の記帳、試算表の照会、財務諸表の照合を、厳格なロールベースのデータ分離のもとでシームレスに行えます。

---

⚡ Claude Desktop ですぐに始める

自動ワンクリックインストール（Smithery）

Smithery を使用する場合：

npx -y @smithery/cli install eqvitta-mcp --client claude

---

手動設定

サーバーを claude_desktop_config.json に追加します：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "eqvitta": {
      "command": "npx",
      "args": ["-y", "github:Eqvitta/eqvitta-mcp"],
      "env": {
        "EQVITTA_API_KEY": "YOUR_EQVITTA_API_KEY_HERE"
      }
    }
  }
}

API キーの取得方法：Eqvitta にログインし、Settings > API Keys > 新しいキーを生成します。

---

🚀 主な機能

• GST 請求書：
  • CGST、SGST、IGST、および端数処理を自動計算します。
  • 次の連番の請求書番号（例：NR/2627/005）を自動で割り当てます。
  • 貸借が一致する複式簿記の元帳記帳を即座に作成します。
• 元帳と勘定科目グループ：
  • 元帳、未決済残高、取引先の連絡先情報、勘定科目グループの構成を検索できます。
• 伝票と取引：
  • 顧客、仕入先、費用元帳に対する銀行／現金の領収と支払を記録します。
  • サービスの売上・仕入請求書を記録します。
• リアルタイム財務レポート：
  • 試算表、損益概要、元帳勘定明細書を即座に取得できます。
• ロールベースのセキュリティ：
  • マルチテナントの分離を実現します。すべての操作は、API キーユーザーに割り当てられた会社に限定されます。
  • 破壊的な操作（編集と削除）は、MCP 経由では厳格に無効化されています。
  • 元帳間の内部振替と財務調整には、昇格された管理者権限（financialreporteditor または company_admin）が必要です。

---

🛠️ 利用可能な MCP ツール

カテゴリ	ツール	説明
会社と元帳	list_companies, search_ledgers, get_ledger_balance, get_ledger_statement, update_ledger_contact	会社を確認し、残高を照会して、明細項目を表示します。
在庫とカタログ	search_stocks, get_stock_detail, search_account_groups	在庫品目、数量、HSN/SAC コード、勘定科目グループを検索します。
請求書	create_sales_invoice, create_purchase_invoice, create_service_outward, create_service_inward, create_logistic_invoice	GST に準拠した売上、仕入、サービス、貨物の伝票を作成します。
領収と支払	create_receipt_voucher, create_payment_voucher	銀行／現金勘定に対する顧客からの入金と仕入先への支払を記録します。
財務レポート	get_trial_balance, get_financial_statement	構造化された貸借対照表と損益の数値を取得します。
納品書	search_challans, get_challan_detail	納品および輸送の納品書を追跡します。
管理者による振替 (制限あり)	transfer_ledger_journal, transfer_group_balances_journal, bulk_transfer_transactions_ledger	元帳項目を移動し、残高を振り替えます（認可されたロールにのみ表示されます）。

---

🔒 セキュリティとアーキテクチャ

eqvitta-mcp CLI は、Eqvitta の高可用性リモートエンジン（https://chatapi.eqvitta.com/webhook/mcp）に接続します。

• ローカルでの保守は不要：スキーマの変更と会計ルールの更新はすべてクラウドエンジンで管理されます。クライアントのバージョンを手動で更新する必要はありません。
• 暗号化通信：すべての通信は TLS 1.3 で暗号化されます。
• 最小権限：ユーザーのロールで許可されたツールのみが AI モデルに公開されます。

---

📄 ライセンス

MIT License。Copyright (c) 2026 Eqvitta Software Solutions。