Legalis Ia

Legalis MCP 服务

为巴西律师打造的 AI 法律助手

阅读葡萄牙语版

MCP（Model Context Protocol）服务，适用于 Legalis——面向律师的巴西法律文档 AI。

将 Claude（或任何兼容 MCP 的客户端）连接到你的 Legalis 账户，即可通过自然语言处理案件、生成法律文档、搜索法律法规等。

---

快速开始

1. 安装

pip install legalis-mcp
# or with uv:
uv tool install legalis-mcp

2. 验证身份

legalis-mcp auth

这会打开浏览器。像往常一样登录 Legalis——令牌将保存到 ~/.legalis/credentials.json（仅所有者可读取）。

3. 配置 Claude

将以下内容添加到 Claude 配置中（Claude Desktop 使用 ~/.claude/claude_desktop_config.json，Claude Code 使用 claude_code_config.json）：

{
  "mcpServers": {
    "legalis": {
      "command": "legalis-mcp",
      "args": ["serve"]
    }
  }
}

4. 使用

在 Claude 中尝试：

• “列出我在 Legalis 中的案件”
• “为 João Silva 创建一个间接解雇案件”
• “生成案件 Y 中文书 X 的法律依据部分”
• “搜索有关正当理由解雇的劳动法”
• “我这个月还可以使用多少次生成？”

---

可用工具

案件

工具	描述
list_cases	列出案件（支持分页，可按状态筛选）
get_case	按 ID 获取案件详情
create_case	创建新案件
update_case	更新案件字段
search_cases	对案件进行全文搜索
delete_case	永久删除案件

法律文档

工具	描述
list_legal_documents	列出案件的诉讼文书
get_legal_document	获取包含所有章节的文档
create_legal_document	创建新的法律文档
generate_section	由 AI 生成文档章节（事实、法律依据、诉求……）
update_section_text	手动编辑文档章节
get_case_context	获取案件背景（事实、当事人、证据）
update_case_context	更新案件背景
delete_legal_document	删除法律文档
export_legal_document_docx	将文档导出为 DOCX

事件与任务

工具	描述
create_case_event	在案件中创建事件（内部可见或客户可见）
list_case_events	列出案件的事件
delete_case_event	删除案件事件
create_case_task	创建带截止日期和优先级的任务
list_case_tasks	列出案件的任务
update_case_task	更新任务字段
complete_case_task	将任务标记为已完成
delete_case_task	删除任务
list_upcoming_tasks	列出所有案件中即将到期的任务
list_overdue_tasks	列出所有逾期任务

其他

工具	描述
run_interview	由 AI 引导的案件受理访谈
list_templates	列出可用的文档模板
get_template	获取模板详情和章节
search_legislation	搜索巴西法律法规（LexML）
get_my_usage	查看 AI 配额及计费周期内的使用量

---

API 覆盖情况

下表列出了 Legalis 后端的所有端点及其对应的 MCP 工具（如有）。

案件

端点	方法	MCP 工具
/api/cases	GET	list_cases ✅
/api/cases	POST	create_case ✅
/api/cases/{id}	GET	get_case ✅
/api/cases/{id}	PUT	update_case ✅
/api/cases/{id}	DELETE	delete_case ✅
/api/cases/search	GET	search_cases ✅
/api/cases/{id}/overview	GET	—
/api/cases/{id}/portal-token	POST / DELETE	—

法律文档

Endpoint	Method	MCP 工具
/api/cases/{id}/legal-documents	GET	list_legal_documents ✅
/api/cases/{id}/legal-documents	POST	create_legal_document ✅
/api/cases/{id}/legal-documents/{doc}	GET	get_legal_document ✅
/api/cases/{id}/legal-documents/{doc}	DELETE	delete_legal_document ✅
/api/cases/{id}/legal-documents/{doc}/sections/{key}/generate	POST	generate_section ✅
/api/cases/{id}/legal-documents/{doc}/sections/{key}/text	PUT	update_section_text ✅
/api/cases/{id}/legal-documents/{doc}/export/docx	GET	export_legal_document_docx ✅

案件上下文

Endpoint	Method	MCP 工具
/api/cases/{id}/context	GET	get_case_context ✅
/api/cases/{id}/context	PUT	update_case_context ✅
/api/cases/{id}/context/history	GET	—

任务

Endpoint	Method	MCP 工具
/api/cases/{id}/tasks	GET	list_case_tasks ✅
/api/cases/{id}/tasks	POST	create_case_task ✅
/api/cases/{id}/tasks/{task}	PUT	update_case_task ✅
/api/cases/{id}/tasks/{task}	DELETE	delete_case_task ✅
/api/cases/{id}/tasks/{task}/complete	POST	complete_case_task ✅
/api/tasks/upcoming	GET	list_upcoming_tasks ✅
/api/tasks/overdue	GET	list_overdue_tasks ✅

事件

Endpoint	Method	MCP 工具
/api/cases/{id}/events	GET	list_case_events ✅
/api/cases/{id}/events	POST	create_case_event ✅
/api/cases/{id}/events/{event}	DELETE	delete_case_event ✅

模板与法规

Endpoint	Method	MCP 工具
/api/templates	GET	list_templates ✅
/api/templates/{id}	GET	get_template ✅
/api/legislacao	GET	search_legislation ✅

使用情况

Endpoint	Method	MCP 工具
/api/plans/my-usage	GET	get_my_usage ✅

尚未覆盖

Endpoint	Notes
/api/cases/{id}/overview	BFF 端点——一次调用即可获取案件、任务和事件
/api/cases/{id}/portal-token	通过公开链接与客户分享案件状态
/api/cases/{id}/context/history	上下文版本历史
/api/users/me	用户资料读取/更新
/api/users/settings	通知和 UI 偏好设置
/api/users/documents	已上传的文档（非生成文档）
/api/voice-agent/*	语音助手（受套餐限制的功能）
/api/corporates/{id}/users	团队成员管理
/api/subordinates/invite	邀请团队成员

---

CLI 命令

legalis-mcp auth      # Authenticate via browser
legalis-mcp serve     # Start MCP server (stdio)
legalis-mcp status    # Verify authentication
legalis-mcp logout    # Remove stored credentials

---

开发

git clone <repo>
cd mcp
pip install -e ".[test]"

# Run unit tests (no external services needed)
pytest tests/unit/ -v

# Run integration tests (requires Docker)
cd ../integration && docker-compose up -d
cd ../mcp
LEGALIS_API_URL=http://localhost:8000 \
LEGALIS_ACCESS_TOKEN=<token> \
LEGALIS_REFRESH_TOKEN=<refresh> \
pytest tests/integration/ -v

环境变量

Variable	Default	Description
LEGALIS_API_URL	https://hai-production-612f.up.railway.app	后端 URL
LEGALIS_ACCESS_TOKEN	—	预签发令牌（仅用于 CI/测试）
LEGALIS_REFRESH_TOKEN	—	刷新令牌（仅用于 CI/测试）
LEGALIS_CREDENTIALS_FILE	~/.legalis/credentials.json	凭据文件路径
LEGALIS_OAUTH_PORT	3742	本地 OAuth 回调端口

---

安全

• 凭据存储在 ~/.legalis/credentials.json 中，权限为 600（仅所有者可读写）。
• OAuth 重定向仅限于 http://localhost——后端会阻止开放重定向攻击。
• 令牌绝不会存储在 MCP 配置文件中。
• 所有 API 调用均通过现有的 Legalis 后端进行——RBAC、速率限制和配额照常适用。

---

发布

# PyPI
pip install build twine
python -m build
twine upload dist/*

# Then register at:
# - smithery.ai (MCP marketplace)
# - mcp.so (community directory)
# - github.com/modelcontextprotocol/servers (official list)