Mastercard Developers MCP Server

什么是 Mastercard Developers MCP Server？

Mastercard Developers MCP Server 是 Mastercard 官方推出的免费远程 MCP 服务器，让 AI 助手和 IDE 直接访问 Mastercard Developers 的文档、集成指南和 API 规范，无需任何认证。

它是 Mastercard Developers Agent Toolkit 的一部分。基于 Mastercard API（支付、反欺诈、身份验证、Open Finance、积分忠诚度等）进行开发的开发者，可以让编码助手判断哪个服务适合某个场景、阅读最新文档，并依据真实的 API 规范生成集成代码，而不必手动浏览开发者门户。该服务器只覆盖 Mastercard Developers 的内容；它不会代你调用 Mastercard API，也不会接触任何账户。

如何使用 Mastercard Developers MCP Server？

Mastercard 推荐使用远程服务器：配置最少，也不需要在本地安装 Node 或 npx。服务器地址：

https://developer.mcp.mastercard.com

不需要 API 密钥，也无需登录。如果客户端要求选择认证方式，请选择 "No Authentication"。

Claude Code

Mastercard 文档给出的命令：

claude mcp add --transport http mastercard-developers https://developer.mcp.mastercard.com

Claude Desktop 和 claude.ai

打开 Settings，进入 Connectors，选择 Add custom connector 并粘贴 https://developer.mcp.mastercard.com。之后没有登录步骤。

Cursor

添加到 ~/.cursor/mcp.json（Mastercard 文档中也提供了 "Add to Cursor" 按钮）：

{
  "mcpServers": {
    "mastercard-developers": {
      "url": "https://developer.mcp.mastercard.com"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "mastercard-developers": {
      "type": "http",
      "url": "https://developer.mcp.mastercard.com"
    }
  }
}

本地方式

如需更多控制，Mastercard 在 npm 上发布了本地 stdio 服务器 @mastercard/developers-mcp，客户端可通过 npx -y @mastercard/developers-mcp 启动。Claude Desktop 用户也可以从文档中安装预构建的 .dxt 扩展。如果要把服务器嵌入自己的应用，可使用 GitHub 上开源的 SDK @mastercard/developers-agent-toolkit。该 SDK 支持 service 和 apiSpecification 选项，可将范围限定为单个服务或单个 OpenAPI 规范；设置其中任意一个都会禁用 get-services-list。

Mastercard Developers MCP Server 的主要功能

• Mastercard 官方服务器，文档位于 Mastercard Developers 的 Agent Toolkit 栏目。
• 免费使用，远程端点无需 API 密钥、OAuth 或 Mastercard 账户。
• 覆盖 Mastercard 产品和技术服务的服务发现，每个服务都有 serviceId。
• 完整的文档访问，从章节概览到单个页面。
• 针对 OAuth 1.0a 和 OAuth 2.0 API 认证的专门指南（可选特定编程语言示例），以及 Open Finance 集成指南。
• 基于 Mastercard OpenAPI 规范的 API 操作列表和详细的请求／响应结构。
• 提供远程、本地 npx 和 SDK 三种方式，文档覆盖 Claude Code、Claude Desktop、Cursor、VS Code 和 ChatGPT。

Mastercard Developers MCP Server 工具

远程端点提供九个工具，分为四组：

• 服务发现：get-services-list 列出 Mastercard Developers 的产品和服务，包括标题、描述和 serviceId，其他工具以此作为输入。
• 文档：get-documentation 给出某个服务文档的概览，包括章节标题和链接；get-documentation-section-content 返回整个章节（一组页面）；get-documentation-page 按路径返回单个页面。
• 集成指南：get-oauth10a-integration-guide、get-oauth20-integration-guide 和 get-openfinance-integration-guide 返回带代码示例的分步指南。
• API 规范：get-api-operation-list 汇总某个 API 规范中的所有操作（方法、路径、描述），get-api-operation-details 返回单个操作的参数以及请求和响应结构。

Mastercard Developers MCP Server 的使用场景

• 服务发现："What fraud prevention tools does Mastercard offer?"
• 快速原型："I need to integrate Open Finance to verify account ownership and check balances for my fintech app."
• 认证代码："I want code that generates an access token so I can start calling Open Finance US APIs."
• 请求签名：在为 Mastercard API 编写签名调用之前，先让助手获取你所用语言的 OAuth 1.0a 指南。
• 查询结构：让助手列出某个规范中的操作，并取出你正在实现的那个操作的准确请求体。

Mastercard Developers MCP Server 常见问题排查

• 客户端询问认证方式：选择 "No Authentication"；远程服务器是公开的。
• 缺少 get-services-list：在通过 SDK 托管的服务器上，设置 service 或 apiSpecification 选项会禁用它。移除该选项即可恢复。
• ChatGPT 无法添加服务器：ChatGPT 的自定义连接器需要开发者模式；Mastercard 列出的适用账户为 Pro、Plus、Business、Enterprise 和 Education。