p4compara-mcp

P4 三表推移（管理会計SaaS）のMCPサーバーです。Claude Code や Cursor などのAIエージェントから財務データに直接アクセスし、分析を行うことができます。

特徴

• APIキーのみで利用開始 — OAuth認証不要、環境変数1つで接続
• プロジェクト単位のアクセス制御 — APIキーがプロジェクトに紐づくため projectId パラメータは省略可
• freee / マネーフォワード対応 — P4 Comparaが連携済みの会計ソフトからデータを取得
• 日本語Markdown出力 — LLMが解釈しやすい表形式で財務データを返却

クイックスタート

1. APIキーの取得

P4 Compara アプリの 設定 → データ連携 → MCPサーバー セクションでAPIキーを発行してください。

2. MCP設定ファイルに追加

Claude Code（CLI）

.claude/mcp.json に追加：

{
  "mcpServers": {
    "p4compara": {
      "command": "npx",
      "args": ["-y", "p4compara-mcp"],
      "env": {
        "P4C_API_KEY": "p4c_your-api-key-here"
      }
    }
  }
}

Cursor / VS Code（Claude Code拡張）

プロジェクトルートの .mcp.json に追加：

{
  "mcpServers": {
    "p4compara": {
      "command": "npx",
      "args": ["-y", "p4compara-mcp"],
      "env": {
        "P4C_API_KEY": "p4c_your-api-key-here"
      }
    }
  }
}

設定後、AIエージェントを再起動すれば利用開始できます。

利用可能なツール

APIキーのみで利用可能（10ツール）

| ツール | 説明 | |--------|------| | list_projects | プロジェクト一覧（名前・ステータス・会計ソフト・ロール） | | get_financial_statements | PL/BS/CFの月次推移データ（千円単位Markdown表） | | detect_anomalies | 13種類のルールによる財務データの異常検出 | | get_fiscal_years | 同期済みの会計年度とデータ期間 | | get_account_settings | 勘定科目のPL/BS分類設定 | | get_anomaly_settings | 異常検知の閾値・ルール設定 | | get_custom_metrics | カスタム経営指標（KPI）の定義 | | get_sync_status | 会計ソフトとの接続・同期状態 | | get_comments | 財務諸表セルのコメント（フィルタ対応） | | add_comment | 財務諸表セルへのコメント追加 |

開発者モード（追加の環境変数が必要）

以下のツールは会計ソフトのOAuthトークンへのアクセスが必要なため、SUPABASE_SERVICE_ROLE_KEY 環境変数が必要です：

| ツール | 説明 | |--------|------| | trigger_sync | 会計ソフト（freee/マネーフォワード）からデータ同期を実行 |

使い方の例

AIエージェントに話しかけるだけで、必要なツールが自動的に呼び出されます。

分析・レビュー（複数ツールの自動連携）

「直近12ヶ月の財務データをレビューして、気になる点を指摘して」
→ get_financial_statements + detect_anomalies が自動で呼ばれ、
  三表の推移と異常検知結果を総合的に分析し、レビューコメントを生成

「前年比で大きく変動した科目とその原因仮説を整理して」
→ get_financial_statements が呼ばれ、前年同期比で重要な変動を抽出し、
  考えられる要因をAIが列挙

「預り金や仮払金の滞留リスクをチェックして」
→ detect_anomalies が呼ばれ、仮勘定滞留・預り金精算漏れルールの
  検出結果をAIが解釈し、対応の優先度を提案

データの確認・操作

「プロジェクト一覧を見せて」
→ list_projects でプロジェクト名・会計ソフト・ロールの一覧を表示

「2025年度のPLとBSを見せて」
→ get_financial_statements で月次推移の損益計算書と貸借対照表を取得

「売上高の3月セルにコメント：前年比20%増の要因を確認」
→ add_comment で指定セルにコメントを投稿

動作要件

• Node.js 20 以上
• P4 三表推移の有効なアカウントとAPIキー

関連リンク

• P4 三表推移 — 製品紹介ページ