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

O Problema: Ferramentas Gratuitas Não Escalam

Você construiu algo útil—um servidor MCP Claude que ajuda os usuários a fazer pesquisas, gerar conteúdo ou gerenciar dados. Sua ferramenta recebe 500 solicitações por semana. Mas você está cobrindo os custos de infraestrutura sozinho, e cada recurso popular que você adiciona consome mais créditos na nuvem. Você se pergunta: "Como posso cobrar dos usuários sem me tornar uma empresa fintech?"

Essa é a lacuna exata que o AgentPay VN preenche. Agora você pode aceitar pagamentos diretamente dentro das conversas do Claude sem nunca tocar no dinheiro, manter dados de clientes ou gerenciar uma integração de processador de pagamentos você mesmo. Seus usuários recebem seu link de checkout VietQR, escaneiam com o aplicativo do banco e seu servidor MCP imediatamente sabe que o pagamento foi bem-sucedido—tudo em menos de 3 segundos.

Vamos construir isso.

Por Que os Pagamentos MCP São Diferentes

O SaaS tradicional exige que os usuários saiam do seu produto, vão a um site, insiram um cartão de crédito e retornem. Com servidores MCP rodando dentro do Claude, os pagamentos se tornam conversacionais. Um usuário pede algo premium à sua ferramenta. Você apresenta um código QR. Eles escaneiam. A liquidação é confirmada em segundos. Eles voltam à conversa—sem fricção, sem redirecionamentos de página, sem formulários de inscrição.

O AgentPay VN lida com isso porque:

• Licença MIT de código aberto – Implante em qualquer lugar, modifique livremente
• Arquitetura de conhecimento zero – O QR aponta diretamente para a conta bancária do comerciante; o AgentPay nunca mantém fundos
• Confirmação de liquidação em nível bancário – Um feed do seu banco informa ao seu código quando o dinheiro chegou
• Leve – Apenas 3 linhas de lógica de fluxo: criar solicitação → enviar URL → aguardar liquidação

Como o AgentPay VN Funciona (O Fluxo de 3 Linhas)

Entender a arquitetura primeiro economiza depuração depois:

1. Criar Solicitação de Pagamento – Você especifica o valor e os metadados (ID do usuário, nome do recurso, etc.)
2. Enviar URL de Checkout – A resposta inclui um checkout_url que renderiza um código QR VietQR
3. Aguardar Liquidação – Poll ou webhook para confirmar que a transferência bancária do usuário chegou

Seu usuário vê um QR simples no Claude. Eles escaneiam com o aplicativo do banco. O banco deles envia o pagamento diretamente para sua conta bancária de comerciante registrada. O feed bancário do AgentPay monitora sua conta e informa ao seu servidor MCP "pagamento liberado." Seu código então desbloqueia o recurso.

Nenhum intermediário mantém dinheiro. Sem fricção de cartão de crédito. Transferência bancária pura.

Instalação & Configuração

Passo 1: Instale o SDK

pip install agentpay-vn

Isso lhe dá o cliente Python para se comunicar com a API do AgentPay.

Passo 2: Registre Sua Conta Bancária

Visite https://agentpay.servicesai.vn/v1/docs e registre sua conta de comerciante VietQR. Você receberá:

• merchant_id (identificador único para sua conta)
• api_key (token de autenticação)
• Um feed bancário configurado para sua conta bancária de comerciante registrada

Passo 3: Configure Seu Ambiente de Servidor MCP

Armazene suas credenciais com segurança:

export AGENTPAY_MERCHANT_ID="your_merchant_id"
export AGENTPAY_API_KEY="your_api_key"

Construindo Sua Primeira Ferramenta MCP Paga

Exemplo de Código 1: Criando uma Solicitação de Pagamento

Aqui está um servidor MCP completo que cobra dos usuários por um recurso de "relatório de pesquisa premium":

import os
import json
from agentpay_vn import AgentPayClient
from datetime import datetime, timedelta

# Inicializa o cliente AgentPay com suas credenciais
client = AgentPayClient(
    merchant_id=os.getenv("AGENTPAY_MERCHANT_ID"),
    api_key=os.getenv("AGENTPAY_API_KEY")
)

def create_premium_research_request(user_id: str, research_topic: str) -> dict:
    """
    Cria uma solicitação de pagamento para pesquisa premium.
    O usuário paga 50.000 VND por análise detalhada.
    """

    # Passo 1: Criar solicitação de pagamento com AgentPay
    payment_request = client.create_payment_request(
        amount=50000,  # 50.000 VND
        description=f"Relatório de pesquisa premium: {research_topic}",
        metadata={
            "user_id": user_id,
            "feature": "premium_research",
            "topic": research_topic,
            "timestamp": datetime.now().isoformat()
        },
        expires_in=600  # QR code válido por 10 minutos
    )

    # Passo 2: Extrair URL de checkout para exibição ao usuário
    checkout_url