lawmatics-mcp

Lawmatics MCP 服务

将 Claude 连接到你的 Lawmatics 法律 CRM。让 Claude 调取 Lawmatics 无法原生生成的管道报告、查询案件和联系人、检查接收表单提交内容、创建后续跟进任务——全程无需离开当前对话。

由 Oktopeak 构建——为律师事务所提供 AI 转型与自动化

为法律和医疗健康企业提供数字化转型服务。 我们构建 AI 集成、工作流自动化和由你的律所完全拥有的定制软件——包括这个连接器。→ 预约 30 分钟通话

提示

不是开发者？也没关系。

以下 README 假设读者熟悉编辑 JSON 配置文件。如果你或你的团队不熟悉，我们可以为律师事务所部署此工具——配置限定范围的凭据、按需启用只读模式、接入审计日志、构建一个定制工作流，并提供培训。

→ 整个律所使用？律所方案：每月 $300。 部署在你自己的云环境中，每位律师使用自己的账号登录，共用一份审计日志，每月为你构建一项自动化，无设置费，随时可取消。→ oktopeak.com/firm-plan/，或预约 30 分钟通话

跳转至： 功能介绍 · 安装 · 获取 API 访问权限 · 可用工具 · 只读模式 · 安全性 · 已知 API 限制 · 其他 Oktopeak 连接器 · 需要我们为你部署？

---

功能介绍

连接后，Claude 可以直接访问你律所的 Lawmatics 数据。你可以这样提问：

• “每个业务领域有多少个未结 PNC？”
• “本季度哪些营销来源带来了我们实际签约的案件？”
• “列出所有处于‘咨询已完成’阶段且未关联任务的案件”
• “导出 7 月份所有人身伤害潜在客户及其自定义接收字段”
• “本周 Smith 接收表单的提交内容是什么？”
• “为 Jones 案件创建一项周五到期、分配给 Sarah 的后续跟进任务”

Lawmatics 内置的报告功能是许多律所常见的抱怨之处。使用此连接器后，Claude 将成为报告层：它会提取原始记录（包括自定义字段），并自行完成汇总、交叉制表和格式整理。

项目状态

此服务严格依据官方 Lawmatics API 文档（v1.22）及其公开的示例载荷构建，并通过 80 多项单元测试确保请求/响应符合文档约定。目前尚未在真实律所账户上运行——如果你发现实际 API 与预期不符，请提交 issue，注明工具名称和错误文本。开源项目的意义就在于此：真实使用反馈能让它变得更加可靠，造福所有人。

---

前置条件：获取 Lawmatics API 访问权限

• Node.js 18+
• 拥有管理员权限的 Lawmatics 账户
• 账户已启用 Developer Settings。Lawmatics 需要通过支持请求开通 API 访问权限：联系 Lawmatics 支持 或发送邮件至 [email protected]，请他们为你启用 Developer Settings。此服务免费，只是默认未开启。
• 一个 开发者应用：启用 Developer Settings 后，前往 Lawmatics 中的 设置 → 开发者，创建应用，并将 Callback URL 设置为 http://localhost:5678/callback。你将获得 Client ID 和 Client Secret。

获取访问令牌（仅需一次）

Lawmatics 访问令牌永不过期，因此只需执行一次：

LAWMATICS_CLIENT_ID=your_client_id LAWMATICS_CLIENT_SECRET=your_client_secret npx -y @oktopeak/lawmatics-mcp auth

打开打印出的 URL，批准访问权限，命令便会输出你的令牌以及可直接粘贴的配置片段。请像密码一样妥善保管令牌——任何持有令牌的人都能完全访问你律所的 Lawmatics 数据，直到你删除开发者应用。

安装

使用 Claude Desktop（推荐）

将以下内容添加到 Claude Desktop 配置文件中：

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

{
  "mcpServers": {
    "lawmatics": {
      "command": "npx",
      "args": ["-y", "@oktopeak/lawmatics-mcp"],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

重启 Claude Desktop。询问 “我在 Lawmatics 中以哪个账户登录？”，以验证连接（这会调用 get-current-user）。

使用 Claude Code

claude mcp add lawmatics -e LAWMATICS_ACCESS_TOKEN=your_token_here -- npx -y @oktopeak/lawmatics-mcp

---

可用工具

37 个工具。 Lawmatics 在内部将事项（Matters）称为“潜在客户”——包括每条线索和案件，无论其状态是 PNC、已聘用还是流失。

分组	工具
事项	list-matters、get-matter、find-matter（按邮箱/电话/姓名查找）、create-matter、update-matter
联系人	list-contacts、get-contact、find-contact、create-contact、update-contact
公司	list-companies、get-company、find-company
流程与律所数据	list-pipelines、list-stages、list-practice-areas、list-sources、list-sub-statuses、list-users、get-current-user
任务	list-tasks、create-task、update-task
事件	list-events、create-event
备注与时间线	list-notes、create-note、list-activities
标签	list-tags、attach-tags、detach-tags
自定义字段	list-custom-fields（另有实验性工具 set-matter-custom-fields，见下文）
接待表单	list-forms、get-form、get-form-entries、submit-form
账单	list-invoices（Lawmatics API 中仅支持读取）

每个列表工具都支持完整的 Lawmatics 查询功能：一个筛选条件（filter_by / filter_on / filter_with，支持 =、!=、<、>、like、ilike、null、not_null）、排序、字段选择（fields，包括 custom_fields）和分页；还支持 fetch_all 选项，可跟随分页获取最多 1,000 条记录，并始终告知结果是否已截断。

自定义字段

Lawmatics 律所数据主要存放在自定义字段中。若要读取这些字段，请将 custom_fields 添加到任意 get/list 工具的 fields 参数中。list-custom-fields 会显示所有字段定义及其选项列表，让 Claude 能够解读原始值。

Lawmatics 对自定义字段值的写入说明较为有限，因此 set-matter-custom-fields 默认通过标志关闭，直到有使用在线账户的用户确认请求格式（设置 LAWMATICS_EXPERIMENTAL_TOOLS=1 即可启用；也请反馈该功能是否有效）。

只读模式

在服务的环境配置中设置 LAWMATICS_READ_ONLY=1，所有写入工具（创建/更新/标记/提交）都会被彻底移除——不仅仅是禁止使用，在 Claude 看来它们根本不存在。建议首次部署、仅用于报告以及需要谨慎使用的合作伙伴启用此模式。

配置参考

环境变量	用途
LAWMATICS_ACCESS_TOKEN	必需。 您的 OAuth 访问令牌（永不过期）。
LAWMATICS_READ_ONLY	1 = 禁用所有写入工具。
LAWMATICS_EXPERIMENTAL_TOOLS	1 = 启用 API 规范尚未由 Lawmatics 完整记录的工具。
LAWMATICS_RATE_LIMIT_PER_MIN	客户端限流。默认值为 50（Lawmatics 文档中同时提到 50 次/分钟和 150 次/分钟；我们默认采用更安全的值）。
LAWMATICS_AUDIT_LOG	0 = 禁用本地审计日志。
LAWMATICS_AUDIT_LOG_PATH	审计日志位置（默认值为 ~/.lawmatics-mcp/audit.log）。
LAWMATICS_CLIENT_ID / LAWMATICS_CLIENT_SECRET	仅用于一次性 auth 命令。
LAWMATICS_REDIRECT_PORT	OAuth 回调端口（默认值为 5678）。
LAWMATICS_API_BASE	API 基础地址覆盖项（默认值为 https://api.lawmatics.com/v1）。

安全

• 您的令牌会留在您的设备上。 它存储在您的 MCP 配置文件中，并且只会发送到 api.lawmatics.com。此服务没有后端、没有遥测，也不会向任何人发送数据。
• 审计日志。 每次工具调用（名称、参数、结果）都会追加到本地 JSONL 文件 ~/.lawmatics-mcp/audit.log 中，因此律所管理员始终可以回答“AI 操作了哪些内容”。请注意，工具参数可能包含客户数据（姓名、电子邮件、备注文本）——日志仅存储在您的设备上，但请将其纳入律所的数据保留政策，或通过 LAWMATICS_AUDIT_LOG=0 禁用日志。
• 最小权限注意事项。 Lawmatics API 不提供作用域：任何令牌都有完整的 CRUD 访问权限。只读模式由此服务执行，而非 Lawmatics 执行——请同时启用审计日志；如需彻底撤销访问权限，请删除开发者应用。
• 数据流。 记录的 Claude 请求会从 Lawmatics 经过此本地进程，进入您的 MCP 客户端及其模型上下文。请像对待任何接触客户数据的供应商一样，查阅 AI 提供商的数据处理条款。

已知的 Lawmatics API 限制

由于底层 API 不支持，以下操作无法通过此连接器完成（截至 API v1.22）：

• 无法移动管道阶段。 API 仅提供只读的阶段；更新 matter 时，sub_status_id 是最接近的控制方式。
• 每个请求只能使用一个筛选条件。 复杂查询需要使用 fetch_all，再让 Claude 筛选结果。
• 页大小固定为 25。 大型导出每 25 条记录需要发送一个请求（内置限流会遵守速率限制）。
• 发票、管道、来源、营销活动均为只读。
• 无法通过 API 管理电子签名、文档模板、电子邮件发送或自动化。
• 只能在 Lawmatics 控制面板中配置 Webhook（无法通过 API 管理）。

路线图

文件上传/下载、时间条目与费用、关系、任务子任务/评论，以及 Collections（Lawmatics 的自定义数据表）——大致按需求顺序排列。如果您希望尽快支持某项功能，请提交 issue。

Oktopeak 的其他连接器

每个连接器在 oktopeak.com 上都有自己的概览页面，包含设置说明和常见问题解答：

• Clio MCP：Clio 业务管理。源码：github.com/oktopeak/clio-mcp
• MyCase MCP：MyCase 业务管理。源码：github.com/oktopeak/mycase-mcp
• Filevine MCP：Filevine 案件管理。源码：github.com/oktopeak/filevine-mcp
• IntakeQ MCP：IntakeQ / PracticeQ 接待管理（医疗保健）

架构相同，审计日志记录方式也相同。均采用 MIT 许可证。

需要的不只是连接器？

连接器免费，而且会一直免费。律所聘请我们提供与之配套的服务：在每位律师的电脑上部署、限定凭证权限、自定义工作流（“每天早上，按来源列出昨天新增的潜在客户及其接待问卷回答”）、集成 Lawmatics 尚不支持的服务，以及在你不再满足于 Zapier 时提供生产级软件层。

→ 整个律所都要用？律所方案：每月 300 美元。 在你自己的云环境中设置，每位律师使用自己的账号登录，统一审计日志，每月为你构建一项自动化，无设置费，可随时取消。→ oktopeak.com/firm-plan/ · 预约 30 分钟通话

想要一份介绍此连接器并附带常见问题解答的精美概览？→ oktopeak.com/lawmatics-mcp/

支持此项目

此连接器免费、采用 MIT 许可证，并由 Oktopeak 维护。它将始终如此；我们不接受捐赠。如果它为你节省了时间，以下事情确实能帮上忙：

• 为此仓库点星。 其他律所正是通过这种方式找到它的。
• 告诉另一家 正在使用 Lawmatics 的律所。
• 如果我们直接帮到了你，请 留下评价。
• 需要为你的律所部署、扩展或维护？商业支持；这正是支持免费工作的资金来源。

开发

npm install
npm test          # 80+ unit tests against the documented API contract
npm run build
npm run inspect   # MCP Inspector against the built server

欢迎贡献——尤其欢迎分享来自真实 Lawmatics 账号的报告。

许可证

MIT © Oktopeak