关于 ifthenpay Payments MCP
ifthenpay Payments MCP 是用于接入 ifthenpay 支付服务的官方远程 MCP 服务,为兼容应用提供创建支付请求与付款凭证、查询状态及检索已完成付款的工具。
主要功能
- 01创建 Multibanco 付款凭证
- 02发起并查询 MB WAY 付款
- 03创建 Payshop 付款凭证
- 04创建银行卡及其他支付链接
- 05列出已完成付款
适用场景
- 01为客户创建付款凭证
- 02发起并查询 MB WAY 请求
- 03检索已完成的付款记录
MCP 相关
该远程 Streamable HTTP MCP 服务向兼容客户端开放 ifthenpay 支付工具,包括创建支付、查询状态和付款报告。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://ai.ifthenpay.com/mcp/payments/一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http com-ifthenpay-payments https://ai.ifthenpay.com/mcp/payments/Cursor.cursor/mcp.json
{"mcpServers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"com-ifthenpay-payments":{"type":"http","url":"https://ai.ifthenpay.com/mcp/payments/"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"com-ifthenpay-payments":{"serverUrl":"https://ai.ifthenpay.com/mcp/payments/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
8| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| amount | number | 是 | 以 EUR 计的付款金额(例如 10.50)。 |
| mb_key | string | 是 | ifthenpay Multibanco 密钥。 |
| order_id | string | 是 | 系统中的唯一订单标识符。 |
| expiry_days | integer | 否 | 参考编号过期前的天数。省略时默认永不过期。 |
详细介绍
ifthenpay MCP Server
面向 ifthenpay 支付服务的官方 Model Context Protocol(MCP) 服务。
ifthenpay MCP Server 支持 AI 助手和兼容 MCP 的应用安全地与 ifthenpay 支付服务交互,包括 Multibanco、MB WAY、Payshop、Credit Card、PinPay、Cofidis Pay、PIX 和支付报告。
注册表
注册表 ID
com.ifthenpay/payments
远程端点
https://ai.ifthenpay.com/mcp/payments/
协议
- Model Context Protocol(MCP)
- JSON-RPC 2.0
- Streamable HTTP
支持的客户端
此服务兼容任何 MCP 客户端,包括:
- Claude Desktop
- GitHub Copilot
- Visual Studio Code
- Cursor
- Windsurf
- Continue.dev
- 任何其他兼容 MCP 的客户端
可用工具
| 工具 | 描述 |
|---|---|
multibanco_create_reference | 创建 Multibanco 支付参考号 |
mbway_request_payment | 发送 MB WAY 支付请求 |
mbway_check_status | 检查 MB WAY 支付状态 |
payshop_create_reference | 创建 Payshop 支付参考号 |
creditcard_create_payment | 创建托管式信用卡/借记卡结账 |
pinpay_create_payment | 创建 Pay-by-Link,支持 Card、Multibanco、MB WAY、Payshop、Google Pay、Apple Pay、Cofidis Pay 和 PIX |
cofidis_create_payment | 创建 Cofidis Pay 支付 |
pix_create_payment | 创建 PIX 支付 |
payments_list | 从 ifthenpay Backoffice 获取已完成的支付 |
速率限制
为确保平台稳定运行,服务会实施速率限制。
- 每个 IP 每分钟 60 个请求
- 超出限制的请求会返回 HTTP 429 Too Many Requests
- 不支持批量 JSON-RPC 请求
客户端配置
Claude Desktop
{
"mcpServers": {
"ifthenpay": {
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
GitHub Copilot / Visual Studio Code
{
"servers": {
"ifthenpay": {
"type": "http",
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Cursor
{
"mcpServers": {
"ifthenpay": {
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Windsurf
{
"mcpServers": {
"ifthenpay": {
"serverUrl": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}
Continue.dev
{
"mcpServers": [
{
"name": "ifthenpay",
"transport": {
"type": "streamable-http",
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
]
}
MCP 请求示例
初始化连接:
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"clientInfo": {
"name": "my-client",
"version": "1.0"
}
}
}
列出可用工具:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}
调用工具:
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "multibanco_create_reference",
"arguments": {
"mb_key": "...",
"order_id": "1001",
"amount": 25.00
}
}
}
文档
完整文档、示例和 API 参考可在以下位置查看:
文档
https://ai.ifthenpay.com/mcp/docs/
交互式测试客户端
https://ai.ifthenpay.com/mcp/client/
ifthenpay
许可证
版权所有 © ifthenpay。
保留所有权利。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。