filevine-mcp

filevine-mcp

一个用于 Filevine 事务管理和 Lead Docket 客户线索登记的开源 MCP（Model Context Protocol）服务。

由 Advocate Cloud Solutions 构建并维护——一家为律师事务所提供 Salesforce 咨询服务的公司。此 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 解锁的三种工作流：

• 提取——“显示本周 PPC 营销活动中所有尚未联系的 Lead Docket 客户线索，以及所有处于诉前阶段且超过 90 天的 Filevine 项目。”
• 修复——“项目 78213 的保单限额字段有误——应为 $250K，而不是 $25K。请更新并添加备注。此外，将这条恶意拒赔的 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 组织管理工具中生成 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 个工具：25 个 Filevine 核心工具 + 7 个 Lead Docket 工具。

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 界面写入）
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 周）— Section 写入、创建备注/任务、集合 CRUD、文档上传
4. Filevine 报告 + 缓存（4-6 周）— 报告工具、物化缓存、Periscope 透传
5. Lead Docket 子模块（2-3 周）— 7 个工具、独立身份验证、潜在客户转项目桥接
6. 强化 + CPI（3-4 周）— Certified Partner Integration 申请、安全审查、错误分类、可观测性

完整路线图：ROADMAP.md。

状态

预 Alpha 阶段 — 已注册命名空间、已搭建脚手架，核心实现尚未开始。

注册目录中的首个 Filevine + Lead Docket MCP。Filevine 尚未宣布推出官方 MCP 服务。

贡献

欢迎外部贡献。请参阅 CONTRIBUTING.md。

许可证

Apache 2.0 — 请参阅 LICENSE。

联系方式

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