mcpField
M
mcp-clip

mcp-clip

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-clip

mcp-clip 是 Clip（PayClip）的 MCP 服务，Clip 是墨西哥的收单机构。它面向需要以墨西哥比索收款的场景，可创建托管支付链接、通过卡令牌发起扣款并处理退款。

主要功能

  1. 01托管式支付链接创建与状态查询
  2. 02基于客户端卡令牌的直接扣款
  3. 03支付记录查询与分页列表
  4. 04全额或部分退款

适用场景

  1. 01通过代理生成支付链接并发送给买家
  2. 02在无需处理卡号的前提下完成收款
  3. 03查询支付记录并为订单办理退款

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-clip": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-clip"
      ],
      "env": {
        "CLIP_AUTH_TOKEN": "<CLIP_AUTH_TOKEN>",
        "CLIP_BASE_URL": "<CLIP_BASE_URL>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-clip
需要配置的环境变量
CLIP_AUTH_TOKEN密钥Basic auth token from the Clip developer dashboard
CLIP_BASE_URLAPI base URL override. Defaults to https://api.payclip.com.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-clip0.1.0

工具

6

收录的工具列表 · 更新于 2 周前

参数类型必填说明
amountnumber是以 MXN 计价的金额（比索小数，例如 150.00）
currencystring否货币代码。Clip 处理 MXN。
metadataobject否查询／webhook 中回显的可选元数据
redirection_urlobject否买家付款后跳转到的页面
redirection_url.errorstring否失败时使用的 URL
redirection_url.defaultstring否备用 URL
redirection_url.successstring否成功时的 URL
purchase_descriptionstring是买家支付的商品或服务（在结账时显示）

详细介绍

@codespar/mcp-clip

Clip（PayClip）的 MCP 服务——墨西哥领先的本土收单机构。支持托管支付链接、透明的银行卡令牌扣款、查询和退款，币种为 MXN。

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "clip": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-clip"],
      "env": {
        "CLIP_AUTH_TOKEN": "your-basic-token"
      }
    }
  }
}
Claude Code
claude mcp add clip -- npx @codespar/mcp-clip

环境

变量必需描述
CLIP_AUTH_TOKEN是Clip 开发者控制台提供的 Basic 身份验证令牌（作为 Authorization: Basic <token> 发送）
CLIP_BASE_URL否API 基础 URL 覆盖值（默认值为 https://api.payclip.com）

测试模式：Clip 根据令牌本身区分环境——测试令牌会访问沙盒处理流程；无需单独的 URL。

工具（6 个）

工具功能
create_payment_link托管结账链接（POST /v2/checkout）——无需处理 PCI 数据的方式
get_payment_link根据 ID 查询结账状态
create_payment使用客户端银行卡令牌进行透明扣款（POST /payments）
get_payment支付详情
list_payments分页列出支付记录
refund_payment全额或部分退款（POST /payments/{id}/refund）

绝不会接受银行卡原始卡号——create_payment 接受的是 Clip 客户端 SDK 生成的令牌。如果没有令牌化前端，请使用 create_payment_link。

示例

“收取 450 比索的咨询费，并把链接发给我。”

Agent 会调用 create_payment_link（amount: 450.00，purchase_description: "Consultoría"），并向买家返回 payment_request_url。

身份验证

Clip 会在开发者控制台中提供一个 Basic 身份验证令牌；服务会在每次调用时将其作为 Authorization: Basic <CLIP_AUTH_TOKEN> 发送。

企业版

需要为由 Agent 发起的 Clip 支付提供治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。