O servidor MCP da ProxyBox deixa o seu assistente de IA trabalhar com os seus proxies. Você pede em português, e ele lista os IPs, testa, pede troca, cota, compra com o saldo e monta a configuração para a ferramenta que você usa. Por baixo, ele chama a mesma API do painel, com a sua chave.
Funciona no Claude Desktop, no Claude Code, no Cursor e no VS Code.
O que você precisa
- Uma conta na ProxyBox. Para comprar pela IA, a conta precisa ter saldo na carteira (Pix pelo painel).
- O Node.js 20 ou mais novo instalado no computador. Para conferir, rode
node -vno terminal. - Uma chave de API, criada em Chaves de API.
1. Criar a chave
Em Chaves de API, dê um nome (ex.: "Claude no notebook") e escolha a permissão:
- Somente leitura: a IA consulta catálogo, preços, proxies, pedidos e saldo. Não testa, não compra e não muda nada.
- Leitura e escrita: a IA também testa proxy, pede troca de IP, liga e desliga a renovação, renova e compra com o saldo (dentro do limite que você definir no passo 2).
A chave aparece uma vez só. A própria página já mostra a configuração do MCP com a chave preenchida.
2. Colar a configuração
O bloco é o mesmo para quase todos os programas. Troque SUA_CHAVE pela chave do passo 1:
{
"mcpServers": {
"proxybox": {
"command": "npx",
"args": ["-y", "https://proxybox.com.br/mcp/proxybox-mcp-0.1.0.tgz"],
"env": {
"PROXYBOX_TOKEN": "SUA_CHAVE",
"PROXYBOX_SITE": "br",
"PROXYBOX_LIMITE_GASTO": "0"
}
}
}
}
Onde colar em cada programa:
| Programa | Onde fica |
|---|---|
| Claude Desktop | Configurações → Desenvolvedor → Editar configuração (arquivo claude_desktop_config.json) |
| Claude Code | Rode claude mcp add-json proxybox '<o bloco "proxybox" acima>' ou cole no .mcp.json do projeto |
| Cursor | Configurações → MCP → Adicionar servidor (arquivo ~/.cursor/mcp.json) |
| VS Code | Arquivo .vscode/mcp.json, com a chave servers no lugar de mcpServers e "type": "stdio" dentro de proxybox |
Depois de salvar, feche e abra o programa de novo. A ProxyBox aparece na lista de ferramentas.
3. Definir o limite de gasto
PROXYBOX_LIMITE_GASTO é o máximo, em reais, que a IA pode gastar em compras e renovações enquanto o programa estiver aberto.
- 0 (padrão): a IA só cota. Nenhuma compra acontece.
- Um valor, como 100: a IA pode comprar e renovar até R$ 100 nessa sessão. Mesmo assim, ela cota antes, mostra o total e só cobra quando você confirma.
Toda compra vai com uma chave de repetição, então uma compra repetida por engano devolve o mesmo pedido e não cobra de novo.
4. Pedir em português
Exemplos que funcionam:
- "Quais proxies eu tenho e quando vencem?"
- "Testa o proxy 123. Se não conectar, pede a troca de IP."
- "Me dá a configuração do primeiro proxy para Playwright em Python."
- "Exporta os meus proxies no formato do AdsPower."
- "Quanto custam 5 IPs ISP por 3 meses?"
- "Liga a renovação automática de todos os proxies que vencem esta semana."
O que o MCP faz
| Ferramenta | O que faz | Chave |
|---|---|---|
| catalogo, cotar | Planos à venda e preço exato, com descontos | leitura |
| listar_proxies, ver_proxy | Seus IPs; o detalhe traz usuário e senha | leitura |
| saldo, listar_pedidos, ver_pedido | Carteira e pedidos | leitura |
| situacao_troca, listar_numeros_sms | Andamento da troca de IP e números SMS | leitura |
| exportar_proxy | Linha pronta para AdsPower, GPM, Hidemium, GemLogin, MoreLogin, Dolphin, GoLogin, BitBrowser, URL HTTP ou SOCKS5 | leitura |
| configurar_navegador | Código pronto para Playwright, Puppeteer, Selenium, Browser Use, requests, curl ou variáveis de ambiente | leitura |
| testar_proxy, pedir_troca_ip | Teste na hora e troca por falha técnica | escrita |
| renovacao_automatica, cancelar_renovacao | Liga, desliga e cancela a renovação | escrita |
| renovar_proxy, comprar | Renovação e compra com o saldo, dentro do limite | escrita |
| gerar_pix | Pix copia e cola para colocar saldo | escrita |
As regras são as mesmas do painel: a troca de IP é para falha técnica, cancelar desliga a renovação sem devolução, e os limites de chamadas por minuto são os da API.
Problemas comuns
- "Chave inválida ou revogada": a chave foi apagada ou copiada pela metade. Gere outra em Chaves de API.
- A ProxyBox não aparece no programa: confira se o Node.js está instalado (
node -v), se o arquivo é um JSON válido e reinicie o programa. - "Esta chave é só de leitura": para testar, trocar ou comprar, gere uma chave de leitura e escrita.
- "O limite de gasto está em zero": é o padrão de segurança. Troque
PROXYBOX_LIMITE_GASTOse quiser deixar a IA comprar.
Para o assistente também navegar pelos sites com o seu IP dedicado, veja Playwright MCP com proxy.
Para integrar a compra ao seu próprio sistema, sem assistente de IA, veja como comprar e renovar IP pela API. Para escolher o tipo de IP para agentes de IA e coleta, veja o proxy para agentes de IA.