https://docs.localpayment.com/mcp)作为实时真理来源,以及 查询协议 ——只查询每个问题所需的内容,绝不预先获取所有内容。
Localpayment 代理库
Localpayment 集成代理
更快、更准确地构建支付集成。该代理会在生成任何代码之前读取实时 API 规范,根据模式验证请求负载,并解释当前文档中的错误代码。
Localpayment 质量保证代理
上线前请验证您的集成。该代理会对照实时规范检查您的实现,标记缺失的必填字段,测试各种边缘情况,并生成结构化的验证报告。
所有代理都使用相同的 MCP 服务器和工具。您可以组合使用、扩展它们,或者将它们用作模板,为任何集成任务构建您自己的专用代理。
先决条件
在部署任何 Localpayment 代理之前,请确保您已具备以下条件: LLM 要求(必需):- 函数/工具调用支持——LLM 必须支持结构化工具调用。MCP 构建于函数调用之上。任何不具备此功能的模型都无法使用 MCP 工具。
- 最小上下文窗口为 32K 个令牌——对于在单个会话中读取多个 API 架构和指南的复杂多步骤集成,建议使用 200K+。
- 支持 JSON 输出——结构化工具响应所必需。
- 互联网接入
https://docs.localpayment.com/mcp - 用于测试实际集成的 Localpayment API 凭证(Stage)
- 根据您的框架,需要 Python 3.10+ 或 Node.js 18+。
- Anthropic:Claude Opus 4.7、Claude Sonnet 4.6、Claude Haiku 4.5
- OpenAI :GPT-4o、o3、o3-mini
- Google :Gemini 3.1 Pro、Gemini 3 Flash
- 本地模型可通过 Ollama 或 LM Studio 实现:Qwen3.6、Llama 4(Scout/Maverick)、Phi-4、Mistral Small 4 — 任何已确认支持功能/工具调用的模型
推荐的LLM参数
调用工具和生成集成代码的代理与创意或对话任务所需的设置不同。框架特定说明:
- OpenAI SDK / LangChain:在
ChatOpenAI或Agent配置中设置temperature=0。 - Vercel AI SDK:在
generateText选项中传入temperature: 0。 - CrewAI:在
Agent的llm参数中设置temperature=0。 - AgentScope:在
agentscope.init()处通过model_configs进行配置。 - Amazon Bedrock:在
converse调用的inferenceConfig中传入temperature。
Localpayment 集成代理
ID:localpayment-integrator
用途:帮助开发者构建准确的 Localpayment API 集成。
它的作用
- 按需查询 MCP 服务器——仅查询每个问题所需的信息,从而最大限度地减少令牌开销
- 必要时使用
list-endpoints和search-endpoints发现可用的 endpoint - 在生成任何代码之前,使用
get-endpoint读取实时模式和参数 - 使用
search和fetch查找并阅读文档指南 - 生成符合当前规范的完整、可运行的集成代码
- 读取您现有的代码库(在代理环境中),并将生成的代码适配到您的架构中
- 通过获取实时错误代码引用来解释错误代码——绝不从内存中读取
- 在每次响应中都应用安全性、架构和 PCI 最佳实践
- 根据当前文档,标注 Stage 与 Production 环境之间的差异
系统提示
Localpayment 质量保证代理
ID:localpayment-qa
用途:在正式上线之前,根据实时 API 规范验证现有的 Localpayment 集成。
它的作用
- 阅读实时规范,了解每个 endpoint 的要求
- 分析提交的请求负载和代码,查找缺失或无效的字段
- 根据当前通知指南检查 webhook 处理程序逻辑
- 根据已记录的错误代码目录测试错误处理。
- 生成结构化的验证报告,其中包含通过/失败项以及建议的修复方案。
系统提示
整合到您的项目中
使用 Localpayment 集成代理的最有效方式是将其永久嵌入到您的项目中,而不是作为一次性聊天工具。嵌入后,该代理就成为了一位专家,它既了解 Localpayment API,也了解您的代码库。隐私声明:Localpayment 无法访问您的项目信息。安装 Localpayment 代理时,会发生三件事——但这三件事都不会让 Localpayment 访问您的代码:
- 系统提示符 是一个文本文件,您需要将其复制到您的计算机上(
.cursor/rules、AGENTS.md等等)。复制完成后,Localpayment 将无法查看复制的内容或您的项目。 - MCP 服务器 (
https://docs.localpayment.com/mcp)是一个公开的只读文档服务器。您的 AI 工具发送诸如“显示 endpoint X”之类的查询,并接收返回的公开文档——与docs.localpayment.com上提供的内容相同。MCP 服务器永远不会收到您的代码、凭据或任何私人数据。 - 您的代码库 由您的 AI 工具在本地处理,并根据您选择的 AI 提供商(Anthropic、OpenAI、Google 等)的隐私政策发送给该提供商,而不是发送给 Localpayment。
步骤 1 — 添加到您的项目规则
将系统提示添加到项目的 AI 规则文件中。代理将自动将其应用于每个会话:- Cursor
- Claude Code
- OpenCode
- OpenHands
在项目根目录中创建
.cursor/rules 并粘贴系统提示。Cursor Agent 将在该项目的每个会话中使用它。步骤 2 — 扩展您的架构
系统提示设计为可扩展的。在最后一个## 部分之后,添加您的项目特定上下文,以便代理生成适合您现有代码库的代码:
步骤 3 — 自主模块生成
嵌入代理并添加架构上下文后,您可以委派完整的集成任务:- 阅读您现有的服务文件
- 向 Localpayment MCP 查询当前 endpoint 架构
- 按照您的命名规则,在正确的位置生成所有文件
- 自动应用 PCI 和安全最佳实践
- 运行测试(使用 Cursor 或 OpenHands 等工具),并修复所有失败项
按框架实施
以下框架选项卡适用于此库中的任何代理。将SYSTEM_PROMPT 替换为您要部署的代理的系统提示。
- MCP(任何工具)
- OpenAI Agents SDK
- LangChain
- Vercel AI SDK
- CrewAI
- AgentScope
- Amazon Bedrock
- OpenCode
- OpenHands
对于任何 Localpayment 代理来说,最简单的部署方式是使用任何与 MCP 兼容的工具(Cursor、Claude Desktop、VS Code、Windsurf、ChatGPT、OpenHands、OpenCode 等)。
- 为您的工具配置 MCP 服务器。
- 创建一个新会话,并将代理的系统提示粘贴为初始指令、自定义规则文件或项目指令。
.cursor/rules 文件并粘贴系统提示。在 Claude Desktop 中,打开项目设置,并将系统提示粘贴到 项目说明 字段中。在 OpenHands 中,在开始任务之前,将系统提示粘贴为初始代理指令。框架比较
标准与生态系统
Localpayment 代理基于开放标准构建。了解其生态系统有助于扩展代理或构建多代理工作流程。多智能体工作流
Localpayment 的代理将与您现有的项目代理协同工作。典型的工作流程是将您的内部代理(了解您的代码库和架构)与 Localpayment 的专家代理(通过 MCP 了解 Localpayment API)结合起来: 向您的编排代理(Cursor / Claude Code)发送的示例提示:分享和分发您的代理
与 MCP 服务器(通过深度链接安装)不同,代理系统提示信息以文件形式分发。推荐的方法取决于您的团队配置: 仅供个人使用: 从本页复制系统提示信息,并将其添加到工具的规则或指令文件中。无需安装。 通过 Git 进行团队分发: 与团队共享代理的最可靠方法是将系统提示文件提交到项目仓库。所有团队成员在克隆或拉取项目时都会自动获得相同的代理配置。 对于 Claude Code — 创建.claude/agents/localpayment-integrator.md:
.cursor/rules。在该代码库中工作的每个团队成员都会自动获得该代理。
对于 OpenCode — 使用系统提示提交 AGENTS.md。OpenCode 会在每个会话中加载它。
遵循 AGENTS.md 开放标准:
AGENTS.md 格式 可被 Claude Code、Goose 和其他代理平台识别。它使用 YAML frontmatter 作为元数据,使用 Markdown 作为指令——结构与上述系统提示相同。
示例会话
开发人员: 我需要在正式上线前验证我的阿根廷 CVU 集成。 Localpayment 质量保证代理: (调用get-endpoint POST /api/virtual-account → 读取实时模式)
(调用 search("receive payment notifications") → 获取 webhook 指南)
已审查组件:POST /api/virtual-account(阿根廷 CVU)
参考的规范版本:通过 MCP get-endpoint 获取的实时模式
✅ PASS
externalId是 UUID 格式- 所有必填字段均已填写:
country、accountNumber、beneficiary.type、beneficiary.name
beneficiary.document对于阿根廷本地公司而言是可选的,但建议用于对账。
- Webhook 处理程序不检查
internalId是否存在重复处理——在贷记付款之前添加幂等性检查
提示库
提供即用型提示,助您充分利用任何 Localpayment 代理。
人工智能安全
在金融科技整合环境中安全使用人工智能工具的最佳实践。

