mycase-mcp

MyCase MCP 服务

将 Claude 连接到您的 MyCase 法律业务管理系统。让 Claude 查找案件、搜索联系人、查看日历、审查账单——所有操作都无需离开当前对话。

由 Oktopeak 打造——为律师事务所提供 AI 转型与自动化服务

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

提示

不是开发人员？也没关系。

以下 README 假设读者熟悉如何编辑 JSON 配置文件。如果您或您的团队不熟悉，我们可以为律师事务所部署此服务——配置限定范围的凭据、接入审计日志、打造一个定制工作流并提供培训。

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

快速跳转： 演示 · 安装 · 可用工具 · 安全性 · 需要我们为您部署？

---

演示

观看 Claude 在不到一分钟内从 MyCase 获取实时数据——案件、联系人、文档、日历——无需将客户信息复制到聊天中。

▶  在 YouTube 上观看 60 秒演示

---

为使用 Claude + MyCase 构建方案的事务所提供设置技巧和 ABA Opinion 512 合规更新。

→ 订阅 Oktopeak Builder Notes——简短邮件，可轻松取消订阅。

---

功能介绍

连接后，Claude 可直接访问您事务所的 MyCase 数据。您可以提出以下问题：

• “Jane Smith 有哪些未结案件？”
• “显示本周到期的所有任务”
• “Anderson 案件的未结余额是多少？”
• “记录与客户 #1234 的一次 20 分钟通话，主题是和解”
• “列出附加到案件 98765 的文档”

所有操作均通过 MyCase 官方 OAuth 2.0 API 完成。您的凭据不会离开您的设备——令牌会在本地存储，并使用 AES-256-GCM 加密。

---

先决条件

• Node.js 18+
• 拥有管理员访问权限的 MyCase 账号
• MyCase API 凭据——请联系 MyCase 支持团队，为您的事务所申请 OAuth 客户端凭据。您将收到 client_id 和 client_secret。

---

安装

使用 Claude Desktop（推荐）

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

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

{
  "mcpServers": {
    "mycase": {
      "command": "npx",
      "args": ["-y", "@oktopeak/mycase-mcp"],
      "env": {
        "MYCASE_CLIENT_ID": "your_client_id",
        "MYCASE_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

重启 Claude Desktop，即可完成。

提示

使用 Windows？ 上述配置在 macOS 上可用，但在 Windows 上无法直接使用。你可能会遇到 Could not attach to MCP server mycase（npx 调用）、UNABLE_TO_VERIFY_LEAF_SIGNATURE（企业防病毒软件 SSL 检查）以及 OAuth 重定向端口不匹配的问题。Windows 兼容配置和全部五项修复方法都在我们的安装指南中。

→ Windows 上的 MyCase MCP：我们希望早就有的安装指南 — 涵盖 Windows 上的五个常见问题，以及获取 MyCase API 凭据实际需要的 13 个工作日。

独立运行 / 开发

npm install -g @oktopeak/mycase-mcp

---

提示

不负责编辑配置文件？

如果觉得上面的安装步骤太繁琐，我们可以帮你在律所内部署——配置范围受限的 OAuth 凭据，将审计日志接入你的技术栈，与你的团队共同设计一个自定义工作流，并提供培训。大多数律所发现，这种方式更快捷。

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

---

配置

如果在本地运行（而不是通过 Claude Desktop 环境变量运行），请将 .env.example 复制为 .env 并填写内容：

cp .env.example .env

# From MyCase support
MYCASE_CLIENT_ID=your_client_id
MYCASE_CLIENT_SECRET=your_client_secret

# OAuth callback port (default: 5678)
# Must match the redirect URI registered with MyCase support
MYCASE_REDIRECT_PORT=5678

# ENCRYPTION_KEY is optional — a key is auto-generated on first run and
# stored in your OS keychain. Only set this for CI or headless environments.
# ENCRYPTION_KEY=your_64_char_hex_encryption_key

注意： 向 MyCase 支持团队注册的重定向 URI 必须与 http://127.0.0.1:{MYCASE_REDIRECT_PORT}/callback 一致。如果不确定注册的是哪个端口，请联系 MyCase 支持团队确认。

---

密钥处理

MYCASE_CLIENT_SECRET 是唯一需要保存在配置文件中的敏感凭据。加密密钥由操作系统密钥链自动管理，不会出现在任何配置文件中。

使用 claude_desktop_config.json 时，请限制该文件的权限，以防机器上的其他用户读取你的客户端密钥：

macOS：

chmod 600 ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows： 右键单击该文件 → 属性 → 安全 → 编辑 → 移除所有账户的访问权限，只保留你自己的用户账户。

---

log-call（实验性）

在验证其 API 端点期间，log-call 工具由环境变量控制：

MYCASE_EXPERIMENTAL_TOOLS=1

将此项添加到 claude_desktop_config.json 的 env 块或 .env 文件中以启用该工具。留空则不会向 Claude 显示此工具。

---

身份验证

首次使用时，你需要通过 MyCase 进行身份验证：

1. 在 Claude 中调用 authenticate 工具
2. 浏览器将打开 MyCase 登录页面
3. 登录并授予访问权限
4. 返回 Claude，即表示已连接

访问令牌有效期为 24 小时，并会自动刷新。刷新令牌通常有效期为 2 周（由 MyCase API 设置）。刷新令牌过期后，你需要重新进行身份验证。

加密令牌文件位于 ~/.oktopeak-mycase/tokens.enc。若要注销并移除该文件，请调用 logout 工具。

注意： 如果操作系统密钥链被清除或加密密钥丢失，现有令牌文件将无法解密。服务端会静默地将其视为不存在，你需要重新进行身份验证；数据不会丢失，只是已存储的会话无法使用。

---

可用工具

身份验证

工具	描述
authenticate	打开 MyCase OAuth 页面并存储令牌
auth-status	检查是否已连接以及令牌何时过期
logout	从磁盘删除已存储的令牌

案件

工具	描述
list-cases	列出案件，可按状态（open/closed）或更新时间筛选
get-case	按 ID 获取案件的完整详情
create-case	创建新案件，并添加客户、员工和元数据

联系人

工具	描述
search-contacts	按姓名、电子邮件或电话号码搜索客户、个人或公司
get-contact	按 ID 获取联系人的完整详情

任务

工具	描述
list-tasks	列出任务，可按案件或完成状态筛选
create-task	创建与案件关联的新任务

文档

工具	描述
list-documents	列出文档，可按案件筛选
get-document-url	获取特定文档的下载 URL

日历

工具	描述
list-calendar-events	列出指定日期范围内即将发生的事件

通话

工具	描述
log-call	记录与案件或联系人关联的电话（实验性 — 需要设置 MYCASE_EXPERIMENTAL_TOOLS=1）

员工

工具	描述
list-staff	列出律所的所有员工
get-staff	按 ID 获取员工的完整详情

计费

工具	描述
list-time-entries	列出可计费工时条目，可按案件或日期范围筛选
get-billing-summary	获取案件的已计费、未结清和已付款总额

---

关于多用户支持的说明

此服务在设计上采用单租户模式——一次只存储一组凭据，适用于单个律所在本地运行。如果你以其他用户身份进行身份验证，之前的令牌会被覆盖。

如果你需要支持多家律所或多个用户，则需要使用单独的配置运行多个实例。

---

开发

git clone https://github.com/oktopeak/mycase-mcp.git
cd mycase-mcp
npm install
cp .env.example .env   # fill in your credentials
npm run build
npm run inspect        # opens the MCP inspector in your browser

运行测试

npm test               # run once
npm run test:watch     # watch mode

---

安全性

• OAuth 令牌使用 AES-256-GCM 加密后存储
• 加密密钥会在首次运行时自动生成，并存储在你的操作系统钥匙串中（macOS Keychain / Linux Secret Service / Windows Credential Manager）——不会出现在任何配置文件中
• 令牌和审计日志文件存储在 ~/.oktopeak-mycase/ 中，在 Unix/macOS 上权限模式为 0600（仅所有者可读写）
• 在 Windows 上，通过文件夹“属性”→“安全”限制 %APPDATA%\.oktopeak-mycase 的访问
• 所有 API 调用均从你的计算机直接发送到 external-integrations.mycase.com

漏洞扫描

npm audit --omit=dev 报告 0 个生产环境漏洞。vitest 开发依赖存在 5 个中等严重程度的问题（esbuild、vite），这些问题在生产环境中不可达，且需要升级一个主版本的 vitest 才能解决。它们不会影响已部署的服务实例。

---

需要的不只是连接器？

这个开源连接器会读取你的 MyCase 数据，让 Claude 能够使用这些数据。这满足了大多数律所最终需求的约 20%。

根据你的需求范围，我们可以通过两种方式提供帮助：

→ 整个律所？律所方案：每月 $300。 部署在你自己的云端，每位律师使用自己的账号登录，统一审计日志，每月为你定制一项自动化，无设置费，随时取消。→ oktopeak.com/firm-plan/

→ 法律 AI 集成——适用于多工作流构建、文档自动化、客户接待自动化、自定义 AI Agent，以及覆盖整个技术栈的完整合规架构。 → oktopeak.com/services/legal-ai-integration/

从第一天起就符合 ABA Opinion 512。想要了解这个连接器的精美介绍、视频演示和常见问题解答？ → oktopeak.com/mycase-mcp/

想先聊聊？→ 预约 30 分钟需求沟通

---

Oktopeak 的其他连接器

我们也为其他律所业务管理平台提供同类连接器。每个连接器在 oktopeak.com 上都有自己的介绍页面：

• Clio MCP：适用于 Clio 律所业务管理平台的开源 MCP 连接器。源码：github.com/oktopeak/clio-mcp。npm：@oktopeak/clio-mcp
• Filevine MCP：适用于 Filevine 律所业务管理平台的开源 MCP 连接器。源码：github.com/oktopeak/filevine-mcp。npm：@oktopeak/filevine-mcp
• Lawmatics MCP：适用于 Lawmatics 法律 CRM 和客户接待的开源 MCP 连接器，支持在配置级别启用只读模式。源码：github.com/oktopeak/lawmatics-mcp。npm：@oktopeak/lawmatics-mcp
• IntakeQ / PracticeQ MCP — 适用于 IntakeQ/PracticeQ 的 HIPAA 感知型 MCP 连接器（医疗保健／行为健康及相关医疗诊所）。每次读取／写入 PHI 都会记录审计日志，并提供 BAA + 零数据保留指导。npm：@oktopeak/intakeq-mcp

架构相同，审计日志相同，静态加密方式相同。全部采用 MIT 许可。

---

支持这个项目

这个连接器免费、采用 MIT 许可，由 Oktopeak 维护。它将始终如此——我们不接受捐赠。如果它为你节省了时间，以下方式能真正帮上忙：

• 为这个仓库点星。 其他律所发现它，确实主要靠这个。
• 推荐给另一家使用 MyCase 的律所。
• 如果我们直接帮到了你，请**留下评价**。
• 需要为你的律所部署、扩展或维护？商业支持——这正是资助免费工作的来源。

关于我们

Oktopeak — 为律所和医疗行业提供数字化转型服务。

我们是一支由 7 人组成的内部产品团队，为受监管行业构建 AI 解决方案：AI 集成、工作流自动化，以及客户完全拥有的定制软件。我们维护五个开源 MCP 连接器——Clio、MyCase、Filevine、Lawmatics 和 IntakeQ——并在实际业务中部署这些连接器，采用范围受限的凭据、审计日志，以及围绕团队实际工作方式构建的工作流。

• 🌐 oktopeak.com
• 📅 预约 30 分钟通话
• ✉️ [email protected] — 欢迎提交安全问题报告
• 💼 LinkedIn

---

许可证

MIT — 参见 LICENSE。

---

由 Anthropic 的 Model Context Protocol SDK 构建。