Construa um Servidor MCP Pago em 5 Minutos (Tutorial Completo)

Você tem um servidor MCP. Ele funciona. Agora faça com que ele te pague.

Este tutorial leva você de pip install a um servidor MCP pago funcionando em menos de 5 minutos. Vamos construir um serviço de clima, colocar uma barreira de pagamento em USDC nele e testar todo o fluxo de comprador-vendedor.

Nenhuma experiência prévia em criptomoedas é necessária.

O Que Você Vai Precisar

• Python 3.10+
• Dois terminais
• 5 minutos

python3 --version
# Python 3.10.x ou superior ✓

Passo 1: Instalar (30 segundos)

pip install ag402-core fastmcp

Verifique:

ag402 --version

Isso instala o ag402 CLI (gerenciamento de carteira + proxy reverso), o ag402_core SDK Python (pagamento automático do lado do comprador) e fastmcp (para nosso servidor de demonstração).

Passo 2: Crie Sua Carteira (30 segundos)

ag402 init

Isso gera um par de chaves Solana e o carrega com USDC de teste para desenvolvimento. Os detalhes da carteira são armazenados criptografados em ~/.ag402/wallet.json.

Salve o endereço da sua carteira — você precisará dele no Passo 4.

No modo de teste, o ag402 cunha USDC devnet para que você possa experimentar gratuitamente. Para produção, defina X402_MODE=production e financie com USDC real.

Passo 3: Construa um Servidor MCP Simples (2 minutos)

mkdir my-paid-mcp && cd my-paid-mcp

Crie weather_server.py:

from fastmcp import FastMCP

mcp = FastMCP("Serviço de Clima")

WEATHER_DATA = {
    "san francisco": {"temp_c": 18, "condition": "nublado", "humidity": 75},
    "new york":      {"temp_c": 22, "condition": "ensolarado", "humidity": 45},
    "tokyo":         {"temp_c": 25, "condition": "nublado", "humidity": 60},
    "london":        {"temp_c": 15, "condition": "chuvoso", "humidity": 82},
}

@mcp.tool()
def get_weather(city: str) -> dict:
    """Obtenha o clima atual para uma cidade."""
    data = WEATHER_DATA.get(city.lower())
    if not data:
        return {"error": f"Sem dados para {city}"}
    return {"city": city, **data}

if __name__ == "__main__":
    # Use transporte HTTP para que ag402 possa proxyar requisições
    mcp.run(transport="streamable-http", port=3000)

Inicie no Terminal 1:

python weather_server.py
# Servidor rodando em http://localhost:3000

Por que não stdio? O proxy reverso do ag402 precisa de um endpoint HTTP para se posicionar à frente. O transporte stdio comunica via stdin/stdout, que não pode ser proxyado. streamable-http expõe