Portproof
Ferramentas Portproof para saldo em GB, países online agora, URLs de proxy e testes. Pools compartilhados móveis e residenciais; compras exigem confirmação explícita.
Documentação
Portproof MCP
Conecte seu agente ao Portproof.
Verifique seu saldo de GB, escolha um pool e crie uma conexão de proxy a partir do seu cliente MCP. Tráfego móvel 4G/5G e residencial compartilham um único saldo pré-pago.
Site · Guia de configuração · Documentação · npm · Status
Servidor stdio local · Node.js 20+ · MIT · @portproof/mcp@0.2.1
Das configurações a uma conexão
| Seu fluxo de trabalho | Ferramentas MCP |
|---|---|
| Verifique preços e cobertura atual | get_pricing, list_countries, get_status |
| Veja seu tráfego restante | get_traffic |
| Escolha HTTP ou SOCKS5, país e rotação | build_proxy_url |
| Teste uma conexão | test_connection |
| Compre tráfego com sua confirmação | buy_traffic |
Ambos os pools são compartilhados. Uma sessão fixa mantém o mesmo dispositivo enquanto ele estiver online; o endereço IP dele pode mudar.
Conecte um cliente MCP
Adicione isto a um cliente que suporte servidores MCP stdio locais. Você pode explorar preços, status do serviço e cobertura atual sem uma chave de API.
{
"mcpServers": {
"portproof": {
"command": "npx",
"args": ["-y", "@portproof/mcp@0.2.1"]
}
}
}
Claude Desktop
Abra Configurações → Desenvolvedor → Editar Config e mescle o JSON acima em
claude_desktop_config.json. Mantenha as entradas existentes em mcpServers.
Salve o arquivo, saia completamente do Claude Desktop e reabra-o.
Instruções oficiais de configuração.
Cursor
Mescle o JSON acima no seu arquivo pessoal ~/.cursor/mcp.json. Isso torna o
Portproof disponível em todos os seus projetos sem armazenar configuração de conta
em um repositório de projeto. Verifique o servidor nas configurações de MCP do Cursor.
Guia oficial de configuração.
Claude Code
Registre o Portproof na sua configuração pessoal:
claude mcp add --transport stdio --scope user portproof -- npx -y @portproof/mcp@0.2.1
claude mcp get portproof
No Windows nativo, use cmd /c npx no lugar de npx no primeiro comando.
Dentro do Claude Code, /mcp mostra o status da conexão.
Configuração oficial de stdio e escopo do usuário.
Conecte sua conta
Crie uma chave no seu painel do Portproof e depois use esta configuração habilitada para conta:
{
"mcpServers": {
"portproof": {
"command": "npx",
"args": ["-y", "@portproof/mcp@0.2.1"],
"env": {
"PORTPROOF_API_KEY": "YOUR_PORTPROOF_API_KEY"
}
}
}
}
Mantenha o valor real na configuração privada do seu cliente MCP ou no cofre de segredos.
Nunca o envie para um repositório nem o coloque em um prompt. Ler o saldo de tráfego
exige ports:read; criar URLs de proxy, testar conexões e comprar tráfego
exigem ports:write.
Para Claude Desktop e Cursor, atualize o mesmo arquivo de configuração pessoal usado
acima. Para Claude Code, adicione o objeto env à entrada portproof em
mcpServers em ~/.claude.json e reinicie o cliente. Preserve as outras
configurações dele. Insira a chave nesse arquivo privado, e não em um comando de terminal.
| Configuração | Significado |
|---|---|
PORTPROOF_API_KEY | Opcional para ferramentas públicas; obrigatório para ferramentas de conta |
PORTPROOF_API_URL | Padrão é https://api.portproof.org; normalmente deixe sem definir |
O servidor roda localmente. A URL da API acima não é um endpoint MCP hospedado.
Compras e testes de conexão
As chaves agem sobre o crédito real da conta; não há sandbox selecionado por um prefixo de chave.
Testes de conexão usam uma pequena quantidade de tráfego. Compras exigem confirm: true
e um idempotency_key; compras de tráfego também exigem accept_terms: true.
O servidor instrui o cliente a perguntar antes de confirmar essas ações.
Senhas em URLs de proxy geradas permanecem mascaradas, a menos que sejam solicitadas explicitamente.
O pacote publicado também expõe ferramentas de gerenciamento de portas; a disponibilidade e a elegibilidade reais são determinadas pelo serviço. Veja a documentação para a oferta atual e o comportamento das ferramentas.
Sobre este repositório
Este é um espelho de lançamento de @portproof/mcp 0.2.1, contendo o pacote
JavaScript publicado. A loja e o espaço de trabalho original de desenvolvimento em TypeScript permanecem
privados. Proveniência do lançamento registra a integridade do tarball
npm e os hashes dos arquivos publicados.
Execute este espelho localmente
git clone https://github.com/portproofas/portproof-mcp.git
cd portproof-mcp
npm ci --ignore-scripts --no-audit --no-fund
npm run check
npm test
node dist/index.js --help
Para um cliente MCP local, use node com o caminho absoluto para dist/index.js.
Nenhuma etapa de build é necessária. package.json é adaptado para instalação
independente e marcado como privado para evitar republicar acidentalmente o espelho. O
manifesto original do pacote npm é mantido como upstream-package.json.
O lockfile fixa as versões de dependência usadas por este checkout. GitHub Actions executa as verificações de sintaxe e smoke tests no Node.js 20, 22 e 24, incluindo uma verificação no Windows com Node.js 22. Os smoke tests verificam os hashes dos arquivos publicados, a descoberta de ferramentas stdio e os bloqueios de compra sem usar uma conta ou chamar a API ao vivo.
Documentação e descoberta
- Guia de configuração do MCP
- Documentação de API e proxy
- Pacote npm
- Nome oficial no Registro MCP:
org.portproof/mcp - Status do serviço
server.json descreve o lançamento npm existente. O campo de repositório dele aponta para
este espelho; atualizar esse arquivo local não atualiza o Registro hospedado.
Use com responsabilidade
Use o Portproof para monitoramento legal de preços, verificação de anúncios, pesquisa de mercado, QA, testes geográficos e fluxos de trabalho de agentes. Siga os termos de cada site de destino e a política de uso aceitável do Portproof.
Licença
MIT. As dependências de tempo de execução mantêm suas próprias licenças.
Portproof · Obter proxies · Contatar suporte
