Menú de la documentación

Inicio

Fundamentos de proxy

API de proxies

Caché de respuestas

API de Litport

Servidor MCP

Servidor MCP para asistentes de IA

Conecta un asistente de IA para programar a tu cuenta de Litport con el servidor del Model Context Protocol (MCP). El asistente lista tus tokens de proxy, lee el uso y los cobros, descubre los países que puede segmentar un pool y arma cadenas de conexión de proxy que funcionan, sin que tengas que escribir antes un cliente HTTP.

El servidor puede consultar tokens, uso, paquetes, pools y la segmentación geográfica; crear, cambiar, volver a emitir las credenciales y eliminar proxies de pago por GB (etiqueta, activado o desactivado, pool, caducidad, tope de tráfico); leer el uso de muchos proxies a la vez; cambiar la ubicación, la rotación o la IP de un token reubicable; administrar las IP permitidas de un paquete; armar URL de proxy y contactar con soporte. No puede comprar, renovar ni cancelar un paquete, recargar el saldo ni mover saldo. Los proxies de pago por GB que crea gastan el saldo solo a medida que se cobra su tráfico; pagar paquetes con el saldo se sigue haciendo en el panel. Los perfiles de VPN también se crean en el panel; el servidor no puede crearlos ni cambiarlos. Las solicitudes IPv6 no se admiten; ponte en contacto con soporte.

Instalación#

El servidor se ejecuta en tu propio equipo y se comunica con este sitio por HTTPS. Crea una clave de API en Configuración y luego agrega el servidor a tu host MCP. El paquete se publica en npm como @litportnet/litport-mcp, su código fuente está en GitHub y está incluido en el MCP Registry oficial como io.github.litportnet/litport-mcp.

Claude Code:

claude mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

Codex:

codex mcp add litport --env LITPORT_API_KEY=lit_your_key_here -- npx -y @litportnet/litport-mcp

Esto escribe el servidor en ~/.codex/config.toml. También puedes agregar el bloque a mano:

[mcp_servers.litport]
command = "npx"
args = ["-y", "@litportnet/litport-mcp"]

[mcp_servers.litport.env]
LITPORT_API_KEY = "lit_your_key_here"

Compruébalo con codex mcp list, inspecciona una entrada con codex mcp get litport y elimínalo con codex mcp remove litport.

Claude Desktop, Cursor, Windsurf y otros hosts que lanzan un proceso local usan un bloque de configuración:

{
  "mcpServers": {
    "litport": {
      "command": "npx",
      "args": ["-y", "@litportnet/litport-mcp"],
      "env": { "LITPORT_API_KEY": "lit_your_key_here" }
    }
  }
}

Variables de entorno#

Variable Predeterminado Efecto
LITPORT_API_KEY no definida Clave de API de Configuración. No es un usuario ni una contraseña de proxy. Sin ella, solo se cargan las herramientas de soporte y de documentación, y las preguntas a soporte van a una conversación de invitado.
LITPORT_API_URL https://litport.net Reemplaza el origen de la API.
LITPORT_MCP_REVEAL_CREDENTIALS no definida Establécela en 1 para incluir las contraseñas de proxy directamente en la salida de list_tokens.

Herramientas#

Herramienta Qué hace Escritura
list_tokens Lista tus tokens con tipo, estado y datos de entrada. no
get_token_credentials Credenciales completas de un token. no
get_token_usage Tráfico y componentes de cobro de un token. no
get_usage Uso diario de muchos proxies a la vez en un rango de fechas, con los proxies eliminados incluidos y el cobro diario de los proxies de pago por GB. no
get_token_location Lee la ubicación guardada y la efectiva de un token reubicable. no
list_location_options Lista los valores que se pueden usar ahora en el siguiente campo de ubicación de un token. no
set_token_location Cambia la ubicación de un token reubicable, o envía random: true para usar otra ubicación que el token pueda usar ahora. sí
set_rotation Cambia el intervalo de rotación de un token rotativo. sí
get_new_ip Obtiene una IP nueva en la misma ubicación (centro de datos/ISP). sí
create_token Crea un proxy de pago por GB activo, con un pool opcional, una etiqueta, tu propio externalRef, una caducidad y un tope de tráfico. Devuelve sus credenciales. sí
update_token Cambia la etiqueta, el interruptor de activación, el pool, la caducidad o el tope de tráfico de un proxy de pago por GB. El proxy de un paquete solo admite la etiqueta. No devuelve credenciales. sí
reissue_credentials Emite un usuario, una contraseña y una clave de cambio de IP nuevos para un proxy. La contraseña anterior deja de funcionar y sus conexiones abiertas se cierran. sí
delete_token Elimina un proxy de pago por GB. Su historial y su uso se conservan. sí
list_packages Lista tus paquetes con estado, producto, complementos e ID de tokens. no
get_package Lee un paquete. no
get_allowed_ips Lee la lista de IP permitidas de un paquete. no
set_allowed_ips Define la lista completa de IP permitidas de un paquete. sí
add_allowed_ip Agrega una IP a la lista de IP permitidas de un paquete. sí
remove_allowed_ip Elimina una IP de la lista de IP permitidas de un paquete. sí
list_pools Pools de pago por GB que se pueden elegir, con precio efectivo por GB, puertos, compatibilidad con UDP (udp), hubs elegibles y niveles geográficos. no
list_targeting_options Países, regiones y ciudades que puede segmentar un pool. no
get_balance Saldo, unidades reservadas y plan. no
build_proxy_url Arma una URL de proxy que funciona, con parámetros de geo y de sesión. no
explain_proxy_error Traduce un código de error de proxy en una decisión de reintento. no
search_docs Encuentra la página de documentación sobre un tema. no
get_doc Lee una página de documentación como Markdown. no
contact_support Hace una pregunta al soporte de Litport. Con una clave de API va a la conversación de tu cuenta; sin ella inicia una conversación de invitado y necesita tu correo electrónico. sí
get_support_replies Lee los mensajes nuevos de la conversación con soporte. no
reply_to_support Agrega un mensaje a la conversación con soporte. sí

Toda herramienta de la cuenta que escribe necesita la misma clave de API que cualquier lectura; no hay un permiso de escritura aparte. Las herramientas de soporte funcionan con clave o sin ella: consulta Contactar con soporte. Comprar, renovar o cancelar un paquete, y recargar el saldo, se sigue haciendo en el panel.

Cuando la API rechaza una llamada, el texto de error de la herramienta incluye el mensaje y el code de la API, y retryable cuando lo envió. retryable: true significa que la misma llamada, enviada de nuevo sin cambios tras la espera, puede funcionar; false significa que primero hay que cambiar algo.

explain_proxy_error responde a partir de una copia de la referencia de errores de proxy incluida en el paquete, así que diagnosticar un fallo no cuesta nada y no consume límite de frecuencia.

Cómo se manejan las contraseñas de proxy#

list_tokens es una operación de consulta, así que oculta las contraseñas de forma predeterminada: cada token informa password: null con passwordSet: true. Así, un listado de muchos tokens no coloca todas las contraseñas en el contexto del asistente ni, a través de él, en tu historial de chat.

No se oculta nada. get_token_credentials y build_proxy_url devuelven la contraseña real del único token por el que preguntaste. Establece LITPORT_MCP_REVEAL_CREDENTIALS=1 si prefieres tener las credenciales dentro de los listados.

build_proxy_url también acepta credentialStyle: "env", que devuelve la URL con $LITPORT_PROXY_PASSWORD en lugar de la contraseña y entrega el valor por separado. Úsalo cuando el asistente esté escribiendo un script que piensas conservar, para que la contraseña no termine en tu código fuente.

Armar una cadena de conexión#

build_proxy_url aplica las reglas de los parámetros de proxy PPG antes de devolver algo, así que un slug de país mal formado o una duración de sesión fuera de rango se informan de inmediato y no después de una solicitud rechazada.

Para un token de pago por GB agrega los segmentos de pool, geo y sesión al usuario y elige el puerto que corresponde al protocolo elegido. Un token con un pool guardado no admite un argumento de pool, y uno que entre en conflicto se rechaza. Un token sin pool guardado requiere el argumento de pool, porque el pool determina el precio.

Un token ilimitado se conecta al único endpoint que tiene asignado, así que no admite pool ni parámetros de geo o de sesión.

Preguntas#

¿Puede crear proxies o gastar mi saldo? Puede crear proxies de pago por GB, que gastan el saldo a medida que se cobra su tráfico, y cambiarlos o eliminarlos. No puede comprar, renovar ni cancelar un paquete, recargar el saldo ni mover saldo.

¿Necesita mi contraseña de proxy para iniciar? No. Se autentica con una clave de API, que es independiente de las credenciales del proxy. Un usuario y una contraseña de proxy se rechazarán como clave de API.

¿Con qué asistentes funciona? Con cualquier host MCP que pueda lanzar un proceso local, incluidos Claude Code, Codex, Claude Desktop, Cursor, Windsurf y Zed.

¿Mi clave se envía al modelo? No. La clave permanece en el proceso del servidor en tu equipo y se usa solo en el encabezado Authorization hacia este sitio.

¿Qué pasa cuando alcanzo el límite de frecuencia? La API permite un número fijo de solicitudes por minuto por clave y responde 429 al superarlo. Tres herramientas no necesitan ninguna clave de API (explain_proxy_error, search_docs y get_doc), así que siguen funcionando cuando se alcanza el límite. Las dos últimas sí obtienen páginas de documentación de este sitio.

¿Por qué un token no muestra host? Un token ilimitado informa ingress.status: "hub-unavailable" cuando nombra un hub que ya no está en servicio. El status del propio token solo informa active, expired o disabled. Ponte en contacto con soporte para mover un token con hub no disponible a un hub vigente.

La API a la que llaman estas herramientas está documentada en Litport API, y sus códigos de error en Errores de la API. El contrato legible por máquinas está en /docs/openapi.json.

MarkdownOpenAPI