1001Proxy - Proxy MCP Server for AI Agents

Use Claude, OpenAI Cursor e qualquer agente de IA compatível com MCP para comprar e gerenciar proxies usando linguagem natural. Sem necessidade de integrações personalizadas - basta conectar seu cliente ao servidor e começar a conversar.

Ver em 1001proxy.ioExperimente este MCPPatrocinado

Documentação

MCP Server para Agentes de IA

Deixe Claude, GPT, Cursor e qualquer agente de IA compatível com MCP comprar e gerenciar proxies por meio de linguagem natural. Sem integrações personalizadas — basta apontar seu cliente para o servidor e começar a conversar.

Ver Instalação

Funciona com:Claude DesktopClaude CodeCursorWindsurfQualquer cliente MCP

Visão Geral

O que é MCP e por que ele importa para automação de proxies.

O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA se comuniquem com serviços externos por meio de uma interface estruturada de chamadas de ferramentas. Em vez de construir integrações frágeis baseadas em prompts, o MCP dá ao seu agente de IA ferramentas tipadas e documentadas que ele pode chamar com confiança.

O 1001Proxy MCP Server conecta seu cliente de IA diretamente à infraestrutura de proxies da 1001Proxy. O agente pode verificar seu saldo, navegar pelos tipos de proxy e países disponíveis, calcular o preço de um pedido, fazer o pedido e recuperar credenciais — tudo por meio de conversa em linguagem natural, sem código personalizado da sua parte.

Zero código de integração

Adicione um bloco JSON à configuração do seu cliente de IA e você está pronto.

Seguro por padrão

Ferramentas destrutivas como create_order exigem confirmação explícita do usuário no loop do agente.

Ciclo de vida completo de proxies

12 ferramentas cobrindo compra, gerenciamento, credenciais e faturamento.

Início Rápido

Comece a usar em três etapas.

Obtenha sua chave de API

Faça login no seu painel da 1001Proxy, navegue até Configurações → Chaves de API e crie uma nova chave. Copie-a — você precisará dela na próxima etapa.

Instale o servidor MCP

Instale globalmente com npm, ou pule a instalação completamente e use npx (o servidor será baixado automaticamente).

npm install -g @1001proxy-mcp/server

Adicione a configuração ao seu cliente de IA

Abra o arquivo de configuração do Claude Desktop (claude_desktop_config.json) e adicione o bloco do servidor abaixo. Substitua your_api_key_here pela sua chave real.

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop. As ferramentas da 1001Proxy aparecerão automaticamente na lista de ferramentas.

Instalação

Múltiplas opções de instalação e referência de variáveis de ambiente.

Instalação global (npm)

npm install -g @1001proxy-mcp/server

Sem instalação (npx)

Use npx -y para executar a versão mais recente sem instalar nada globalmente. Esta é a abordagem recomendada para a maioria das configurações de clientes MCP.

npx -y @1001proxy-mcp/server

Variáveis de ambiente

Variável	Obrigatória	Padrão	Descrição
PROXY_API_KEY	obrigatória	—	Sua chave de API da 1001Proxy.
PROXY_API_URL	opcional	https://api.1001proxy.io/api/v1	Substitui a URL base da API. Útil para ambientes auto-hospedados ou de staging.

Configuração

Exemplos de configuração para cada cliente MCP compatível.

Claude Desktop

Localização do arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows).

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

Adicione o servidor pelo seu terminal com o comando claude mcp add.

claude mcp add 1001proxy \
  --command "npx -y @1001proxy-mcp/server" \
  --env PROXY_API_KEY=your_api_key_here

Cursor

Abra as Configurações do Cursor, vá para Recursos → Servidores MCP e adicione o seguinte JSON:

{
  "mcpServers": {
    "1001proxy": {
      "command": "npx",
      "args": ["-y", "@1001proxy-mcp/server"],
      "env": {
        "PROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cliente MCP genérico

Qualquer cliente que siga a especificação MCP pode se conectar via stdio. Inicie o processo do servidor e direcione stdin/stdout:

PROXY_API_KEY=your_api_key_here npx -y @1001proxy-mcp/server

Ferramentas Disponíveis

12 ferramentas cobrindo o ciclo de vida completo de proxies — da descoberta à recuperação de credenciais.

get_account

Conta

Recupera informações da conta e saldo atual.

Parâmetros: Nenhum

list_proxy_types

Referência

Lista todos os tipos de proxy disponíveis com preços atuais.

Parâmetros: Nenhum

get_reference_data

Referência

Busca países, períodos de aluguel e tarifas para um determinado tipo de proxy.

Parâmetros: type: ipv4 | ipv6 | mobile | isp | resident

calculate_order

Pedidos

Pré-visualiza o custo total de um pedido antes de confirmar. Nenhum saldo é debitado.

Parâmetros: type, countryId, periodId, quantity, protocol, tarifId

create_order

Pedidos

Faz um novo pedido de proxy. Debita seu saldo imediatamente.

Parâmetros: type, countryId, periodId, quantity, protocol, tarifId, idempotency_key

list_orders

Pedidos

Lista pedidos existentes com filtros opcionais.

Parâmetros: page, per_page, status, type

get_order

Pedidos

Recupera detalhes completos de um pedido específico.

Parâmetros: order_id

get_proxies

Proxies

Obtém o host, a porta e as credenciais do proxy para um pedido.

Parâmetros: order_id

download_proxies

Proxies

Baixa a lista de proxies como arquivo de texto simples ou CSV.

Parâmetros: order_id, format: txt | csv

extend_order

Pedidos

Estende a duração de um pedido ativo. Cobra do seu saldo.

Parâmetros: order_id, periodId

get_transactions

Conta

Recupera o histórico de transações do seu saldo (depósitos, cobranças, reembolsos).

Parâmetros: page, per_page

get_deposit_addresses

Conta

Lista os endereços das suas carteiras de depósito em criptomoedas.

Parâmetros: Nenhum

Exemplos de Fluxos de Trabalho

Como um agente de IA lida com tarefas reais de proxy de ponta a ponta.

Fluxo 1 — "Compre 10 proxies de datacenter nos EUA"

Usuário

Compre 10 proxies de datacenter nos Estados Unidos por 30 dias.

Chamando get_reference_data para encontrar o ID do país EUA e o ID do período de 30 dias para proxies IPv4.

get_reference_data({ type: "ipv4" })
→ countryId: 1 (United States), periodId: 3 (30 days)

Calculando o preço do pedido antes de confirmar.

calculate_order({
  type: "ipv4",
  countryId: 1,
  periodId: 3,
  quantity: 10,
  protocol: "http"
})
→ total: $3.00

Agente

10 proxies de datacenter nos EUA (HTTP) por 30 dias custarão $3,00. Seu saldo atual é $45,20. Devo prosseguir?

Usuário

Sim, pode prosseguir.

Fazendo o pedido.

create_order({
  type: "ipv4",
  countryId: 1,
  periodId: 3,
  quantity: 10,
  protocol: "http",
  idempotency_key: "ord_20260406_001"
})
→ order_id: "ord_abc123", status: "active"

Pedido feito. Buscando suas credenciais de proxy agora.

get_proxies({ order_id: "ord_abc123" })
→ 10 proxies returned

Agente

Pronto! Aqui estão seus 10 proxies dos EUA (HTTP, 30 dias, expira em 2026-05-06): user_abc:pass_xyz@us1.1001proxy.io:10001 user_abc:pass_xyz@us1.1001proxy.io:10002... (mais 8)

Fluxo 2 — "Verifique meu saldo e liste pedidos ativos"

Usuário

Qual é o meu saldo e tenho algum pedido de proxy ativo?

Buscando informações da conta e pedidos ativos em paralelo.

get_account()          → balance: $42.20
list_orders({ status: "active", per_page: 10 })
  → 3 active orders returned

Agente

Seu saldo é $42,20. Você tem 3 pedidos ativos: • ord_abc123 — 10x IPv4 EUA (expira em 2026-05-06) • ord_def456 — 5x IPv6 DE (expira em 2026-04-20) • ord_ghi789 — 2x Mobile Reino Unido (expira em 2026-04-15)

Fluxo 3 — "Baixe a lista de proxies do pedido ord_abc123"

Usuário

Baixe minha lista de proxies do pedido ord_abc123 como arquivo de texto.

Chamando download_proxies com formato txt.

download_proxies({ order_id: "ord_abc123", format: "txt" })
→ plain-text proxy list returned

Agente

Aqui está sua lista de proxies em texto simples (formato host:porta:usuário:senha): us1.1001proxy.io:10001:user_abc:pass_xyz us1.1001proxy.io:10002:user_abc:pass_xyz... (mais 8) Você pode colar isso diretamente na configuração do seu scraper ou bot.

Solução de Problemas

Soluções para os problemas mais comuns.

Chave de API não definida — ferramentas retornam erro de autenticação

Certifique-se de que a variável de ambiente PROXY_API_KEY esteja definida na configuração do seu cliente MCP. No Claude Desktop, verifique se o bloco "env" em claude_desktop_config.json contém sua chave e reinicie o aplicativo. O servidor recusará todas as solicitações se a variável estiver ausente ou em branco.

# Verify the variable is set before running
echo $PROXY_API_KEY

# Or pass it inline for a quick test
PROXY_API_KEY=sk_live_... npx -y @1001proxy-mcp/server

Conexão recusada / servidor não encontrado

Confirme se o Node.js 18+ está instalado e disponível no seu PATH. O comando npx deve conseguir acessar o registro npm para baixar o pacote na primeira execução. Verifique sua rede ou configurações de proxy corporativo se estiver atrás de um firewall.

# Check Node.js version (18+ required)
node --version

# Confirm npx works
npx --version

A API da 1001Proxy impõe limites de taxa por minuto. Se seu agente estiver chamando ferramentas em um loop apertado, adicione uma pequena pausa entre as chamadas ou reduza a frequência. O servidor MCP exibirá o status 429 no resultado da ferramenta para que o agente possa recuar automaticamente.

# The server returns structured error results:
{
  "error": "rate_limited",
  "message": "Too many requests. Retry after 10s.",
  "retryAfter": 10
}

Saldo insuficiente (402 em create_order)

O saldo da sua conta é muito baixo para o pedido solicitado. Use get_account para verificar seu saldo atual, depois deposite fundos via get_deposit_addresses e envie criptomoedas para o endereço da carteira retornado.

Pronto para conectar seu agente de IA?

Crie sua conta, adicione fundos ao saldo e tenha um agente de IA comprando proxies em menos de cinco minutos.