¡NUEVO! |Una llamada API, datos limpios de vuelta.Obtener 10.000 tokens gratis →

Plataforma para desarrolladores

API y MCP de FineProxy

Automatice las operaciones de proxy desde su código o conecte un agente de IA. Consulte qué funciones son compatibles, dónde se aplican medidas de seguridad y cómo auditar una integración existente antes de cambiar de proveedor.

API REST49 operaciones OpenAPI
Servidor MCP49 herramientas para agentes
AccesoClaves de API con permisos limitados

Una plataforma, dos formas de automatizar

La API y MCP utilizan las mismas claves de FineProxy con permisos limitados y permiten acceder a los mismos flujos de trabajo del cliente. Elija según quién vaya a utilizarlos: su aplicación o un agente de IA.

REST · OpenAPI 3.1

Integre FineProxy en su aplicación

Utilice endpoints HTTP documentados desde un backend, un script, una tarea de CI, un panel interno o un flujo de trabajo sin código. La especificación actual para clientes está disponible en el panel.

La mejor opción cuando su código debe:
  • Ejecutar flujos de trabajo deterministas sin un modelo de IA
  • Validar las estructuras de solicitudes y respuestas con OpenAPI
  • Controlar los reintentos, las colas, los registros y el despliegue
Abrir la documentación de la API

JSON-RPC 2.0 · Streamable HTTP

Proporcione acceso controlado a un agente de IA

Conecte Cursor, Claude, VS Code, Cline, n8n u otro cliente MCP al servidor de FineProxy. El agente recibe las herramientas permitidas por los scopes de la clave de API.

La mejor opción cuando quiere que un agente:
  • Consulte el inventario, los servicios, el uso y el historial de soporte
  • Cotice y ejecute operaciones de servicio aprobadas
  • Diagnostique fallos y explique los cambios recomendados
Abrir la configuración de MCP en el panel

Audite una integración existente antes de migrar

Descargue un archivo Markdown, adjúntelo a un agente de programación junto con su repositorio y ejecute el prompt de auditoría preparado. La primera revisión es de solo lectura: identifica la compatibilidad, los adaptadores, los obstáculos y el código exacto que habría que modificar.

Prompt de auditoría de migración de solo lectura
Lea el paquete para agentes de FineProxy adjunto e inspeccione este repositorio.

No modifique el código durante la primera revisión.

Localice todos los lugares donde se configura o utiliza el proveedor de proxies actual. Compare cada flujo de trabajo con las capacidades documentadas de FineProxy. Informe sobre:
1. Flujos de trabajo totalmente compatibles.
2. Flujos de trabajo que necesitan un adaptador o una transformación de datos.
3. Comportamiento no compatible o poco claro.
4. Permisos necesarios de la API de FineProxy.
5. Archivos y rutas de código exactos que cambiarían.
6. Cambios de autenticación y almacenamiento de secretos.
7. Un plan de migración por fases con reversión.
8. Pruebas de integración necesarias antes de la transición.

No invente endpoints. Marque como pregunta todo aquello que no esté confirmado por el paquete para agentes o la especificación OpenAPI actual.

La auditoría debe verificar

  1. 01Dónde se inicializa y se utiliza el proveedor actual
  2. 02Las diferencias de autenticación y almacenamiento de secretos
  3. 03Los flujos de compra, renovación y cancelación de servicios y actualización de IP
  4. 04Los formatos de listas de proxies, protocolos, puertos y métodos de autorización
  5. 05La selección de países, las listas blancas y los límites de conexión
  6. 06La paginación, los reintentos, la idempotencia, los errores y la gestión de límites
  7. 07Las dependencias de facturación, análisis de uso, soporte y webhooks
  8. 08Un plan de migración y pruebas archivo por archivo sin modificar el código

Para implementar endpoints concretos, proporcione también al agente el archivo OpenAPI actual descargado desde el panel. El paquete para agentes no contiene credenciales ni datos privados de la cuenta de forma intencionada.

Qué puede automatizar

La capa pública explica flujos de trabajo completos en lugar de reproducir cada endpoint. Utilice la especificación OpenAPI actual al implementar solicitudes individuales.

01

Compra y aprovisionamiento

Consulte el inventario disponible en tiempo real, calcule una combinación exacta de países y realice un pedido desde el monedero del panel.

  • Consultar los países disponibles y el inventario actual de IP
  • Cotizar un paquete para varios países sin comprometer fondos
  • Comprar con protección de precio y clave de idempotencia
02

Gestión de servicios

Gestione servicios activos sin esperar un ticket de soporte cuando el plan admita la acción solicitada.

  • Renovar, suspender, restaurar o cancelar servicios
  • Sustituir o añadir IP y actualizar credenciales
  • Gestionar la renovación automática, las listas blancas y los complementos de conexión
03

Análisis y diagnóstico

Utilice la telemetría de la cuenta y de los servicios para investigar la carga, la fiabilidad y el comportamiento de los destinos.

  • Consultar resúmenes de uso y series temporales
  • Consultar los principales destinos y categorías de errores
  • Recibir diagnósticos y recomendaciones operativas
04

Facturación y soporte

Conecte las operaciones de proxy con los flujos de trabajo financieros y de soporte asociados.

  • Consultar facturas y descargar sus archivos PDF
  • Iniciar un depósito en el monedero y comprobar su estado
  • Crear, consultar, responder y cerrar tickets de soporte
05

Acceso a proxies

Obtenga la configuración que necesitan las aplicaciones para conectarse mediante los proxies adquiridos.

  • Consultar la configuración de conexión de proxies rotativos
  • Cambiar el nombre de usuario y la contraseña del servicio
  • Gestionar los límites de conexión por IP en la lista blanca
06

Eventos y cuenta

Mantenga sincronizados los sistemas externos y consulte información de la cuenta relevante para la seguridad.

  • Configurar webhooks y gestionar sus entregas
  • Consultar datos del perfil, la IP del solicitante y el historial de inicios de sesión
  • Gestionar claves de API con permisos seleccionados de forma específica

Lo que la plataforma no hará

La automatización de FineProxy está limitada deliberadamente. El acceso depende de la clave, el plan de servicio, el inventario disponible y las comprobaciones de seguridad explícitas.

Sin acceso fuera de los scopes concedidos

Una herramienta o endpoint no puede consultar ni modificar un recurso si la clave de API no incluye el permiso necesario.

Sin gastos sin wallet:spend

Las compras, las renovaciones y las actualizaciones de IP de pago no están disponibles si no se incluye el scope financiero.

Sin acciones destructivas silenciosas

Las operaciones irreversibles requieren una marca de confirmación explícita. No pueden producirse como efecto secundario de una solicitud de lectura.

Sin acceso al código fuente mediante MCP

MCP de FineProxy gestiona la cuenta del cliente. Para auditar un script, el agente de programación también debe tener acceso a ese script o repositorio.

Sin garantía de inventario no disponible

La disponibilidad por país y las cantidades se comprueban con el inventario en tiempo real. La automatización no puede pedir inventario que no esté disponible.

Sin API para partners inactivos

La especificación para partners y los endpoints de informes solo se muestran cuando la cuenta tiene el estado de partner activo.

Conecte un agente en minutos

Cree una clave de API específica en el panel, seleccione únicamente los scopes que necesite el agente y añada la configuración de MCP a su cliente. Guarde la clave real en un secreto o una variable de entorno.

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

OpenAPI 3.1

Utilice la especificación actual para la implementación

El panel muestra la especificación OpenAPI 3.1 seleccionada para clientes, ejemplos de solicitudes, esquemas de respuesta y fragmentos de cliente generados. Los partners activos también reciben una especificación independiente para partners.

Ver la referencia interactiva de la API

Elija el conjunto mínimo de permisos necesario

Los accesos de lectura y escritura están separados. Comience con scopes de solo lectura para el análisis y las auditorías de migración; añada acceso de escritura o financiero únicamente al flujo de trabajo que lo requiera.

customer:read

Consultar el perfil y la información de la cuenta del cliente.

customer:write

Actualizar la información del cliente.

wallet:read

Consultar el saldo y los datos del monedero.

wallet:deposit

Crear y supervisar depósitos en el monedero.

wallet:spend

Permitir que la automatización gaste fondos del monedero.

services:read

Consultar los servicios, la configuración de los proxies y el estado de los servicios.

services:write

Crear o modificar servicios y complementos.

tickets:read

Consultar los tickets de soporte y sus mensajes.

tickets:write

Crear, responder, actualizar o cerrar tickets.

catalog:read

Consultar productos, opciones, países e inventario actual.

usage:read

Consultar el uso de los servicios y los análisis de diagnóstico.

webhooks

Crear y gestionar suscripciones a webhooks.

Configuraciones de seguridad predeterminadas que conviene mantener

  • Cree una clave de API independiente para cada aplicación o agente, de modo que pueda revocarse por separado.
  • Comience una auditoría con scopes de solo lectura. Añada services:write o wallet:spend únicamente después de revisar el plan propuesto.
  • Guarde las claves en variables de entorno o en un gestor de secretos, nunca en el código fuente, prompts, capturas de pantalla o configuraciones de MCP incluidas en el repositorio.
  • Utilice el total previsto de la cotización para las compras. Si cambia el precio, la operación se rechaza en lugar de cobrar silenciosamente una cantidad mayor.
  • Reutilice una clave de idempotencia al reintentar una solicitud financiera que haya superado el tiempo de espera para que la misma operación no pueda cobrarse dos veces.
  • Revise las firmas de los webhooks y el historial de entregas antes de incorporar eventos a un flujo de trabajo crítico.

Comience con visibilidad y después conceda el control

Una auditoría de solo lectura permite saber si la migración es viable sin exponer acceso financiero ni de escritura. Una vez aprobado el plan, cree una clave de producción con scopes limitados e implemente la integración conforme a la especificación OpenAPI actual.