FutureInfra MCP

npx add-mcp 'https://futureinfra.ai/v1/mcp'

Conexión con Claude Code

No es necesario copiar ninguna clave. Después de añadir el MCP, simplemente inicia sesión o regístrate en el navegador.

claude mcp add --transport http futureinfra https://futureinfra.ai/v1/mcp

# Claude Code에서
/mcp

Cuando autorices los permisos en el navegador, la ventana se cerrará y Claude continuará con la solicitud que había quedado en pausa. Si tienes varias organizaciones, elige la organización a la que deseas conectarte en la pantalla de aprobación. Después de conectarte, puedes decirle a la IA "cámbiame a la organización de marketing" y cambiará sin necesidad de volver a iniciar sesión.

Conexión con clave API (entornos sin navegador, automatización, CI)

Usa la clave pk_live_ emitida en Consola → Claves API como encabezado. Esta clave es secreta.

claude mcp add --transport http --scope user futureinfra https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 발급받은_키"

Si le das a un agente de IA la dirección https://futureinfra.ai/llms.txt y la clave, te indicará el comando anterior. La mayoría de las IAs no escriben claves secretas en la configuración por sí mismas, así que pega el comando que te devuelva la IA directamente en la terminal.

Cuando hay varias organizaciones

La clave API está vinculada únicamente a la organización donde fue emitida. Para usar dos organizaciones juntas, obtén una clave para cada una y regístralas con nombres diferentes. Si las registras con el mismo nombre, la última sobrescribirá a la anterior y la IA trabajará en la organización equivocada.

claude mcp add --transport http --scope user futureinfra-onto https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 온투_조직_키"
claude mcp add --transport http --scope user futureinfra-marketing https://futureinfra.ai/v1/mcp --header "Authorization: Bearer 마케팅_조직_키"

• Cada vez que la IA se conecta, recibe la indicación de a qué organización está vinculada actualmente y verifica la organización antes de crear o eliminar.
• Las conexiones mediante inicio de sesión en navegador (como el conector de la app de Claude) admiten una sola organización a la vez y se cambian con account.switch_org.
• Si ya tienes futureinfra registrada y recibes una clave nueva, verifica primero a qué organización pertenece esa conexión antes de eliminarla.

Claves pegadas en el chat

Una clave pegada en el chat se considera expuesta. Cuando termines el trabajo, la IA puede revocarla por sí misma (account.revoke_key, sin argumentos revoca la clave en uso). Una clave solo puede revocarse a sí misma; las demás claves las revoca una persona desde la consola. La revocación no afecta a otros recursos como servidores o aplicaciones.

Después de cualquier cambio, reinicia el cliente de IA. Esto aplica cuando cambias la dirección, cuando completas la autenticación y cuando añadimos nuevas herramientas.
La lista de herramientas se lee solo una vez al iniciar la conexión. Por eso, aunque ya estén disponibles en el servidor, no aparecerán en la ventana en ejecución — no es un fallo, simplemente aún no se han cargado.

Flujo de conexión por navegador

Es un flujo que no expone contraseñas, información personal, datos de pago ni claves de largo plazo en la conversación con la IA.

1. Verificación de cuenta La IA pregunta si ya tienes una cuenta existente.
2. Autenticación en navegador El usuario inicia sesión o se registra directamente en FutureInfra.
3. Confirmación de permisos El usuario aprueba los alcances necesarios y el límite mensual.
4. Reanudación automática Al cerrar la ventana, la IA continúa con la solicitud que había quedado en pausa.

Qué configurar antes de delegar

• Reduce los alcances. Si solo necesitas lectura, basta con cloud:read.
• Establece límites. Cada clave tiene un tope mensual; al superarlo, las llamadas son rechazadas.
• La eliminación no es automática. Las operaciones irreversibles requieren aprobación humana.
• Revisa los registros de auditoría. Todo lo que hace el agente queda registrado.

Alcances

Alcance	Permisos
cloud:read	Consulta de servidores, instantáneas y cortafuegos
cloud:write	Creación, encendido, instantáneas y apertura de puertos (la eliminación requiere aprobación)
domain:read / domain:write	Consulta / modificación de dominios
llm:*	Llamadas a modelos de IA
billing:read	Consulta de saldo y uso

Las funciones de administrador no son accesibles mediante claves API. Aunque una clave se filtre, no se puede acceder a los recursos de otros clientes ni a la configuración de facturación.