Sprawl

Seus primeiros cinco minutos

Um lugar para executar as operações da sua empresa, a partir do agente que você já usa. Esta página é o passo a passo, em ordem, com os tempos que medimos em produção — instale, autorize, descreva o que você precisa e pergunte, do mesmo terminal, o que aconteceu. Um comando para instalar. Minutos para uma operação provisionada. O último passo antes de qualquer coisa rodar é uma visita ao seu navegador, e é um passo próprio aqui, não uma nota de rodapé.

Passo 1 · cerca de dois segundos

Instale

Um comando, no agente que você já tem aberto. Ele não carrega chave — o servidor anuncia OAuth e seu agente assume a partir daí.

Claude Code

claude mcp add --transport http sprawl https://sprawl.to/api/mcp

Codex

codex mcp add sprawl --url https://sprawl.to/api/mcp

Qualquer outro cliente MCP: aponte-o para https://sprawl.to/api/mcp via HTTP streamable. Ambos os comandos acima conectaram em cerca de dois segundos quando os cronometramos contra produção.

Passo 2 · no seu navegador

Ele autoriza como você, via OAuth

Se o seu agente consegue abrir um navegador, não há mais nada a fazer. Na primeira vez que ele chama uma ferramenta do Sprawl, o servidor responde com o endereço do seu servidor de autorização, seu agente se registra e uma tela de consentimento abre no seu navegador. Você aprova uma vez. Sem chave para criar, copiar ou colar em lugar nenhum.

É OAuth 2.1 com PKCE e registro dinâmico de cliente, então um cliente que nunca viu o Sprawl antes consegue completar o handshake sem nada pré-combinado. Os dois documentos que fazem isso funcionar são públicos e não autenticados, se você ou seu agente quiserem lê-los primeiro:

• /.well-known/oauth-protected-resource — nomeia o endpoint e quem o autoriza
• /.well-known/oauth-authorization-server — o endpoint de autorização, registro e S256

Você precisará de uma conta Sprawl para aprovar a tela de consentimento — criar uma é grátis, não exige cartão e começa com $3 de uso.

Passo 2, do outro jeito · sem navegador

Ou carregue uma chave com escopo, para chamadas headless

CI, um contêiner, uma sessão -p sem onde abrir uma tela de consentimento — esses não conseguem concluir um handshake OAuth, então carregam uma chave bearer. Crie uma em Configurações → Chaves de API depois de ter uma conta. As chaves têm o prefixo sprawl_sk_ para serem fáceis de reconhecer em um arquivo de configuração.

Aceitar os padrões do diálogo é suficiente para montar uma operação. Nem sempre foi assim: uma chave padrão costumava ser recusada na última etapa, depois que o blueprint já estava desenhado. Isso foi corrigido, e um teste contra produção ao vivo mantém a correção.

Claude Code

claude mcp add --transport http sprawl https://sprawl.to/api/mcp \ --header "Authorization: Bearer sprawl_sk_..."

Codex

SPRAWL_API_KEY=sprawl_sk_... codex mcp add sprawl --url https://sprawl.to/api/mcp \ --bearer-token-env-var SPRAWL_API_KEY

Os dois não são um único comando com um verbo diferente. O Codex escreve TOML, e sua única flag de autenticação aceita o nome de uma variável de ambiente em vez da chave em si — então o JSON abaixo não tem equivalente no Codex.

Qualquer outro cliente MCP que aceite uma configuração de servidor HTTP assume esta forma. Um aviso que vale ter antecipadamente: adicionar um servidor editando este arquivo à mão o deixa ⏸ Pending approval no Claude Code até você abrir o TUI interativo uma vez. O comando claude mcp add acima não tem essa etapa, e é por isso que é o que apresentamos primeiro.

{
  "mcpServers": {
    "sprawl": {
      "type": "http",
      "url": "https://sprawl.to/api/mcp",
      "headers": { "Authorization": "Bearer sprawl_sk_..." }
    }
  }
}

Para confirmar que uma chave funciona antes de conectar qualquer coisa:

curl -s https://sprawl.to/api/mcp \
  -H "Authorization: Bearer sprawl_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Um descritor legível por máquina — ferramentas, autenticação, prompts e preços — é servido sem autenticação em /.well-known/mcp/server-card.json.

Passo 3 · cerca de quatro minutos, quatro turnos

Diga o que você precisa

Nada para aprender antes. Quando percorremos isso em produção, a frase digitada foi:

"configure suporte para meu SaaS: faça triagem da caixa de entrada, rascunhe respostas, me pergunte antes de enviar."

O que veio de volta, em ordem:

• Ele fez uma pergunta. Em qual plataforma a caixa de entrada de suporte está — a única coisa que não conseguia adivinhar — e propôs um modelo para o trabalho com o custo anexado. Ainda não criou nada.
• Ele propôs um blueprint. A operação inteira como um objeto revisável: os agentes, suas habilidades, seus agendamentos, os objetivos e as contas que cada um precisa.
• Você aprova, e ele provisiona. Nossa caminhada produziu um agente, uma habilidade, uma entrada de conhecimento, dois objetivos e uma automação, em um único passo atômico. Nada existe até essa aprovação.

Quatro minutos e quatro turnos, do início ao fim. Você nunca é obrigado a saber o que é uma "operação", uma "frota" ou uma "concessão" — essas palavras aparecem no resumo que seu agente escreve de volta, não nas perguntas que ele faz a você.

Passo 4 · uma visita ao navegador

Conecte as contas antes de rodar

Este é o passo que seu agente de codificação não pode fazer por você, e preferimos que você ouça aqui do que descubra depois. Uma operação provisionada ainda não é uma operação em execução. Cada agente age como uma conta que você concede a ele, e conceder uma significa completar o login do próprio provedor — a tela de consentimento do Google, a do Slack, a do Stripe. Isso acontece em um navegador.

Seu agente entrega o link em vez de fingir: ele retorna a URL de conexão e para. Até você segui-lo, as execuções são puladas em vez de falharem silenciosamente, e o relatório de execução diz isso em palavras — "Gmail não está conectado. Não consigo acessar a caixa de entrada de suporte nesta execução."

Uma conta concedida pode servir a mais de um agente — cada um mantém sua própria concessão com escopo para ela, então um agente de suporte e um de marketing podem compartilhar um login e ainda assim ver apenas suas próprias caixas de entrada — e qualquer coisa que você não estiver pronto para conectar fica pausada até você estar.

Passo 5 · do mesmo terminal

"O que aconteceu?" e "o que precisa de mim?"

Depois que a frota está rodando, você fecha a sessão e ela continua. As duas perguntas que você realmente fará são digitadas, não adivinhadas — o Sprawl as publica como prompts nomeados, que um host como o Claude Code renderiza como comandos de barra:

• /what-happened — O que aconteceu? As execuções de cada automação, o que falhou e por quê nas palavras do próprio provedor, quanto tempo levaram, quanto cada uma custou em dólares e qualquer coisa que era devida e nunca disparou.
• /what-needs-me — O que precisa de mim? O que está esperando sua aprovação, o que está atrasado e o que expirou sem ação — então a resposta para "tem algo travado?" é uma pergunta que você digita, não um nome de ferramenta que você adivinha.

Esta é a metade da caminhada que falhou na primeira vez. Perguntar a uma sessão nova "o que aconteceu?" em inglês simples alcançou o Sprawl zero vezes — as ferramentas certas existiam e tinham que ser adivinhadas pelo nome. Agora são perguntas nomeadas. Quando remedimos em seis sessões novas, uma sessão que conhecia os nomes publicados alcançou uma ferramenta do Sprawl nas primeiras chamadas todas as vezes; uma que só tinha o nome da ferramenta puro errou na primeira busca todas as vezes.

Traga uma habilidade que você já tem

Se você mantém procedimentos como arquivos SKILL.md — o formato portátil que Claude Code, Codex e Cursor leem — seu agente pode entregar um ao Sprawl em vez de reescrevê-lo. Aponte-o para um SKILL.md público do GitHub ou uma página do skills.sh e o Sprawl o salva como uma de suas habilidades, depois concede a qual agente deve segui-la. Habilidades que o Sprawl aprende das suas próprias execuções ficam no Sprawl por enquanto — ainda não há exportação de volta para um arquivo.

Quanto custa

Não há assinatura. Toda conta começa com $3 de uso, cada execução tira seu próprio preço desse saldo, e você adiciona mais quando quiser — a partir de $5, sem nunca expirar. Projetar uma operação no construtor é grátis; seu saldo vai para o trabalho que seus agentes fazem, não para descrevê-lo.

sprawl_get_usage retorna o saldo restante em dólares, o que foi gasto neste mês e a página de cobrança para adicionar mais. Adicionar saldo é uma ação do dono da conta — um agente pode mostrar o link e não pode cobrar um cartão. Quando o saldo acaba, as execuções pausam em vez de cobrar.

O Sprawl também expõe endpoints do Agentic Commerce Protocol (o padrão aberto da OpenAI e Stripe) para recargas, então um agente pode executar um checkout baseado em padrões ele mesmo: um feed público em GET /api/acp/feed, e criar / redefinir preço / recuperar / cancelar em /api/acp/checkout_sessions. A conclusão de pagamento via Shared Payment Token ainda não está habilitada — até lá, uma sessão pode ser criada e precificada, mas não paga, e o dono da conta adiciona saldo pela página de cobrança.

Comece onde você já está

Execute a linha de instalação no agente que você tem aberto. Se preferir explorar antes, uma conta é grátis e começa com $3 de uso.

Crie uma conta grátis