Conectando seu agente

Tudo que a CLI faz, o seu agente também faz. Há três maneiras, da mais simples para a mais independente. Em todas, o agente age com o seu usuário: ele enxerga só os seus sites e cada ação fica registrada no seu nome.

Em qualquer caso, instale a CLI e faça rapadura login uma vez (Começando). É esse login que o agente reaproveita.

1. Deixe o agente usar a CLI

Se o seu agente roda comandos no seu computador (Claude Code, Codex CLI, Cursor em modo agente), basta a CLI estar instalada e logada. Peça em português mesmo:

Publique a pasta ./dist como o hotsite meetup-sobral no rapadura, crie se não existir, e me diga o endereço.

O agente vai rodar algo como rapadura publish ./dist --site meetup-sobral --create --json e ler o recibo. Para ensiná-lo de uma vez, aponte para o arquivo de habilidade: https://agents.rapadura.net/skill.md. No Claude Code, por exemplo, salve o conteúdo em .claude/skills/rapadura/SKILL.md no projeto.

2. Ferramentas MCP locais (recomendado)

A própria CLI é um servidor MCP. Registre uma vez e o agente passa a ter as ferramentas publish_site, list_sites, rollback_site e companhia, com upload direto das pastas do seu disco.

Claude Code

claude mcp add rapadura -- rapadura mcp

Cursor (em ~/.cursor/mcp.json ou no .cursor/mcp.json do projeto)

{ "mcpServers": { "rapadura": { "command": "rapadura", "args": ["mcp"] } } }

Codex CLI (em ~/.codex/config.toml)

[mcp_servers.rapadura]
command = "rapadura"
args = ["mcp"]

Claude Desktop (em claude_desktop_config.json)

{ "mcpServers": { "rapadura": { "command": "rapadura", "args": ["mcp"] } } }

Se o agente reclamar que não achou o comando, use o caminho completo (~/.local/bin/rapadura).

3. MCP hospedado (sem instalar nada)

Para agentes que rodam fora do seu computador, o gateway oferece MCP por HTTP em https://agents.rapadura.net/mcp, autenticado com o seu token. O token é o mesmo que o rapadura login grava; se precisar de um para outro lugar, faça login lá ou peça ao administrador.

Claude Code

claude mcp add --transport http rapadura https://agents.rapadura.net/mcp \
  --header "Authorization: Bearer SEU_TOKEN"

Nessa modalidade o gateway não lê o seu disco: o publish_site recebe os arquivos inline (files: [{path, content}]). Serve bem para o agente que escreve o HTML na hora.

Conectores do claude.ai (que exigem OAuth) ainda não são suportados; está no plano.

O que as ferramentas fazem

Toda escrita devolve um recibo lido de volta do servidor: endereço, versão, o que mudou e avisos. Peça ao agente para te dizer o endereço e a versão, não só "pronto".