mcp-legiti

@codespar/mcp-legiti

已弃用：没有可用的实时端点。 于 2026-09-27 使用两个公共 DNS 解析器（8.8.8.8 和 1.1.1.1）进行测量后发现：此服务调用的主机 collection-prod.inspcdn.net 无法通过 DNS 解析。此服务中的任何工具都无法连接到服务。该软件包已在 npm 上弃用，仅保留在此代码库中供参考。如果你有可用的端点，请使用 LEGITI_BASE_URL 将服务指向该端点。若要恢复此软件包，请在 mcp-dev-latam 中提交问题，并附上提供商记录的基础 URL。

适用于 Legiti 的 MCP 服务——巴西欺诈防范服务，原生支持票务业务，并提供简单的同步评估 API。

CodeSpar fraud 类别中的第四个条目，位于 @codespar/mcp-clearsale、@codespar/mcp-konduto 和 @codespar/mcp-sift 之后。Legiti（前身为 Inspetor，总部位于圣保罗）面向巴西中型市场：公开业务规模小于 ClearSale，在票务 / 活动领域的垂直业务深度高于 Konduto，API 接口则比 Sift 更简单。

定位

	优势	典型适用场景
ClearSale	巴西先驱（2001 年），拥有大量拒付历史数据	巴西大型零售商的默认选择
Konduto	巴西服务、API 优先、设备行为分析能力	原生数字化的巴西电商
Legiti (this)	巴西服务、原生支持票务、同步评估	巴西票务平台、中型零售商
Sift	全球业务、多种滥用类型机器学习、工作流	国际企业

巴西商户通常会组合使用其中 2-3 个服务，以获取最佳专业评分能力——使用 Legiti 获取其票务专属信号，使用 ClearSale 或 Konduto 提供通用欺诈防范层，并使用 Sift 处理跨境交易。

工具（18 个）

工具	用途
evaluate_order	通过 v2 订单端点向 Legiti 提交订单，以进行实时欺诈评估。
update_order	通知 Legiti 现有订单的状态变更（例如，
mark_order_fraudulent	向 Legiti 报告已确认的拒付 / 欺诈结果。
evaluate_sale	通过 POST /evaluation 进行旧版单次销售评估。
track_account	通知 Legiti 账户生命周期事件（创建 / 更新 / 删除）。
track_event	通知 Legiti Event（音乐会、演出、比赛、场次）的生命周期变更。
track_sale	通知 Legiti Sale 状态变更（创建 / 更新）。
track_auth	通知 Legiti 认证或密码事件（登录尝试、登出、密码恢复请求、pas...
track_login	通知 Legiti 登录尝试（成功或失败）。
track_logout	通知 Legiti 登出事件。
track_signup	通知 Legiti 新账户创建。
track_account_update	通知 Legiti 账户资料变更（邮箱、电话、CPF、地址）。
track_password_recovery	通知 Legiti 密码恢复请求（点击“忘记密码”）。
track_event_view	通知 Legiti 用户查看了某个活动 / 演出页面。
track_payment	通知 Legiti 支付方式级别的事件（授权尝试、扣款、退款、撤销）。
get_decision	获取 Legiti 对某个订单的最新决策。
update_decision_status	手动覆盖 Legiti 对某个订单的决策——通常用于接受或拒绝处于 i... 状态的销售。
mark_dispute_resolution	向 Legiti 报告拒付争议的处理结果——即

安装

npm install @codespar/mcp-legiti@alpha

环境变量

LEGITI_API_KEY="eyJhbGciOi..."   # JWT bearer token; required
LEGITI_BASE_URL="..."             # optional; defaults to https://collection-prod.inspcdn.net

身份验证

Bearer 令牌（JWT 格式）：

Authorization: Bearer <LEGITI_API_KEY>

Legiti 会分别签发沙盒和生产环境密钥。沙盒密钥会将每个请求标记为测试数据，因此不会用于训练 ML 模型。请始终使用沙盒密钥进行开发和集成测试——将测试数据发送到生产环境会污染模型。

决策值

evaluate_order 和 evaluate_sale 会返回以下三种决策之一：

• approve — 发货
• reject — 拦截销售
• manual — 转交人工审核

评估采用同步方式；响应时间最长可能约为 20 秒。

典型流程（票务）

1. 用户注册或登录时，调用 track_account（创建/更新）和 track_auth（登录/登出、密码找回、密码重置）。每次身份验证尝试——无论成功还是失败——都是检测账户接管的重要信号。
2. 平台发布新活动（音乐会、演出、比赛）时，调用 track_event（创建）。价格、容量或日期变更时进行更新。
3. 结账时，调用 evaluate_order，传入销售、账户、支付、CPF 和主要的 event_date_id。根据返回的决策采取行动：approve → 发货，reject → 拦截，manual → 转交人工审核。
4. 订单状态发生变化时（已付款、已发货、已送达、已取消、已退款），调用 update_order。
5. 发卡机构确认拒付后，调用 mark_order_fraudulent。这是 Legiti 主要的 ML 反馈渠道——未上报的拒付会降低系统对类似买家的后续决策质量。

典型流程（非票务电商）

跳过 track_event。在 evaluate_order 中，event_date_id 字段变为可选——Legiti 仍会根据账户、销售和支付信号进行评估，但不会使用票务行业相关特征。

Alpha 说明

以 0.1.0-alpha.1 发布。与 ClearSale 和 Konduto 相比，Legiti 的公开文档更为精简：

• 开源项目 github.com/legiti/docs-backend 中的文档： POST /evaluation，以及 Collection API（账户、活动、销售、转账、身份验证、密码）的结构和 Authorization: Bearer 方案。
• docs.legiti.com 集成指南中的文档： v2 订单接口（POST /v2/order、PUT /v2/order、POST /v2/order/mark_fraudulent）。
• 从原始类别规范中移除： create_rule / list_rules / update_rule / delete_rule —— Legiti 没有公开的自定义规则接口。如果客户合同中包含此类接口，可升级至 0.2.0。

在生产环境中确认 v2 订单负载结构后，升级至 0.1.0。

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-legiti

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-legiti

类别

fraud — 这是 CodeSpar 类别中的第四个服务，与 ClearSale、Konduto 和 Sift 并列。欺诈服务具有共同的结构（分析 → 决策 → 反馈），有别于支付服务，因此跨服务提供商切换（ClearSale ↔ Konduto ↔ Legiti）比跨收单机构切换更为简单。

企业版

需要为 Agent 支付配置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、支付路由和合规模板。

许可证

MIT