servidor mcp
Tus agentes, conectados a GPU Flow.
Un servidor que expone la inferencia europea de GPU Flow y la gestión de tu cuenta como herramientas para agentes. Claude Desktop, Cursor o el agente que uses las llaman solos, con el Model Context Protocol.
Antes de empezar
Dos cosas: Node y una cuenta. Lo que pongas en la configuración decide hasta dónde llega el agente.
Node 20 o superior
Si no lo tienes, instálalo desde nodejs.org. No hace falta clonar ningún repositorio: el paquete se descarga solo.
Una clave de API
Para la inferencia. La creas en tu panel, en la sección de claves. Si solo quieres que tu agente hable con los modelos, con esto basta.
Correo y contraseña
Solo si quieres que el agente vea tu saldo o maneje tus Sandboxes. Lee antes el apartado de credenciales: una contraseña no es una clave de API.
Añadirlo a Claude Desktop
Claude Desktop guarda los servidores MCP en un archivo de configuración. Ábrelo desde la propia aplicación, pega el bloque y reinicia.
- 1 · Abre la configuraciónEn Claude Desktop: menú de abajo a la izquierda, Settings, Developer, Edit Config. Usa este menú en vez de buscar el archivo a mano: puede vivir en dos sitios distintos según cómo se instalara la aplicación, y editar el que no es la causa más común de que la configuración no surta efecto.
- 2 · Pega el bloqueSi el archivo está vacío o solo tiene un par de llaves, reemplázalo entero. Si ya tiene una sección mcpServers, añade dentro solo el bloque gpuflow, con una coma detrás de la entrada anterior.
- 3 · Reinicia del todoCerrar la ventana no basta. Haz clic derecho en el icono de la bandeja del sistema y elige Quit; luego abre la aplicación otra vez.
claude_desktop_config.json
{
"mcpServers": {
"gpuflow": {
"command": "npx",
"args": ["-y", "@gpuflow/mcp"],
"env": {
"GPUFLOW_API_KEY": "sk-gpuflow-...",
"GPUFLOW_EMAIL": "[email protected]",
"GPUFLOW_PASSWORD_FILE": "C:\\ruta\\a\\tu\\contrasena.txt"
}
}
}
}En Windows, barras dobles
Las rutas del archivo van con barras invertidas dobles. Una barra simple es, junto a un error de escritura, la causa más frecuente de que el servidor no arranque.
Qué le das y qué puede hacer
Solo con la clave de API, tu agente puede usar los modelos. Para el saldo y los Sandboxes hace falta iniciar sesión, y ahí conviene parar un momento.
Una contraseña no es una clave de API
Tu contraseña puede crear y destruir máquinas, borrar archivos, crear llaves y cambiar el correo de la cuenta. Una clave de API solo puede preguntarle a un modelo, y se revoca sola. Si vas a probar, usa una cuenta de prueba; si ya has usado la tuya, cámbiala al terminar.
Usa un archivo, no la contraseña
El archivo de configuración guarda lo que le pongas en texto plano, sin cifrar: cualquier proceso que corra con tu usuario puede leerlo. Por eso es mejor GPUFLOW_PASSWORD_FILE que GPUFLOW_PASSWORD: creas un archivo que contiene solo la contraseña y pones ahí la ruta. Una ruta se puede pegar y compartir sin riesgo; una contraseña, no.
Las dos a la vez, no
Las variables GPUFLOW_PASSWORD y GPUFLOW_PASSWORD_FILE son excluyentes. El servidor se niega a arrancar si encuentra las dos, en vez de elegir una por su cuenta.
La sesión se abre cuando hace falta
El inicio de sesión ocurre la primera vez que se llama a una herramienta de cuenta. Si solo haces inferencia, no necesitas credenciales. Los tokens viven en memoria y no se escriben nunca en disco.
No lo enseñes
No hagas capturas de pantalla del archivo de configuración ni lo pegues en un chat o un correo.
Veinte, en tres grupos
Doce de solo lectura, siempre disponibles. Siete que cambian algo, apagadas de fábrica. Y un diagnóstico.
| Grupo | Qué hacen | Qué necesitan |
|---|---|---|
| Inferencia | Listar el catálogo de modelos y hablar con uno. | Clave de API |
| GPU | La oferta de GPU dedicada y la capacidad libre. | Nada |
| Cuenta | Tu saldo, tus claves de API en prefijo y tu consumo. | Sesión |
| Sandboxes, lectura | Listarlos, ver su estado en vivo, su gasto y tus discos. | Sesión |
| Sandboxes, escritura | Crear, pausar, reanudar, borrar, cambiar la pausa automática y añadir una llave. | Sesión y permiso |
| Diagnóstico | Un estado agregado de todo lo anterior. | Nada |
Cómo nombrar un Sandbox
Las herramientas de Sandbox aceptan el nombre completo, la etiqueta que le pusiste o una parte del nombre que sea inequívoca.
Dos formas de mirar el estado
El estado de la lista es el último estado guardado; el de la consulta individual es la fase viva de la máquina. Mientras un cambio está en curso pueden no coincidir, y eso es normal.
doctor dice la verdad
Devuelve un estado agregado de la inferencia, la clave, la sesión, el saldo y los Sandboxes. Si un servicio no responde, se pone en rojo en vez de decir que todo va bien. Es de solo lectura, pero su sonda hace una llamada mínima a un modelo, y esa llamada se factura.
Dos cifras que no se suman
El consumo de tu cuenta y el gasto de un Sandbox vienen de sitios distintos y pueden enseñarse en monedas distintas. Son conceptos separados: no los compares ni los sumes.
Nada cambia sin que lo enciendas
Las siete herramientas que crean, pausan o borran vienen apagadas. Aparecen en la lista, pero rechazan la llamada con un mensaje claro mientras no enciendas el permiso.
El interruptor
Se enciende poniendo GPUFLOW_MCP_ALLOW_WRITES en 1 dentro del bloque env de la configuración. Sin eso, un agente no puede cambiar por accidente nada que se facture.
claude_desktop_config.json
"env": {
"GPUFLOW_API_KEY": "sk-gpuflow-...",
"GPUFLOW_EMAIL": "[email protected]",
"GPUFLOW_PASSWORD_FILE": "C:\\ruta\\a\\tu\\contrasena.txt",
"GPUFLOW_MCP_ALLOW_WRITES": "1"
}Y aun así, una segunda llave
Lo irreversible y lo que cuesta dinero lleva además una confirmación previa. Sin confirmar, la herramienta te dice exactamente qué haría y no hace nada.
| Herramienta | Sin confirmar | Confirmando |
|---|---|---|
| Borrar un Sandbox | Dice cuál borraría. No actúa. | Lo borra. |
| Borrar un disco | Dice cuál borraría. No actúa. | Lo borra. |
| Crear un Sandbox | Devuelve la especificación exacta. No actúa. | Lo crea. |
El agente sabe lo que toca
Cada herramienta declara si es de solo lectura, si destruye algo y si repetirla da el mismo resultado. Con eso, tu cliente MCP puede decidir cuándo pedirte confirmación.
Ver que ha funcionado
Claude Desktop debería enseñar un icono de herramientas cerca de la caja de mensaje. Haz clic y busca gpuflow con su lista debajo.
Si no aparece
Ve a Settings, Developer, y busca un error junto a gpuflow. Las causas más comunes son un error de escritura en el archivo, una ruta equivocada o barras invertidas simples en vez de dobles.
La prueba de que arrancó
Busca el registro más reciente y abre el archivo. Una línea como esta es la prueba de que la configuración surtió efecto. Si no la encuentras, Claude Desktop nunca llegó a arrancar el servidor: es un problema de configuración.
Get-ChildItem "$env:APPDATA\Claude\logs", "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs" -Filter "mcp*.log" -ErrorAction SilentlyContinue | Select-Object FullName, LastWriteTime
Dale herramientas a tu agente.
Cuenta en un minuto, sin tarjeta, con 50 € de saldo ya cargados.