AI导哈

Pix支付服务

一个基于Model Context Protocol (MCP)的Pix支付服务，提供现金进出、Webhooks和查询功能。

  • by Intra-Pay
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Intra-Pay/mcp-server

使用说明

Servidor MCP内部薪酬

MCP 服务器 100% 中文专注于开发体验 （DX），将 Intra Pay 的 Pix （现金/现金） 操作和 webhooks 暴露给支持模型上下文协议 （MCP） 的代理和 IDE，如 Claude Desktop、Cursor、Trae 和 OpenAI 代理。

此项目包括一个类型化的HTTP客户端，使用Zod验证的架构和标准响应。

功能

  • 认证自动管理带缓存的令牌。
  • Pix现金流入创建静态，动态，即时和到期的二维码。
  • Pix提款按照 Pix 密钥、银行数据或 QR 码读取 （EMV） 付款。
  • 网络钩子创建和列出用于事件通知的 webhooks。
  • 咨询检查收费状态（如果支持）。

要求

  • Node.js 20 或更高版本（仅在本地运行）。

安装和配置

Intra Pay的MCP服务器仅适用于 生产 (api.intrapay.io).

多租户身份验证（支持多个客户端）

此服务器支持按请求验证 。这允许单个托管实例（https://mcp.intrapay.io/mcp）服务于多个客户，每个客户都有自己的凭据。

为此，MCP 客户端必须通过 HTTP 头发送凭据：

  • x-intrapay-client-key您的客户密钥
  • x-intrapay-client-secret您的秘密客户

如果没有发送标头，服务器将使用环境中配置的默认凭据。

远程设置（ 推荐）

带来（Windows/Mac）

编辑配置文件（Windows: %APPDATA%\Trae\User\mcp.json):

{
  "servers": {
    "intrapay": {
      "type": "http",
      "url": "https://mcp.intrapay.io/mcp",
      "headers": {
        "x-intrapay-client-key": "SUA_CLIENT_KEY",
        "x-intrapay-client-secret": "SEU_CLIENT_SECRET"
      },
      "metadata": {
        "name": "intrapay-mcp",
        "description": "MCP server para operações Pix via Intra Pay"
      }
    }
  }
}

光标

  1. 进去 设置 > 主控程序 > 添加服务器.
  2. 选择传输方式 超文本传输协议 （或SSE）。
  3. 网址： https://mcp.intrapay.io/mcp
  4. 名称 ： intrapay 注意： 光标可能还没有图形界面来添加自定义标题。如有，请使用本地设置或检查最新的光标文档。

本地设置（ 高级）

如果需要使用， 请使用此选项 您自己的凭据 内部薪酬。

克劳德桌面（本地）

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "intrapay": {
      "command": "node",
      "args": [
        "C:\\Caminho\\Para\\mcp-server\\dist\\server.js",
        "--client-key=SUA_KEY_PRODUCAO",
        "--client-secret=SEU_SECRET_PRODUCAO"
      ]
    }
  }
}

手动运行

# Instalar dependências
npm install

# Build
npm run build

# Rodar com suas credenciais
node dist/server.js --client-key=SUA_KEY --client-secret=SEU_SECRET

可用工具

服务器向代理公开以下工具 ：

  • intrapay_health_check检查连接状态。
  • intrapay_pix_create_static_qrcode生成静态 Pix QR 码。
  • intrapay_pix_create_dynamic_immediate_qrcode生成动态 Pix 以便即时付款。
  • intrapay_pix_create_dynamic_duedate_qrcode生成具有到期日期的动态 Pix。
  • intrapay_pix_get_charge_status查看收费状态。
  • intrapay_pix_cash_out_by_account： 将 Pix 转账至银行账户。
  • intrapay_pix_cash_out_by_key通过密钥（CPF，电子邮件等）进行Pix传输。
  • intrapay_pix_cash_out_by_emv通过读取“复制粘贴”（EMV）代码进行付款。
  • intrapay_webhook_create注册一个新的 webhook。
  • intrapay_webhook_list列出已注册的 webhooks。

部署na Nuvem（铁路/Vercel）

如果您想使用密钥托管自己的实例：

  1. 在 Railway/Vercel 中创建连接到此仓库的项目。
  2. 设置环境变量（ S）INTRAPAY_CLIENT_KEY, INTRAPAY_CLIENT_SECRET在供应商面板上。
  3. 启动命令是 npm start.

安全

  • 凭据永远不要提交密钥或文件 .env.
  • 日志系统避免记录敏感信息，但记录交易元数据（txid)副礼堂。

许可证

该项目可免费使用，可与Intra Pay API集成。

相关 MCP