NOVO! |Uma chamada de API, dados limpos de volta. Sem precisar de scrapers.Ganhe 10.000 tokens grátis →

Plataforma para desenvolvedores

API e MCP da FineProxy

Automatize operações de proxy pelo seu código ou conecte um agente de IA. Veja o que é compatível, onde se aplicam as proteções e como auditar uma integração existente antes de mudar de provedor.

API REST49 operações OpenAPI
Servidor MCP49 ferramentas de agente
AcessoChaves de API com escopo

Uma plataforma, duas formas de automatizar

A API e o MCP usam as mesmas chaves FineProxy com escopo e oferecem os mesmos fluxos de trabalho do cliente. Escolha de acordo com quem irá operá-los: seu aplicativo ou um agente de IA.

REST · OpenAPI 3.1

Integre a FineProxy ao seu aplicativo

Use endpoints HTTP documentados a partir de um backend, script, tarefa de CI, painel interno ou fluxo de trabalho no-code. A especificação atual do cliente está disponível no painel.

Ideal quando seu código precisa:
  • Executar fluxos de trabalho determinísticos sem um modelo de IA
  • Validar os formatos de solicitação e resposta com o OpenAPI
  • Controlar novas tentativas, filas, logs e implantação por conta própria
Abrir a documentação da API

JSON-RPC 2.0 · Streamable HTTP

Dê acesso controlado a um agente de IA

Conecte Cursor, Claude, VS Code, Cline, n8n ou outro cliente MCP ao servidor da FineProxy. O agente recebe as ferramentas permitidas pelos escopos da chave de API.

Ideal quando você quer que um agente:
  • Inspecione estoque, serviços, uso e histórico de suporte
  • Faça cotações e execute operações de serviço aprovadas
  • Diagnostique falhas e explique as alterações recomendadas
Abrir a configuração do MCP no painel

Audite uma integração existente antes de migrar

Baixe um arquivo Markdown, anexe-o a um agente de programação junto com seu repositório e execute o prompt de auditoria preparado. A primeira etapa é somente leitura: ela identifica compatibilidade, adaptadores, impedimentos e o código exato que precisaria ser alterado.

Prompt de auditoria de migração somente leitura
Leia o FineProxy Agent Pack anexado e inspecione este repositório.

Não modifique o código durante a primeira etapa.

Encontre todos os locais onde o provedor de proxy atual está configurado ou é chamado. Compare cada fluxo de trabalho com os recursos documentados da FineProxy. Informe:
1. Fluxos de trabalho totalmente compatíveis.
2. Fluxos de trabalho que precisam de um adaptador ou transformação de dados.
3. Comportamentos incompatíveis ou pouco claros.
4. Permissões necessárias da API da FineProxy.
5. Arquivos e caminhos de código exatos que seriam alterados.
6. Alterações de autenticação e armazenamento de segredos.
7. Um plano de migração em etapas com reversão.
8. Testes de integração necessários antes da transição.

Não invente endpoints. Marque como dúvida tudo o que não for confirmado pelo Agent Pack ou pela especificação OpenAPI atual.

A auditoria deve verificar

  1. 01Onde o provedor atual é inicializado e chamado
  2. 02Diferenças de autenticação e armazenamento de segredos
  3. 03Fluxos de compra, renovação, cancelamento e atualização de IP dos serviços
  4. 04Formatos de listas de proxies, protocolos, portas e modos de autorização
  5. 05Seleção de países, listas de permitidos e limites de conexão
  6. 06Paginação, novas tentativas, idempotência, erros e tratamento de limites
  7. 07Dependências de cobrança, análises de uso, suporte e webhooks
  8. 08Um plano de migração e testes arquivo por arquivo, sem editar o código

Para implementar no nível dos endpoints, forneça também ao agente o arquivo OpenAPI atual baixado do seu painel. O Agent Pack não contém intencionalmente credenciais nem dados privados da conta.

O que você pode automatizar

A camada pública explica fluxos de trabalho completos em vez de reproduzir cada endpoint. Use a especificação OpenAPI ativa ao implementar solicitações individuais.

01

Compra e provisionamento

Consulte o estoque atual, calcule uma combinação exata de países e faça um pedido usando a carteira do painel.

  • Listar países disponíveis e o estoque atual de IPs
  • Cotar um pacote com vários países sem comprometer fundos
  • Comprar com proteção de preço e chave de idempotência
02

Gerenciamento de serviços

Opere serviços ativos sem esperar por um chamado de suporte quando o plano for compatível com a ação solicitada.

  • Renovar, suspender, restaurar ou cancelar serviços
  • Substituir ou adicionar IPs e atualizar credenciais
  • Gerenciar renovação automática, listas de permitidos e complementos de conexão
03

Análises e diagnósticos

Use a telemetria da conta e dos serviços para investigar carga, confiabilidade e comportamento dos destinos.

  • Consultar visões gerais de uso e séries temporais
  • Inspecionar os principais destinos e categorias de erro
  • Receber diagnósticos e recomendações operacionais
04

Cobrança e suporte

Conecte as operações de proxy aos fluxos financeiros e de suporte relacionados.

  • Consultar faturas e baixar PDFs de faturas
  • Iniciar um depósito na carteira e verificar seu status
  • Criar, consultar, responder e encerrar chamados de suporte
05

Acesso ao proxy

Obtenha as configurações necessárias para que os aplicativos se conectem pelos proxies adquiridos.

  • Consultar a configuração de conexão de proxies rotativos
  • Alterar o login e a senha do serviço
  • Gerenciar limites de conexão por IP na lista de permitidos
06

Eventos e conta

Mantenha sistemas externos sincronizados e inspecione informações da conta relevantes para a segurança.

  • Configurar webhooks e o processamento de entregas
  • Consultar dados do perfil, IP do solicitante e histórico de login
  • Gerenciar chaves de API com permissões selecionadas de forma restrita

O que a plataforma não fará

A automação da FineProxy é intencionalmente limitada. O acesso é determinado pela chave, pelo plano de serviço, pelo estoque atual e por verificações de segurança explícitas.

Sem acesso fora dos escopos concedidos

Uma ferramenta ou endpoint não pode consultar nem alterar um recurso sem que a chave de API inclua a permissão necessária.

Sem gastos sem wallet:spend

Compras, renovações e atualizações pagas de IP permanecem indisponíveis quando o escopo financeiro não está presente.

Sem ações destrutivas silenciosas

Operações irreversíveis exigem um sinalizador de confirmação explícito. Elas não podem ocorrer como efeito colateral de uma solicitação de leitura.

Sem acesso ao código-fonte pelo MCP

O MCP da FineProxy opera a conta do cliente. Para auditar um script, seu agente de programação também precisa receber acesso a esse script ou repositório.

Sem garantia de estoque indisponível

A disponibilidade e as quantidades por país são verificadas no estoque atual. A automação não pode pedir um estoque que não esteja disponível.

Sem API de parceiros para parceiros inativos

A especificação para parceiros e os endpoints de relatórios são exibidos somente quando a conta tem status de parceiro ativo.

Conecte um agente em minutos

Crie uma chave de API dedicada no painel, selecione apenas os escopos necessários para o agente e insira a configuração do MCP no seu cliente. Mantenha a chave real em um segredo ou variável de ambiente.

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

Use a especificação ativa para a implementação

O painel apresenta a especificação OpenAPI 3.1 selecionada para o cliente, exemplos de solicitações, esquemas de respostas e snippets de cliente gerados. Parceiros ativos também recebem uma especificação separada para parceiros.

Ver a referência interativa da API

Escolha o menor conjunto útil de permissões

Os acessos de leitura e gravação são separados. Comece com escopos somente leitura para descoberta e auditorias de migração e só depois adicione acesso de gravação ou financeiro ao fluxo de trabalho que precisar dele.

customer:read

Consultar o perfil e as informações da conta do cliente.

customer:write

Atualizar as informações do cliente.

wallet:read

Consultar o saldo e os dados da carteira.

wallet:deposit

Criar e monitorar depósitos na carteira.

wallet:spend

Permitir que a automação gaste fundos da carteira.

services:read

Consultar serviços, configurações de proxy e estado dos serviços.

services:write

Criar ou modificar serviços e complementos.

tickets:read

Consultar chamados de suporte e suas mensagens.

tickets:write

Criar, responder, atualizar ou encerrar chamados.

catalog:read

Consultar produtos, opções, países e estoque atual.

usage:read

Consultar o uso dos serviços e análises de diagnóstico.

webhooks

Criar e gerenciar assinaturas de webhook.

Padrões de segurança que vale a pena manter

  • Crie uma chave de API separada para cada aplicativo ou agente, para que ela possa ser revogada de forma independente.
  • Inicie uma auditoria com escopos somente leitura. Adicione services:write ou wallet:spend apenas depois de revisar o plano proposto.
  • Armazene as chaves em variáveis de ambiente ou em um gerenciador de segredos, nunca no código-fonte, em prompts, capturas de tela ou em uma configuração MCP versionada.
  • Use o total esperado da cotação para as compras. Uma alteração de preço rejeita a operação em vez de cobrar silenciosamente um valor maior.
  • Reutilize uma chave de idempotência ao repetir uma solicitação financeira que atingiu o timeout, para que a mesma operação não seja cobrada duas vezes.
  • Revise as assinaturas de webhook e o histórico de entregas antes de tornar os eventos parte de um fluxo de trabalho crítico.

Comece com visibilidade e depois conceda controle

Uma auditoria somente leitura responde se a migração é viável sem expor acesso financeiro ou de gravação. Depois que o plano for aprovado, crie uma chave de produção com escopo restrito e implemente com base na especificação OpenAPI ativa.