Proxidize MCP

---

Visão Geral

Servidor MCP para a API do Proxidize. Dá ao Claude, Cursor e outros clientes MCP acesso direto à sua infraestrutura de proxies — sem necessidade de alternar entre abas do painel.

Na inicialização, ele verifica quais assinaturas Proxidize estão ativas na sua conta e registra apenas as ferramentas relevantes. O plano Per Proxy recebe ferramentas de gerenciamento de proxies, o Per GB recebe ferramentas de uso e pontos de acesso, e assim por diante.

---

Início Rápido

Requer Node.js 18 ou superior.

Claude Code

Escolha um escopo e execute o comando correspondente.

Local (padrão) — apenas neste projeto, privado para você:

claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp

Usuário — todos os seus projetos, privado para você:

claude mcp add proxidize --scope user -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp

Projeto — compartilhado com sua equipe via .mcp.json. Defina PROXIDIZE_API_TOKEN no seu ambiente e faça referência a ele com a expansão ${VAR} para que o token fique fora do controle de versão:

claude mcp add --scope project proxidize -- npx -y @proxidize/mcp

Execute /mcp dentro do Claude Code para verificar a conexão.

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf / VS Code

Adicione ao .mcp.json ou à configuração MCP do seu IDE:

{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Obtenha seu token de API

1. Faça login no Painel Proxidize
2. Clique no menu do avatar → Configurações
3. Copie seu token de API

Nota: O acesso a proxies exige verificação de identidade. KYC (documento de identidade com foto emitido pelo governo) é obrigatório para todas as contas antes que os Serviços de proxy possam ser usados; contas empresariais que precisam de threads de conexão ilimitadas ou acesso a categorias de sites com verificação também precisam de KYB (verificação empresarial, via vendas).

---

Ferramentas Disponíveis

Conta

Ferramenta	Descrição
get_subscription	Lista assinaturas ativas, opcionalmente filtradas por um tipo de plano
get_outbound_ip	Obtém o IP público da máquina que executa este servidor MCP (para lista de permissões de IP)

Per Proxy

Ferramenta	Descrição
list_proxies	Lista todos os proxies com IPs, URLs de conexão prontas para uso, velocidades, uso e tags
get_proxy	Obtém detalhes de um único proxy pelo ID da sessão
rotate_proxy	Rotaciona o IP de um proxy e retorna o IP antigo e o novo, opcionalmente fixado a uma cidade ou operadora
rotate_proxy_url	Rotaciona um proxy usando seu token de rotação
set_rotation_interval	Define rotação automática (60s a 7 dias) ou desativa com -1
update_proxy_password	Altera a senha de todos os proxies
list_proxy_locations	Lista cidades dos EUA disponíveis com velocidades médias
list_proxy_carriers	Lista operadoras móveis disponíveis, filtráveis por localização
create_ip_whitelist	Adiciona IPs de origem à lista de permissões para acesso ao proxy
list_tags	Lista todas as tags de proxies
create_tag	Cria uma nova tag
delete_tag	Exclui uma tag (remove de todos os proxies)
tag_proxy	Atribui uma tag a uma sessão de proxy
untag_proxy	Remove uma tag de uma sessão de proxy

Proxies Móveis Per GB

Prefixo com mobile_. Registradas apenas se você tiver uma assinatura móvel Per GB ativa.

Ferramenta	Descrição
mobile_get_usage	Saldo de dados — bytes usados e disponíveis
mobile_list_locations	Cidades disponíveis com velocidades, filtráveis por operadora, país ou estado
mobile_list_carriers	Operadoras disponíveis, filtráveis por país
mobile_get_settings	Configurações do proxy do ponto de acesso
mobile_list_access_points	Lista sub-usuários que compartilham seu pool de dados
mobile_create_access_point	Cria um novo sub-usuário
mobile_create_ip_whitelist	Adiciona IPs à lista de permissões com opções de localização/operadora/protocolo
mobile_update_ip_whitelist	Atualiza uma entrada existente da lista de permissões
mobile_update_settings	Atualiza o roteamento do ponto de acesso (cidade, operadora, protocolo)

Analytics

Registradas quando pelo menos um plano está ativo. Com suporte do serviço de analytics do Proxidize; a superfície de consulta pode evoluir.

Ferramenta	Descrição
get_traffic_analytics	Largura de banda e contagens de requisições/falhas ao longo do tempo, por sessão de proxy ou ponto de acesso
get_top_domains	Principais domínios de destino classificados por volume de dados e por contagem de requisições
get_connection_history	Log por requisição: URL, método, status, duração, bytes, IP de origem, geo upstream, erros

Proxies Residenciais Per GB

Mesmos que os móveis, com prefixo residential_. Registradas apenas com uma assinatura residencial ativa.

Ferramenta	Descrição
residential_get_usage	Saldo de dados residenciais
residential_list_locations	Localizações residenciais disponíveis, filtráveis por operadora, país ou estado
residential_list_carriers	Operadoras residenciais disponíveis, filtráveis por país
residential_get_settings	Configurações do ponto de acesso
residential_list_access_points	Lista sub-usuários residenciais
residential_create_access_point	Cria um sub-usuário residencial
residential_create_ip_whitelist	Adiciona IPs à lista de permissões para proxies residenciais
residential_update_ip_whitelist	Atualiza uma entrada residencial da lista de permissões
residential_update_settings	Atualiza o roteamento do ponto de acesso (cidade, operadora, protocolo)

---

Configuração

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
PROXIDIZE_API_TOKEN	Sim	—	Seu token de API do Proxidize
PROXIDIZE_BASE_URL	Não	https://api.proxidize.com/api/v1	URL base da API. Deve ser uma URL HTTPS *.proxidize.com, ou um endereço de loopback (localhost/127.0.0.1) para testes locais — qualquer outra coisa é rejeitada na inicialização para que seu token de API nunca seja enviado a outro host
PROXIDIZE_PROXY_HOST	Não	pg.proxi.es	Host do gateway de proxy usado nas URLs de conexão
PROXIDIZE_TIMEOUT	Não	30000	Tempo limite de requisição em milissegundos
PROXIDIZE_MAX_RETRIES	Não	2	Máximo de tentativas em erros de servidor (0-5)
PROXIDIZE_DISABLE_ANALYTICS	Não	—	Defina como 1 para desativar analytics de uso anônimos (DO_NOT_TRACK=1 também funciona)

Descoberta de ferramentas

Na inicialização, o servidor consulta a API de assinaturas para descobrir seus planos ativos. As ferramentas são registradas por plano:

• per_proxy_mobile → 14 ferramentas de gerenciamento de proxies
• per_gb_mobile → 9 ferramentas móveis
• per_gb_residential → 9 ferramentas residenciais
• Qualquer plano ativo → 3 ferramentas de analytics
• Sempre carregadas → get_subscription, get_outbound_ip

Sem assinatura, sem ferramentas específicas de assinatura. Nada é exposto que sua conta não possa usar.

Analytics de uso

O servidor coleta analytics de uso anônimos (quais ferramentas são chamadas, latência e taxas de erro) via PostHog para nos ajudar a melhorá-lo. Respostas de ferramentas e argumentos de chamadas de ferramentas nunca são enviados — apenas o nome da ferramenta, tempo e sucesso/falha. Desative a qualquer momento definindo PROXIDIZE_DISABLE_ANALYTICS=1 (ou o padrão DO_NOT_TRACK=1) no ambiente do servidor.

---

Clientes Suportados

Funciona com qualquer cliente compatível com MCP:

• Claude Code (CLI, Desktop, Web)
• Claude Desktop
• Cursor
• Windsurf
• VS Code (com extensão MCP)

---

Solução de Problemas

"PROXIDIZE_API_TOKEN é obrigatório"

Defina a variável de ambiente na configuração do seu servidor MCP. Veja Início Rápido.

O servidor conecta, mas mostra apenas get_subscription e get_outbound_ip

A descoberta de assinaturas falhou ou não encontrou planos ativos. Verifique se seu token de API é válido (regere-o no painel do Proxidize em Configurações) e se sua conta tem uma assinatura ativa.

Ferramentas retornam "HTTP 401: Invalid token"

Verifique se o token não foi regenerado desde que você configurou o servidor.

Erros de tempo limite

Aumente o tempo limite: defina PROXIDIZE_TIMEOUT para 60000 na sua configuração de ambiente.

---

Desenvolvimento

Para executar a partir do código-fonte em vez do npm:

git clone https://github.com/proxidize/proxidize-mcp.git
cd proxidize-mcp
npm install
npm run build

Em seguida, aponte seu cliente MCP para a saída do build — por exemplo, claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- node /path/to/proxidize-mcp/dist/index.js.

Execute a suíte de testes com npm test (nenhuma credencial necessária — ele inicia o servidor contra uma API simulada).

---

Licença

MIT