filevine-mcp

filevine-mcp

Filevine の案件管理と Lead Docket のインテークに対応する、オープンソースの MCP（Model Context Protocol）サーバーです。

法律事務所向けの Salesforce コンサルティング会社である Advocate Cloud Solutions が開発・保守しています。この MCP は、Filevine と Lead Docket の API 機能を Claude から呼び出せるツールとして公開するため、法律チームは自然言語で案件やインテークのリードを検索、作成、修正できます。すべてご自身のマシン上で、ご自身の Filevine 組織に接続して動作します。

---

これは何ですか

Filevine は、中規模市場向けの人身傷害・集団不法行為訴訟案件管理プラットフォームのリーディングサービスです（約3,000の法律事務所が利用。2025年9月に4億ドルのシリーズ資金調達）。Lead Docket は Filevine が買収したインテーク／CRM 製品です。ウェブフォーム、チャットボット、電話からのリードを取り込み、スコアリングや振り分けを行い、Filevine のプロジェクトに変換します。

filevine-mcp は、スタンドアロンのシングルテナント MCP サーバーです。ご自身の Filevine PAT を生成し、サーバーをローカル（またはご自身で管理するインフラストラクチャ）で実行して、MCP 対応クライアント（Claude Desktop、Claude Code、Cowork、その他 MCP に対応するもの）に接続します。

この MCP は、Filevine と Lead Docket の両方を単一の名前空間でラップするため、インストールするだけで、インテークから案件化までの全プロセスに Claude がアクセスできます。

この MCP で実現できる3つのワークフロー：

• 取得 — 「今週の PPC キャンペーンからの Lead Docket のリードのうち、まだ連絡していないものをすべて表示して。さらに、訴訟前の段階にあり、90日以上経過した Filevine のプロジェクトもすべて表示して。」
• 修正 — 「プロジェクト 78213 の保険限度額フィールドが間違っています。25,000ドルではなく、250,000ドルにしてください。値を更新してメモも追加してください。また、不誠実な対応の Lead Docket リードをシニアの人身傷害担当パートナーに再割り当てしてください。」
• 作成 — 「この Lead Docket リードを新しい Filevine の人身傷害プロジェクトに変換し、リードのフォームデータからインテークセクションに値を入力して、相談の予定を設定してください。」

クイックスタート

git clone https://github.com/Advocate-Cloud-Solutions/filevine-mcp.git
cd filevine-mcp
npm install
cp .env.example .env  # fill in your Filevine PAT, client_id, client_secret
npm run build

次に、Claude Desktop の設定（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "filevine": {
      "command": "node",
      "args": ["/absolute/path/to/filevine-mcp/dist/index.js"],
      "env": {
        "FILEVINE_CLIENT_ID": "...",
        "FILEVINE_CLIENT_SECRET": "...",
        "FILEVINE_PAT": "...",
        "FILEVINE_USER_ID": "...",
        "FILEVINE_ORG_ID": "..."
      }
    }
  }
}

Filevine の Org Admin ツールで PAT を生成する方法など、セットアップの詳しい手順については、AGENTS.md をご覧ください。

アーキテクチャの概要

• Filevine の PAT 交換認証。Lead Docket には別の API キーを使用します（どちらも環境変数から読み込みます）。
• 動的なスキーマのイントロスペクション — Filevine では法律事務所ごとに Project Type のテンプレートが異なるため、書き込みツールはすべて実行時にスキーマを検出する必要があります（メモリ内で1時間キャッシュ。force_refresh フラグあり）。
• レート制限ガバナー — エンドポイントごとのトークンバケット（Filevine：一般 320/分、請求 250/分、Reports と Vitals は5/分。Lead Docket：独自の制限に応じた個別のバケット）。
• 任意の監査ログ記録 — ABA Opinion 512 に準拠した JSONL 監査ログ。デフォルトでは無効で、AUDIT_LOG_PATH によりオプトインできます。

アーキテクチャの全容については、ARCHITECTURE.md をご覧ください。Lead Docket 固有の設計メモについては、docs/LEAD_DOCKET.md をご覧ください。

ツール一覧

合計約32個のツール：Filevine コア25個 + Lead Docket 7個。

Filevine コア（25個のツール）

ツール	機能
filevine_search_projects	フェーズ、プロジェクトタイプ、担当者、日付でプロジェクトを検索します
filevine_describe_sections	プロジェクトタイプの完全なスキーマ（セクション、フィールド、型）を返します
filevine_get_section / filevine_update_section	静的セクションのフィールド値を読み取り／書き込みします
filevine_create_collection_item	Collection セクションに行を追加します（医療提供者、被告など）
filevine_create_note	@メンションや添付ファイル付きのメモを追加します
filevine_run_report	保存済みの Periscope レポートを実行します（5/分の上限があるため、頻繁にキャッシュされます）

Lead Docket（7 個のツール）

ツール	機能
filevine_lead_search	ステータス、ソース、担当者、期間でリードを検索します
filevine_lead_get	リードの完全な受付フォームデータとスコアリングを取得します
filevine_lead_create	リードを作成します（手動入力。ウェブフォームからの入力は Lead Docket UI 経由です）
filevine_lead_update_status	リードのステータスを変更します（新規 → 連絡済み → 適格 → 成約／辞退）
filevine_lead_assign	リードを別の受付担当者または弁護士に再割り当てします
filevine_lead_convert_to_project	適格なリードを Filevine プロジェクトに変換します。フォームデータは受付セクションに引き継がれます
filevine_lead_list_sources	振り分けの判断に使用するリードソース（PPC キャンペーン、紹介、ウェブフォーム）を一覧表示します

全ツール一覧：docs/TOOLS.md。

ロードマップ

6 フェーズで構築し、v1 まで約 17～25 人週です。

1. 調査とサンドボックス（1～2 週間）— エンジニア用アカウントの確保、エンドポイントの検証、型システムの草案作成
2. Filevine 読み取り専用 MCP（4～6 週間）— 読み取りツール 10 個、PAT の交換、レート制限の制御
3. Filevine 書き込みツール（3～4 週間）— セクションへの書き込み、ノート／タスクの作成、コレクションの CRUD、ドキュメントのアップロード
4. Filevine レポートとキャッシュ（4～6 週間）— レポートツール、マテリアライズドキャッシュ、Periscope パススルー
5. Lead Docket サブモジュール（2～3 週間）— ツール 7 個、個別の認証、リードからプロジェクトへの変換ブリッジ
6. 堅牢化と CPI（3～4 週間）— 認定パートナー統合の申請、セキュリティレビュー、エラー分類、可観測性

ロードマップ全文：ROADMAP.md。

ステータス

プレアルファ — 名前空間は確保済み、骨組みは配置済み、コア実装はこれからです。

レジストリ初の Filevine + Lead Docket MCP です。Filevine はファーストパーティサーバーを発表していません。

貢献

外部からの貢献を歓迎します。CONTRIBUTING.mdをご覧ください。

ライセンス

Apache 2.0 — LICENSEをご覧ください。

お問い合わせ

Jason Adams · Advocate Cloud Solutions [email protected] · advocatecloudsolutions.com