Construa um Servidor MCP Pago: Cobrança de Usuários Dentro do Claude

O Problema: Agentes de IA Também Precisam de Dinheiro

Você construiu um poderoso servidor de Protocolo de Contexto de Modelo (MCP). Talvez seja uma ferramenta de pesquisa, um gerador de código ou um analisador de conteúdo. O ecossistema de Claude adora isso. Os usuários estão pedindo. Mas aqui está a fricção:

Como você coleta o pagamento quando Claude está orquestrando toda a interação?

Fluxos de pagamento tradicionais quebram a autonomia do agente. Você não pode redirecionar para o checkout do Stripe e esperar que Claude lide com isso de forma elegante. Você precisa de uma solução de pagamento que:

• Funcione dentro do ambiente Claude
• Execute em milissegundos (sem redirecionamentos longos)
• Seja liquidada instantaneamente na sua conta bancária
• Nunca toque na memória do seu servidor

Esse é exatamente o problema que o AgentPay VN resolve.

Por que o AgentPay VN Muda o Jogo

AgentPay VN é um SDK Python de código aberto (licença MIT) + servidor MCP que permite que agentes de IA coletem pagamentos VietQR—o formato de pagamento QR padronizado do Vietnã—sem nunca segurar fundos.

Veja o que o torna diferente:

1. Zero responsabilidade: O dinheiro flui diretamente da conta do cliente → conta bancária do comerciante. Seu servidor nunca toca nos fundos.
2. Liquidação confirmada pelo banco: Um feed bancário verifica a confirmação de pagamento antes que seu agente continue.
3. Nativo de IA: Projetado para trabalhar com a tomada de decisão de Claude, e não contra ela.
4. Fluxo em três etapas: create_payment_request → send_checkout_url → await_settlement.
5. Integração fácil: Instale com pip install agentpay-vn e integre em menos de 20 minutos.

Diferente do Stripe ou PayPal, não há estado de sessão de longa duração, nenhuma complexidade de webhook e nenhuma fadiga de redirecionamento.

Arquitetura: Como os Pagamentos Fluem Através do Claude

Quando Claude usa um servidor MCP AgentPay, veja o que acontece:

Claude Agent                AgentPay MCP Server          VietQR/Banco
    |                              |                          |
    |--[solicitar pagamento]------->|                          |
    |                              |--[criar código QR]------->|
    |<--[URL de checkout]-----------|                          |
    |                              |                          |
    |--(envia para o usuário)----->| (usuário escaneia QR)    |
    |                              |                          |
    |                              |<--[pagamento recebido]---|
    |<--[aguardar liquidação OK]----|                          |
    |                              |                          |
    |--(continua fluxo de trabalho)--->|

O agente nunca espera cegamente. Ele verifica o status da liquidação, e o feed bancário confirma que o dinheiro chegou. Somente então ele prossegue.

Começando: Instalação & Configuração

Passo 1: Instale o SDK

pip install agentpay-vn

Passo 2: Defina Seus Detalhes Bancários

Crie um .env arquivo no seu projeto:

# .env
MERCHANT_BANK_ACCOUNT=1234567890
MERCHANT_BANK_NAME=VietcomBank  # ou seu banco vietnamita
MERCHANT_NAME="Seu Nome de Negócio"
AGENTPAY_API_KEY=seu_api_key_aqui  # de agentpay.servicesai.vn/v1/docs

Passo 3: Inicie o Servidor MCP

agentpay-mcp

Isso inicia um servidor local em http://localhost:3000 expondo as ferramentas do AgentPay para Claude.

Exemplo de Código 1: Fluxo Básico de Solicitação de Pagamento

Aqui está um script Python mínimo mostrando como criar e aguardar um pagamento:

from agentpay_vn import PaymentClient
import asyncio
import os

# Inicializa o cliente
client = PaymentClient(
    api_key=os.getenv("AGENTPAY_API_KEY"),
    merchant_bank="VietcomBank",
    merchant_account="1234567890"
)

async def charge_user_for_premium_feature():
    """
    Exemplo: O usuário quer desbloquear um relatório premium.
    Preço: 50.000 VND (~$2 USD)
    """

    # Passo 1: Criar uma solicitação de pagamento
    payment = await client.create_payment_request(
        amount_vnd=50000,
        description="Relatório Premium - Assinatura Mensal",
        customer_name="Nguyen Van A",
        order_id="ORD_2024_001"
    )
    # Retorna: { 'id': 'pay_abc123', 'checkout_url': 'https://...qr...', 'expires_at': '2024-...' }

    print(f"Envie esta URL para o cliente: {payment['checkout_url']}")
    # O cliente recebe um link com um código QR VietQR embutido.
    # Eles o escaneiam com seu aplicativo bancário e confirmam o pagamento.

    # Passo 2: Aguardar liquidação
    # Verifique a cada 2 segundos (o feed bancário é atualizado em 10-30 segundos no Vietnã)
    settlement = await client.await_settlement(
        payment_id=pay