https://docs.localpayment.com/mcp) como a fonte de verdade em tempo real, e o Protocolo de Consulta — consultar apenas o que cada pergunta exige, nunca buscar tudo antecipadamente.
Biblioteca de Agentes Localpayment
Agente Integrador Localpayment
Crie integrações de pagamento mais rapidamente e com menos erros. O agente lê a especificação da API em tempo real antes de gerar qualquer código, valida os payloads das solicitações em relação aos esquemas e explica os códigos de erro a partir da documentação atual.
Agente de QA Localpayment
Valide sua integração antes de entrar em produção. O agente verifica sua implementação em relação à especificação em tempo real, sinaliza campos obrigatórios ausentes, testa casos extremos e gera um relatório de validação estruturado.
Todos os agentes usam o mesmo servidor e ferramentas MCP. Você pode combiná-los, estendê-los ou usá-los como modelos para criar seu próprio agente especializado para qualquer tarefa de integração.
Pré-requisitos
Antes de implementar qualquer agente Localpayment, certifique-se de que você possui: Requisitos do LLM (obrigatórios):- Suporte para invocação de funções/ferramentas — o LLM deve suportar a invocação estruturada de ferramentas. O MCP é construído sobre a invocação de funções. Qualquer modelo sem essa capacidade não pode usar as ferramentas do MCP.
- Janela de contexto mínima de 32 mil tokens — recomenda-se 200 mil ou mais para integrações complexas de várias etapas que leem diversos esquemas e guias de API em uma única sessão.
- Suporte para saída JSON — necessário para respostas estruturadas da ferramenta.
- Acesso à Internet para
https://docs.localpayment.com/mcp - Credenciais da API Localpayment (Stage) para testar sua integração real.
- Python 3.10+ ou Node.js 18+, dependendo do seu framework.
- 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
- Modelos locais via Ollama ou LM Studio: Qwen3.6, Llama 4 (Scout/Maverick), Phi-4, Mistral Small 4 — qualquer modelo com suporte confirmado para chamadas de função/ferramenta.
Parâmetros recomendados para o LLM
Agentes que acionam ferramentas e geram código de integração requerem configurações diferentes daquelas necessárias para tarefas criativas ou conversacionais.Observações específicas da estrutura:
- OpenAI SDK / LangChain: Defina
temperature=0na configuração deChatOpenAIouAgent. - Vercel AI SDK: Passe
temperature: 0nas opções degenerateText. - CrewAI: Defina
temperature=0no parâmetrollmdo seuAgent. - AgentScope: Configure via
model_configsemagentscope.init(). - Amazon Bedrock: Passe
temperaturenoinferenceConfigda chamadaconverse.
Agente Integrador Localpayment
ID:localpayment-integrator
Propósito: Ajudar desenvolvedores a criar integrações precisas com a API da Localpayment.
O que faz
- Consulta o servidor MCP sob demanda — apenas o que cada pergunta exige, minimizando a sobrecarga de tokens.
- Descobre os endpoints disponíveis com
list-endpointsesearch-endpointsquando necessário - Lê esquemas e parâmetros em tempo real com
get-endpointantes de gerar qualquer código - Encontra e lê guias de documentação com
searchefetch - Gera código de integração completo e executável, validado em relação à especificação atual.
- Lê sua base de código existente (em ambientes com agentes) e adapta o código gerado à sua arquitetura.
- Explica os códigos de erro buscando a referência do código de erro em tempo real — nunca da memória.
- Aplica as melhores práticas de segurança, arquitetura e PCI em todas as respostas.
- Sinaliza diferenças entre Stage e Produção com base na documentação atual
Mensagem do sistema
Agente de QA Localpayment
ID:localpayment-qa
Propósito: Validar uma integração existente da Localpayment em relação à especificação da API em tempo real antes do go-live.
O que faz
- Lê a especificação em tempo real para entender o que cada endpoint exige.
- Analisa as cargas úteis e o código das solicitações enviadas em busca de campos ausentes ou inválidos.
- Verifica a lógica do manipulador de webhook em relação ao guia de notificações atual.
- Testa o tratamento de erros em relação ao catálogo de códigos de erro documentado.
- Gera um relatório de validação estruturado com itens aprovados/reprovados e correções recomendadas.
Mensagem do sistema
Integre ao seu projeto
A maneira mais eficaz de usar o Agente Integrador do Localpayment é incorporá-lo permanentemente ao seu projeto, e não apenas em uma interação pontual. Uma vez incorporado, o agente se torna um especialista que conhece tanto a API do Localpayment quanto o seu código-fonte simultaneamente.Privacidade: A Localpayment não tem acesso ao seu projeto.Ao instalar um agente Localpayment, três coisas acontecem — e nenhuma delas dá ao Localpayment acesso ao seu código:
- O prompt do sistema é um arquivo de texto que você copia para o seu computador (
.cursor/rules,AGENTS.md, etc.). Uma vez copiado, o Localpayment não tem visibilidade dele nem do seu projeto. - O servidor MCP (
https://docs.localpayment.com/mcp) é um servidor de documentação público, somente leitura. Sua ferramenta de IA envia consultas como “mostre-me o endpoint X” e recebe como resposta a documentação pública — o mesmo conteúdo disponível emdocs.localpayment.com. O servidor MCP nunca recebe seu código, credenciais ou quaisquer dados privados. - Seu código-fonte é processado localmente pela sua ferramenta de IA e enviado ao provedor de IA escolhido (Anthropic, OpenAI, Google, etc.) de acordo com a política de privacidade desse provedor — e não para a Localpayment.
Passo 1 — Adicione regras ao seu projeto
Adicione o prompt do sistema ao arquivo de regras de IA do seu projeto. O agente será aplicado automaticamente a todas as sessões:- Cursor
- Claude Code
- OpenCode
- OpenHands
Crie
.cursor/rules na raiz do seu projeto e cole o prompt do sistema. O Cursor Agent o utilizará em todas as sessões deste projeto.Etapa 2 — Expanda com sua arquitetura
O prompt do sistema foi projetado para ser estendido. Após a última seção##, adicione o contexto específico do seu projeto para que o agente gere um código que se adapte à sua base de código existente:
Etapa 3 — Geração autônoma de módulos
Com o agente integrado e o contexto da sua arquitetura adicionado, você pode delegar tarefas de integração completas:- Leia seus arquivos de serviço existentes.
- Consulte o MCP do Localpayment para obter os esquemas de endpoint atuais.
- Gere todos os arquivos no local correto, seguindo suas convenções de nomenclatura.
- Aplique automaticamente as melhores práticas de PCI e segurança.
- Execute seus testes (em ferramentas como Cursor ou OpenHands) e corrija quaisquer falhas.
Implementar por meio de estrutura
As abas de framework abaixo se aplicam a qualquer agente nesta biblioteca. SubstituaSYSTEM_PROMPT pelo prompt do sistema do agente que você deseja implantar.
- MCP (Qualquer ferramenta)
- SDK de Agentes OpenAI
- LangChain
- SDK de IA Vercel
- CrewAI
- AgentScope
- Amazon Bedrock
- OpenCode
- OpenHands
A forma mais simples de implementar um agente Localpayment é com qualquer ferramenta compatível com MCP (Cursor, Claude Desktop, VS Code, Windsurf, ChatGPT, OpenHands, OpenCode e outras).
- Configure o servidor MCP para sua ferramenta.
- Crie uma nova sessão e cole o prompt do sistema do agente como instrução inicial, arquivo de regras personalizadas ou instruções do projeto.
.cursor/rules no seu projeto e cole o prompt do sistema.No Claude Desktop, abra as configurações do seu projeto e cole a mensagem do sistema no campo Instruções do Projeto.No OpenHands, cole o prompt do sistema como instrução inicial do agente antes de iniciar a tarefa.Comparação de estruturas
Padrões e Ecossistema
Os agentes do Localpayment são construídos com base em padrões abertos. Compreender o ecossistema ajuda na extensão de agentes ou na criação de fluxos de trabalho com múltiplos agentes.Fluxos de trabalho multiagentes
Os agentes da Localpayment trabalham em conjunto com os agentes do seu projeto já existentes. Um fluxo de trabalho típico combina seus agentes internos (que conhecem seu código-fonte e arquitetura) com os agentes especialistas da Localpayment (que conhecem a API da Localpayment via MCP): Exemplo de prompt para o seu agente orquestrador (Cursor / Claude Code):Compartilhe e distribua seus agentes
Ao contrário dos servidores MCP (que possuem links diretos para instalação), os prompts do sistema do agente são distribuídos como arquivos. A abordagem recomendada depende da configuração da sua equipe: Para uso individual: Copie o prompt do sistema desta página e adicione-o ao arquivo de regras ou instruções da sua ferramenta. Não é necessária instalação. Para distribuição em equipe via git: A maneira mais confiável de compartilhar agentes com sua equipe é adicionar os arquivos de configuração do sistema ao repositório do projeto. Todos os membros da equipe recebem automaticamente a mesma configuração de agente ao clonar ou atualizar o repositório. Para Claude Code — crie.claude/agents/localpayment-integrator.md:
.cursor/rules com o conteúdo do prompt do sistema. Todos os membros da equipe que trabalham nesse repositório recebem o agente automaticamente.
Para OpenCode — faça commit de AGENTS.md com o prompt do sistema. O OpenCode o carrega em cada sessão.
Seguindo o padrão aberto AGENTS.md:
O formato AGENTS.md é reconhecido pelo Claude Code, Goose e outras plataformas de agentes. Ele usa YAML como cabeçalho para metadados e Markdown para instruções — a mesma estrutura dos prompts do sistema acima.
Sessão de exemplo
Desenvolvedor: Preciso validar minha integração com o CVU da Argentina antes de entrar em produção. Agente de QA Localpayment: (chamaget-endpoint POST /api/virtual-account → lê o esquema em tempo real)
(chama search("receive payment notifications") → busca o guia de webhooks)
Componente analisado: POST /api/virtual-account (CVU da Argentina)
Versão da especificação consultada: Esquema em tempo real via MCP get-endpoint
✅ APROVADO
externalIdé o formato UUID- Todos os campos obrigatórios presentes:
country,accountNumber,beneficiary.type,beneficiary.name
beneficiary.documenté opcional para empresas locais na Argentina, mas recomendado para fins de conciliação.
- O manipulador de webhook não verifica
internalIdpara processamento duplicado — adicione uma verificação de idempotência antes de creditar o pagamento.
Biblioteca de prompts
Instruções prontas para usar, para tirar o máximo proveito de qualquer agente Localpayment.
Segurança de IA
Melhores práticas para usar ferramentas de IA com segurança em um contexto de integração fintech.

