Pipehero
O Pipehero cria um túnel do seu localhost para uma URL pública e captura todos os webhooks, permitindo que você os inspecione, reproduza e depure — inclusive a partir do seu agente de IA via MCP.
Documentação
Pipehero — servidor MCP + skill
Pipehero cria um túnel do seu localhost para uma URL pública e captura
cada webhook, para que você possa inspecionar, reproduzir e depurar — inclusive a partir do seu
agente de IA via MCP.
Este repositório é publicado automaticamente a partir do código-fonte do Pipehero. Ele contém o manifesto público do MCP e a skill do agente. Issues/PRs são bem-vindos.
- 🌐 Site: https://pipehero.app
- 📚 Documentação: https://pipehero.app/docs
Conecte o servidor MCP
Permita que um agente (Claude Code, Cursor, Copilot, Windsurf, Zed, …) liste seus túneis, leia webhooks capturados e os reproduza em localhost.
Remoto — recomendado (sem instalação, OAuth)
claude mcp add --transport http pipehero https://mcp.pipehero.app/mcp
Seu cliente abre o navegador para você entrar e aprovar — sem necessidade de colar token.
Para CI/headless, passe um token de https://pipehero.app/dashboard/settings:
claude mcp add --transport http pipehero https://mcp.pipehero.app/mcp \
--header "Authorization: Bearer <token>"
Local — via CLI
curl -fsSL https://pipehero.app/install | sh
pipehero login
claude mcp add pipehero -- pipehero mcp
Qualquer cliente MCP funciona — adicione-o ao .cursor/mcp.json, claude_desktop_config.json, etc.:
{ "mcpServers": { "pipehero": { "command": "pipehero", "args": ["mcp"] } } }
Ferramentas
| Ferramenta | O que faz |
|---|---|
list_tunnels | Seus túneis e se cada um está online. |
list_requests(subdomain) | Webhooks capturados recentemente para um túnel. |
get_request(subdomain, id) | Requisição + resposta completas (cabeçalhos + corpo). |
replay_request(subdomain, id) | Reproduz um webhook no seu localhost. |
start_tunnel(name, port) | Expõe uma porta local em uma URL pública (somente MCP local). |
stop_tunnel(name) | Interrompe um túnel iniciado com start_tunnel (somente MCP local). |
list_api_collections, get_api_collection(collection_id) | Suas documentações de API salvas: pastas, endpoints, ambientes (MCP remoto, e local a partir da 0.1.14). |
get_api_endpoint(collection_id, method + path) | Um endpoint completo, com sua versão e exemplos de resposta. |
upsert_api_endpoint(collection_id, method, path, …) | Cria ou atualiza um endpoint por rota, para que a documentação acompanhe seu código. |
add_api_example(collection_id, method + path, name, status, …) | Salva um exemplo de resposta. |
delete_api_endpoint(collection_id, method + path) | Remove um endpoint cuja rota não existe mais. |
import_api_spec(format, content) / export_api_collection(collection_id) | OpenAPI, Postman e curl, nos dois sentidos. |
run_api_endpoint(collection_id, method + path, environment) | Envia e lê a resposta real. |
save_captured_request(collection_id, tunnel, request_id) | Transforma uma requisição real capturada em documentação, sem credenciais. |
check_api_drift(collection_id, tunnel) | Compara a documentação com o tráfego real (Pro/Team). |
list_api_monitors(collection_id) | Quais endpoints estão monitorados e quais estão falhando, com o último erro (Pro/Team). |
list_api_proposals | O que aconteceu com suas alterações propostas, em workspaces que revisam alterações de IA. |
Como seu agente tem tanto o webhook capturado quanto seu código-fonte, ele pode explicar por que um handler falhou — e então corrigi-lo e reproduzir para confirmar.
Skill
Instale a skill para que seu agente saiba quando e como usar o Pipehero:
pipehero skill install
ou copie SKILL.md para ~/.claude/skills/pipehero/SKILL.md.
Licença
MIT