使用说明
全球支付MCP服务器(TypeScript)
用于全球支付API集成的模型上下文协议(MCP)服务器,使人工智能代理能够使用TypeScript/Node.js以编程方式创建和管理支付链接。
目录
关于
该MCP服务器将人工智能代理(如Claude或GitHub Copilot)与全球支付API连接起来,允许通过自动身份验证、令牌管理和全面的错误处理创建、检索和管理自然语言支付链接。使用TypeScript构建,用于类型安全和现代Node.js开发。
特性
- 支付链接创建(一次性和多用途)
- 支付链接检索和过滤
- API文档检索(19个以上API类别)
先决条件
-
Node.js 18.0或更高版本
-
npm
-
全球支付API凭证(把他们带到这儿来)
-
Claude Desktop、带有Copilot的VS Code或其他兼容MCP的客户端
注: 建议正在使用的应用程序具有有限的访问权限。具体来说,在应用程序权限中只应添加与LNK相关的资源
安装
-
克隆仓库
git clone https://github.com/globalpayments/mcp-server.git cd gpapi-mcp-server/Typescript -
安装依赖项
npm install -
构建项目
npm run build -
创建
.env项目根目录中的文件创建一个
.envTypeScript目录中的文件,其中包含您的凭据:# Required: Your Global Payments App credentials (format: APP_ID:APP_SECRET) GPAPI_APP=your_app_id:your_app_secret # Optional: Your Global Payments Account (provide ONE of these, or leave blank for auto-detection) # If not provided, the account will be auto-detected from the access token # GPAPI_ACCOUNT_ID=your_account_id # OR # GPAPI_ACCOUNT_NAME=your_account_name # Optional: Environment (SANDBOX, or PROD, default: SANDBOX) ENV=SANDBOX注: 这
.env文件是存储凭据的推荐方式。它使敏感信息远离配置文件,并使管理不同的环境变得更加容易。 -
配置您的MCP客户端
适用于克劳德桌面
添加到您的
claude_desktop_config.json:{ "mcpServers": { "global-payments": { "command": "node", "args": [ "X://absolute//path//to//gpapi-mcp-server//Typescript//lib//index.js" ], "env":{ "GPAPI_APP":"XXXXXXXXXXXXXXXXX:XXXXXXX", "GPAPI_ACCOUNT_NAME":"XXXXXXXXX", "ENV":"SANDBOX" } } } }VS代码(副本)
添加到您的VS Code MCP设置文件(
mcp.json):{ "servers": { "global-payments": { "command": "node", "args": [ "lib/index.js" ], "cwd": "./", "env":{ "GPAPI_APP":"XXXXXXXXXXXXXXXXX:XXXXXXX", "GPAPI_ACCOUNT_NAME":"XXXXXXXXX", "ENV":"SANDBOX" } } } }注: 确保在以下位置提供TypeScript项目目录的绝对路径
cwd现场。这.env文件应位于此目录中。
可用工具
此MCP服务器提供以下工具:
| 工具 | 说明 |
|---|---|
create_payment_link |
创建一次性或多用途支付链接 |
get_links |
检索和过滤付款链接 |
get_documentation |
检索19个以上类别的API文档 |