Paywallo

Agentes de IA (MCP)

Deixe o Claude Code, o Codex ou o Cursor ler os números do seu app no Paywallo. Eles só leem. Não mudam nada.

Passo 1: Criar a key

1

Com o seu app escolhido, clique em Configurações no menu lateral.

2

Clique em Assistente IA e depois em Criar key para agente.

3

Em Nome, escreva um nome, como meu-agente. Em Escopos, deixe marcado Agentes de IA (leitura via MCP). Clique em Criar.

4

Clique em Copiar. A key começa com sk_ e não aparece de novo.

Use no notebook?

Deixe IPs permitidos vazio. Com a lista preenchida, a key para de funcionar quando o seu IP muda.

Passo 2: Conectar o agente

Nos exemplos, troque sk_XXXX pela sua key. Depois de criar a key, o Paywallo também mostra estes comandos com a sua key já preenchida.

Claude Code

Cole no terminal:

bash
claude mcp add --transport http paywallo https://paywallo.com.br/api/mcp --header "Authorization: Bearer sk_XXXX"

Codex

Cole no terminal:

bash
export PAYWALLO_SERVER_KEY=sk_XXXX

Cole no arquivo ~/.codex/config.toml:

toml
[mcp_servers.paywallo]
url = "https://paywallo.com.br/api/mcp"
bearer_token_env_var = "PAYWALLO_SERVER_KEY"

Cursor

Cole no arquivo ~/.cursor/mcp.json:

json
{
  "mcpServers": {
    "paywallo": {
      "url": "https://paywallo.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_XXXX"
      }
    }
  }
}

Outro programa

Use o endereço https://paywallo.com.br/api/mcp e o cabeçalho Authorization: Bearer sk_XXXX. O tipo é HTTP (Streamable HTTP).

Passo 3: Testar

1

Abra o agente e escreva:

Liste os meus apps do Paywallo.
2

Se aparecer o nome do seu app, deu certo.

O que o agente pode ler

Você pode pedir em português. O agente escolhe a tool. Períodos aceitam até 92 dias (31 no funil).

ToolO que faz
list_appsLista os seus apps.
get_appDados de um app e se o SDK está ligado.
get_revenue_summaryReceita, MRR e trials de um período, em dólar (USD).
list_transactionsCompras, renovações e reembolsos, em dólar (USD). Sem e-mail do usuário.
list_ab_testsOs testes A/B do app.
get_ab_test_resultsResultado de um teste A/B, variante por variante.
list_linksLinks de rastreio, em dólar (USD). Precisa do plano Growth Hub.
get_attribution_summaryAtribuição por canal, em reais (BRL). Precisa do plano Growth Hub.
get_funnelEm que passo do onboarding o usuário desiste. Precisa do recurso Onboarding.
tail_eventsEventos que o SDK mandou nos últimos 60 minutos.
get_integration_healthConfere SDK, lojas e integrações.
search_docsBusca na documentação.
get_docLê uma página da documentação.

Segurança

A key só lê. Nenhuma tool cria, muda ou apaga dado. Cada chamada fica registrada.

Para cortar o acesso, clique em Configurações, depois em Server Keys, e revogue a key. Vale em até 2 minutos.

Se der erro

ErroComo resolver

401

A key está errada, apagada ou revogada. Copie a key de novo. Se acabou de revogar, espere 2 minutos.

403, escopo

A key não tem o escopo Agentes de IA (leitura via MCP). Crie outra key com ele marcado.

403, IP

A key tem IPs permitidos e o seu IP não está na lista. Crie uma key com IPs permitidos vazio.

403, conta suspensa

Há uma cobrança em aberto na sua conta. Pague no Paywallo e tente de novo.

429

Muitos pedidos. O limite é 120 por minuto por key. Espere um minuto.

Desenvolvido e mantido por Virex