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 no puede crear tokens, comprar ni cancelar paquetes, ni gastar saldo. Puede cambiar la ubicación, el intervalo de rotación o la IP de un token reubicable, y las IP permitidas de un paquete, como se describe más abajo. 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.
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 |
no definida | Clave de API de Configuración |
LITPORT |
https:// |
Reemplaza el origen de la API. |
LITPORT |
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 |
Credenciales completas de un token. | no |
get |
Tráfico y componentes de cobro de un token. | no |
get |
Lee la ubicación guardada y la efectiva de un token reubicable. | no |
list |
Lista los valores que se pueden usar ahora en el siguiente campo de ubicación de un token. | no |
set |
Cambia la ubicación de un token reubicable. | 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 (solo estáticos de centro de datos/ISP). | sí |
list |
Lista tus paquetes con estado, producto, complementos e ID de tokens. | no |
get_package |
Lee un paquete. | no |
get |
Lee la lista de IP permitidas de un paquete. | no |
set |
Define la lista completa de IP permitidas de un paquete. | sí |
add |
Agrega una IP a la lista de IP permitidas de un paquete. | sí |
remove |
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 |
Países, regiones y ciudades que puede segmentar un pool. | no |
get_balance |
Saldo, unidades reservadas y plan. | no |
build |
Arma una URL de proxy que funciona, con parámetros de geo y de sesión. | no |
explain |
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 |
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 |
Lee los mensajes nuevos de la conversación con soporte. | no |
reply |
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. Crear o eliminar tokens, y comprar, renovar o cancelar un paquete, se sigue haciendo en el panel.
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? No. Algunas herramientas escriben (consulta la tabla anterior: la ubicación, la rotación o la IP nueva de un token reubicable, y las IP permitidas de un paquete), pero ninguna puede crear ni eliminar un token, ni mover dinero. Crear tokens y comprar tráfico se sigue haciendo en el panel.
¿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.
Relacionado#
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.