# Servidor MCP para agentes de IA | ProxyJam

Conecte o Claude, o Cursor e outros clientes MCP à sua conta ProxyJam: encontre ofertas, compre e renove proxies, acompanhe o tráfego. Compras esperam o seu sim.

- Canonical: https://proxyjam.com/pt/mcp/
- Updated: 2026-11-17
- Language: pt

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.


A ProxyJam mantém um servidor MCP remoto em `https://proxyjam.com/mcp` sobre 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.


## Dezesseis ferramentas, seis tarefas

### 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.

### Comprar proxies

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.

### Renovar e adicionar tráfego

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.

### Consultar pedidos e tráfego

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.

### Acompanhar o dinheiro

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.

### Alterar configurações

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.


## O dinheiro só se move quando você manda

1. **Ler é o padrão.** Quando um cliente entra, a ProxyJam mostra o que ele pede. A leitura dos seus pedidos, da carteira e do catálogo é concedida em conjunto — e os pedidos incluem os usuários e as senhas dos seus proxies. Gastar é uma caixa separada, *Permitir gastos da minha carteira*, que começa desmarcada e cobre também as alterações de configuração gratuitas.
2. **Prévia primeiro.** `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.
3. **Primeiro o seu sim, depois a cobrança.** O agente só chama de novo com `confirm=true` depois que você aprova a prévia. As regras do agente nos prompts abaixo dizem isso em palavras claras.
4. **Sem cobrança em dobro.** A chamada de confirmação reutiliza o `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.
5. **Uma chave de API abre a conta inteira.** As chaves do painel não têm permissões mais restritas, incluindo leitura e gasto. Entre com a sua conta onde o seu cliente permitir e dê a qualquer chave que usar uma data de expiração.
6. **O acesso termina quando você o revoga.** Um cliente com login aparece em *Apps conectados* nas [configurações do painel](https://app.proxyjam.com/settings); revogue-o ali e ele para em até cinco minutos. Trocar a senha ou sair de todos os dispositivos revoga todas as conexões. Uma chave deixa de funcionar assim que você a exclui na [página Chaves de API](https://app.proxyjam.com/apikey).

## Conecte em três passos

1. **Adicione o servidor ao seu cliente** Escolha o seu cliente acima e copie a configuração dele. O endereço é `https://proxyjam.com/mcp`.
2. **Entre e escolha o que ele pode fazer** 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](https://app.proxyjam.com/apikey): ela começa com `pj_` e é mostrada uma única vez.
3. **Comece com um prompt somente de leitura** Peça primeiro as ofertas — o mesmo catálogo ao vivo da página de [proxies residenciais estáticos (ISP)](/pt/isp-proxies/). 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.

## Escolha seu cliente

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 (Anthropic)

claude.ai, Claude Desktop e os apps para celular compartilham uma mesma lista de conectores.

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.

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop

### Claude Code (Anthropic)

Execute em um terminal, depois digite /mcp no Claude Code, escolha proxyjam e entre. Adicione --scope user para usar em todos os projetos.

```
claude mcp add --transport http proxyjam https://proxyjam.com/mcp
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#claude-code

### Cursor (Anysphere)

~/.cursor/mcp.json, ou .cursor/mcp.json em um projeto. O Cursor pede o login na primeira conexão.

```
{
  "mcpServers": {
    "proxyjam": {
      "url": "https://proxyjam.com/mcp"
    }
  }
}
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#cursor

### ChatGPT (OpenAI)

O ChatGPT se identifica e abre o login da ProxyJam.

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.

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#chatgpt

### Codex CLI (OpenAI)

Execute os dois em um terminal; o segundo abre o navegador para você entrar.

```
codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjam
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#codex-cli

### VS Code (Microsoft)

.vscode/mcp.json, com uma chave de API. O VS Code pede a chave uma vez e a 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}" }
    }
  }
}
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#vs-code

### Gemini CLI (Google)

Execute em um terminal, depois digite /mcp auth proxyjam no Gemini CLI para entrar.

```
gemini mcp add --transport http proxyjam https://proxyjam.com/mcp
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#gemini-cli

### OpenAI Agents SDK (OpenAI)

Python, com uma chave de API. pip install openai-agents.

```
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())
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#openai-agents-sdk

### FastMCP (Prefect)

Python. pip install fastmcp. 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())
```

Guia completo na documentação: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python


## Sete comandos para as tarefas do dia a dia

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.

### Plugin do Claude Code

Execute os dois no Claude Code, depois /mcp, escolha proxyjam e entre. O plugin também conecta o servidor, então pule a configuração acima.

```
/plugin marketplace add getproxyjam/claude-plugin
/plugin install proxyjam@proxyjam
```

### Comandos

offers, orders, um pedido, balance, buy, extend, bandwidth. Os argumentos são livres, e o que faltar é perguntado: um id nunca é adivinhado.

```
/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>
```

### Outros clientes

Os mesmos comandos como prompts MCP, para qualquer cliente que os liste.

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.


## Prompts para experimentar

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.

### Encontrar um proxy

Somente leitura. Uma primeira chamada segura.

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.

### Comprar com prévia

Só cobra depois do seu sim.

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.

### Renovar

Estenda um pedido, com prévia primeiro.

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.

### Uso e saldo

Pedidos, tráfego e dinheiro em uma só resposta.

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.

### Configurações

Alterações que não custam nada.

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.

### Regras do agente

Para CLAUDE.md, AGENTS.md ou as regras do Cursor.

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.


## As 16 ferramentas

| 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 |

As ferramentas que o servidor lista hoje. As três que gastam dinheiro devolvem uma prévia até serem chamadas de novo com confirm=true. Um cliente com login só pode chamar as sete últimas se você permitiu o gasto.


## Dados de conexão

- **Endpoint:** https://proxyjam.com/mcp
- **Transporte:** Streamable HTTP
- **Autenticação:** Login com a sua conta ProxyJam (OAuth 2.1), ou uma chave de API no cabeçalho X-API-Key
- **Acesso:** Leitura por padrão; gastos e alterações de configuração só quando você permite
- **Listas de referência:** Status de pedidos, moedas, protocolos de proxy, tipos de oferta e formas de pagamento, como recursos MCP
- **Preço:** Grátis. Você paga apenas pelos proxies que comprar

## Perguntas sobre o servidor MCP

### Quais clientes de IA podem se conectar?

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.

### Posso conectar ao claude.ai ou ao ChatGPT?

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.

### O servidor MCP custa alguma coisa?

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.

### Meu agente pode gastar dinheiro sem me perguntar?

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.

### O que o agente não consegue fazer por MCP?

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.

### Preciso de uma chave de API?

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.

### Como permito gastos depois, ou retiro a permissão?

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.

### Como revogo o acesso de um agente?

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.

### Um agente pode se cadastrar sozinho?

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.


## Comece pequeno

Conecte, peça as ofertas e leia o que voltar antes de deixar um agente comprar qualquer coisa. Na hora de comprar, a prévia mostra a oferta, o preço e o seu saldo, e nada é cobrado até você dizer sim.



## Fontes

- [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — o transporte Streamable HTTP que este servidor fala
- [Cartão do servidor MCP](/.well-known/mcp/server-card.json) — o endpoint, o transporte e a autenticação, para agentes que descobrem a ProxyJam por conta própria
- [auth.md](/auth.md) — como um agente entra, se registra ou usa uma chave de API
- [Metadados do servidor de autorização OAuth](/.well-known/oauth-authorization-server) — os endpoints e os escopos que um cliente descobre ao fazer login
- [Skill de agente da ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — o guia de uso que um agente pode carregar antes da primeira chamada




O MCP, o [Model Context Protocol](https://modelcontextprotocol.io/), é 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.

