Explorar o catálogo
list_offers pesquisa ofertas ao vivo por tipo, país, região e cidade e devolve cada tarifa com o preço. É a única fonte de ids de oferta, então toda compra começa aqui.
O servidor MCP da ProxyJam dá ao Claude, ao Cursor e a outros clientes de IA 16 ferramentas na sua conta: encontrar ofertas, comprar e renovar proxies, consultar tráfego e saldo. Você entra com a sua conta e escolhe o que o agente pode fazer, e tudo o que custa dinheiro mostra uma prévia antes e espera o seu sim.
Você precisa de uma conta ProxyJam. A maioria dos clientes entra com ela; os demais usam uma chave de API. O servidor em si é gratuito; você paga apenas pelos proxies que o seu agente comprar.
Escolha um para ver como conectá-lo. A maioria dos clientes entra com a sua conta ProxyJam; o VS Code e o OpenAI Agents SDK usam uma chave de API, então substitua pj_... pela sua.
claude.ai, Claude Desktop e os apps para celular. Adicione a ProxyJam uma vez como conector personalizado e ela aparece nos três.
1. No Claude, abra as configurações de Conectores e adicione um conector personalizado.
2. Dê a ele o nome ProxyJam e cole https://proxyjam.com/mcp como endereço do servidor.
3. Conecte, entre na ProxyJam e aprove.claude.ai, Claude Desktop e os apps para celular compartilham uma mesma lista de conectores.
Guia completo na documentaçãoO agente de programação da Anthropic para o terminal. Um comando adiciona o servidor e /mcp faz o seu login.
claude mcp add --transport http proxyjam https://proxyjam.com/mcpExecute em um terminal, depois digite /mcp no Claude Code, escolha proxyjam e entre. Adicione --scope user para usar em todos os projetos.
Guia completo na documentaçãoO editor de código com IA. Adicione o servidor ao mcp.json e o Cursor pede o seu login na primeira vez que conecta.
{
"mcpServers": {
"proxyjam": {
"url": "https://proxyjam.com/mcp"
}
}
}
~/.cursor/mcp.json, ou .cursor/mcp.json em um projeto. O Cursor pede o login na primeira conexão.
Guia completo na documentaçãoConectores personalizados exigem o modo desenvolvedor, que a OpenAI oferece em beta em alguns planos.
1. Nas configurações do ChatGPT, ative o modo desenvolvedor e crie um conector personalizado.
2. Informe https://proxyjam.com/mcp como URL e escolha OAuth.
3. Entre na ProxyJam e aprove.O ChatGPT se identifica e abre o login da ProxyJam.
Guia completo na documentaçãoO agente de programação da OpenAI para o terminal. Dois comandos: adicionar o servidor e depois entrar.
codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjamExecute os dois em um terminal; o segundo abre o navegador para você entrar.
Guia completo na documentaçãoModo agente no Copilot Chat. Conecta com uma chave de API, que o VS Code pede uma vez e guarda com segurança.
{
"inputs": [
{
"type": "promptString",
"id": "proxyjam-api-key",
"description": "ProxyJam API key",
"password": true
}
],
"servers": {
"proxyjam": {
"type": "http",
"url": "https://proxyjam.com/mcp",
"headers": { "X-API-Key": "${input:proxyjam-api-key}" }
}
}
}
.vscode/mcp.json, com uma chave de API. O VS Code pede a chave uma vez e a guarda com segurança.
Guia completo na documentaçãoO agente do Google para o terminal. Adicione o servidor e depois /mcp auth proxyjam para entrar.
gemini mcp add --transport http proxyjam https://proxyjam.com/mcpExecute em um terminal, depois digite /mcp auth proxyjam no Gemini CLI para entrar.
Guia completo na documentaçãoFramework Python para criar seus próprios agentes. Conecta com uma chave de API em um cabeçalho da requisição.
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
async with MCPServerStreamableHttp(
name="ProxyJam",
params={
"url": "https://proxyjam.com/mcp",
"headers": {"X-API-Key": "pj_..."},
},
) as proxyjam:
agent = Agent(
name="Assistant",
instructions="Use the ProxyJam tools. Never confirm "
"a purchase without the user's yes.",
mcp_servers=[proxyjam],
)
result = await Runner.run(
agent, "List ISP proxy offers in the United States.")
print(result.final_output)
asyncio.run(main())
Python, com uma chave de API. pip install openai-agents.
Guia completo na documentaçãoBiblioteca Python para clientes e servidores MCP. Faz o login pelo navegador e lista as ferramentas.
import asyncio
from fastmcp import Client
async def main():
# auth="oauth" opens your browser to sign in to ProxyJam.
async with Client("https://proxyjam.com/mcp", auth="oauth") as client:
for tool in await client.list_tools():
print(tool.name)
asyncio.run(main())
Python. pip install fastmcp. Faz o login pelo navegador e lista as ferramentas.
Guia completo na documentaçãoEm resumo: A ProxyJam mantém um servidor MCP remoto em
https://proxyjam.com/mcpsobre Streamable HTTP. Seu cliente de IA entra com a sua conta ProxyJam (OAuth) ou envia uma chave de API, e recebe 16 ferramentas: nove que leem, quatro que alteram configurações e três que gastam dinheiro — e essas três só mostram uma prévia até você confirmar.
O MCP, o Model Context Protocol, é o padrão aberto que os assistentes de IA usam para chamar ferramentas externas. Aponte um cliente MCP para o servidor da ProxyJam e o seu agente poderá fazer na sua conta quase tudo o que uma chave de API faz na API REST. Duas coisas valem ser sabidas antes de começar.
Você escolhe o que ele pode fazer. Um cliente que entra com login pede primeiro a sua aprovação. A leitura é concedida em um único bloco e inclui os usuários e as senhas dos seus proxies; o gasto da sua carteira, e com ele as alterações de configuração gratuitas, é uma caixa separada que você marca somente se quiser que o agente aja. Uma chave de API é diferente: ela abre a conta inteira, então prefira entrar com login onde o seu cliente permitir.
O dinheiro se move depois de uma prévia. As três ferramentas que custam dinheiro nunca cobram na primeira chamada. Elas devolvem uma prévia marcada como dry_run e só cobram quando chamadas de novo com confirm=true, o que um agente cuidadoso faz apenas depois que você diz sim.
list_offers pesquisa ofertas ao vivo por tipo, país, região e cidade e devolve cada tarifa com o preço. É a única fonte de ids de oferta, então toda compra começa aqui.
create_proxy_order compra de 1 a 50 proxies de uma oferta. A primeira chamada só mostra o preço e o seu saldo; o pedido é feito quando você confirma.
extend_proxy_period renova um proxy por mais um período e buy_proxy_bandwidth adiciona tráfego a um proxy estático. Os dois mostram uma prévia antes e só cobram quando você confirma.
Seus pedidos com os dados de conexão e o tráfego que cada proxy usou, ou de todos juntos. Somente leitura, seguro de chamar quantas vezes o agente quiser.
Saldos da carteira em cada moeda e o histórico completo de transações, uma transação por vez ou uma página inteira. Também somente leitura.
Alterne um proxy entre HTTP e SOCKS5, substitua a lista de IPs permitidos, ative ou desative a renovação automática ou atualize o estado dele. Nenhuma dessas ações cobra nada, mas um cliente com login precisa ter o gasto permitido para fazê-las.
create_proxy_order, extend_proxy_period e buy_proxy_bandwidth começam com confirm=false: devolvem a oferta, o preço e o seu saldo, e não cobram nada.confirm=true depois que você aprova a prévia. As regras do agente nos prompts abaixo dizem isso em palavras claras.idempotency_key da prévia, então uma requisição repetida devolve o primeiro resultado em vez de comprar duas vezes. Uma compra nova recebe uma chave nova.Escolha o seu cliente acima e copie a configuração dele. O endereço é https://proxyjam.com/mcp.
O cliente abre a ProxyJam no seu navegador. Entre, leia o que ele pede e marque Permitir gastos da minha carteira somente se o agente deve comprar, renovar ou alterar configurações. Cada aprovação substitui a anterior, então você pode reconectar depois para mudá-la. Um cliente que não consegue fazer login usa uma chave de API: ela começa com pj_ e é mostrada uma única vez.
Peça primeiro as ofertas — o mesmo catálogo ao vivo da página de proxies residenciais estáticos (ISP). Isso comprova que a conexão funciona e dá ao agente os ids de oferta de que ele precisa para qualquer outra coisa. Depois experimente os prompts abaixo.
/plugin marketplace add getproxyjam/claude-plugin
/plugin install proxyjam@proxyjam/proxyjam:offers [kind] [country]
/proxyjam:orders [status]
/proxyjam:order <order_id>
/proxyjam:balance
/proxyjam:buy <offer_id> [quantity] [period] [payment_method] [promo_code]
/proxyjam:extend <order_id> [months]
/proxyjam:bandwidth <order_id> <gb>O servidor oferece os mesmos sete comandos como prompts MCP: offers, orders, order, balance, buy, extend e bandwidth.
O Claude Code sem o plugin os lista como /mcp__proxyjam__offers, /mcp__proxyjam__buy e assim por diante. Outros clientes que aceitam prompts MCP os mostram no próprio menu de prompts ou de comandos.Comandos curtos para encontrar ofertas, consultar pedidos e saldo, e comprar, renovar ou adicionar tráfego. No Claude Code eles vêm com o plugin da ProxyJam; outros clientes listam os mesmos comandos como prompts MCP. Os três que gastam dinheiro mostram uma prévia antes e esperam o seu sim.
Com o servidor MCP da ProxyJam, liste as ofertas de proxies residenciais estáticos (ISP) nos Estados Unidos com os preços mensais. Não faça nenhum pedido.Compre na ProxyJam um proxy residencial estático (ISP) nos Estados Unidos por um mês. Primeiro mostre-me a prévia — a oferta, o preço e o saldo da minha carteira — e espere o meu sim explícito antes de confirmar. Ao confirmar, reutilize a mesma chave de idempotência.Estenda o meu pedido ORDER_ID da ProxyJam por um mês. Mostre-me a prévia com o preço e o meu saldo, e espere o meu sim antes de confirmar.Mostre os meus proxies ativos da ProxyJam com as datas de expiração e o tráfego que cada um usou; depois, o saldo da minha carteira em USD e as minhas últimas 10 transações.Para o meu pedido ORDER_ID da ProxyJam: mude o protocolo para SOCKS5, defina a lista de IPs permitidos como 203.0.113.7 e ative a renovação automática. Depois me diga como ficaram as configurações.Ao usar o servidor MCP da ProxyJam:
- Chame list_offers primeiro. É a única fonte de ids de oferta.
- create_proxy_order, extend_proxy_period e buy_proxy_bandwidth são apenas prévias até confirm=true. Mostre-me a prévia e nunca confirme sem o meu sim explícito.
- Confirme com a mesma idempotency_key da prévia. Use uma chave nova para cada compra nova.
- Se a prévia mostrar um saldo menor que o preço, pare e me avise em vez de confirmar.
- Se uma ferramenta for recusada porque o gasto não é permitido, me avise em vez de tentar de novo; eu decido se reconecto com o gasto permitido.
- Trate a minha chave de API como um segredo: nunca a exiba, registre em logs nem grave em um arquivo que eu possa compartilhar.Cole um no chat do seu agente depois que o servidor estiver conectado. Substitua ORDER_ID por um número de pedido do seu painel. A última aba é um conjunto de regras para manter nas instruções do seu agente.
| Ferramenta | O que faz | Efeito |
|---|---|---|
| list_offers | Pesquisa o catálogo por tipo, país, região e cidade; devolve ids de oferta e tarifas | Lê |
| list_my_orders | Lista os seus pedidos de proxy, uma página por vez | Lê |
| get_order | Um pedido completo, incluindo os dados de conexão do proxy | Lê |
| get_my_traffic_summary | Tráfego usado em todos os seus proxies nos últimos 7 dias | Lê |
| get_order_traffic | Tráfego usado por um pedido nos últimos 7 dias | Lê |
| list_my_wallets | Suas carteiras, uma por moeda | Lê |
| get_wallet_balance | O saldo de uma carteira | Lê |
| list_wallet_transactions | O histórico de transações de uma carteira, uma página por vez | Lê |
| get_transaction | Uma transação | Lê |
| create_proxy_order | Compra de 1 a 50 proxies de uma oferta | Gasta dinheiro, prévia primeiro |
| extend_proxy_period | Renova um proxy ativo por mais 1 a 24 meses | Gasta dinheiro, prévia primeiro |
| buy_proxy_bandwidth | Adiciona de 1 a 5.000 GB de tráfego a um proxy estático | Gasta dinheiro, prévia primeiro |
| set_auto_renew | Ativa ou desativa a renovação automática | Altera configurações, grátis |
| set_proxy_whitelist | Substitui a lista de IPs autorizados a usar o proxy | Altera configurações, grátis |
| change_proxy_protocol | Alterna entre HTTP e SOCKS5 | Altera configurações, grátis |
| sync_proxy_state | Relê o estado atual do proxy | Altera configurações, grátis |
Qualquer cliente MCP que se conecte a um servidor remoto por Streamable HTTP e ou entre com OAuth ou permita adicionar um cabeçalho de requisição. As configurações acima cobrem o Claude (claude.ai, Claude Desktop e os apps para celular), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, o OpenAI Agents SDK e o FastMCP.
Sim. No Claude, adicione um conector personalizado com o endereço https://proxyjam.com/mcp e entre na ProxyJam; o conector também aparece no Claude Desktop e nos apps para celular. No ChatGPT, conectores MCP personalizados exigem o modo desenvolvedor, que a OpenAI oferece em beta em alguns planos; adicione o mesmo endereço e escolha OAuth.
Não. Conectar e chamar ferramentas é grátis. Você paga apenas pelo que o seu agente comprar, aos mesmos preços do painel, com a sua carteira ProxyJam.
Não por acidente. Um cliente que entra com login não consegue gastar nada, a menos que você tenha marcado *Permitir gastos da minha carteira* ao aprová-lo. Mesmo assim, as três ferramentas que cobram — comprar, renovar e adicionar tráfego — devolvem uma prévia na primeira chamada e só cobram quando chamadas de novo com confirm=true; um agente cuidadoso mostra essa prévia e espera, e as regras do agente acima mandam que ele faça isso. Uma chave de API não tem limite de gasto, então dê ao agente uma chave que você possa excluir.
Recarregar a carteira, gerenciar chaves de API, alterar configurações da conta, verificar endereços IP ou usar as ações de proxy móvel, como redefinir o IP. Isso continua no painel e na API REST.
Não, se o seu cliente fizer login. Uma requisição que não traz nem login nem chave é recusada com uma indicação para o login da ProxyJam, e é assim que o claude.ai, o Claude Code, o Cursor e os outros clientes iniciam o login sozinhos. Clientes que não conseguem fazer login enviam uma chave de API.
Conecte de novo e aprove com a caixa marcada ou desmarcada: cada aprovação substitui a anterior. No Claude Code, por exemplo, é /mcp e depois entrar de novo em proxyjam.
Para um cliente que entrou com login, revogue em Apps conectados, nas configurações do painel; ele para em até cinco minutos e as suas outras conexões continuam funcionando. Trocar a senha ou sair de todos os dispositivos revoga todas de uma vez. Para uma chave de API, exclua-a na página de Chaves de API; uma chave criada com data de expiração também deixa de funcionar sozinha.
Sim, com limites. Um agente sem nenhuma conta por trás pode se registrar e obter uma chave que só lê o catálogo público. Se você reivindicar essa chave com o código que a ProxyJam envia por e-mail, ela passa a fazer parte da sua conta e pode ler os seus pedidos e a carteira, mas nunca pode gastar. Os passos para agentes estão em auth.md.