Conectá tu agente IA a pinfra
Dos caminos reales: un servidor MCP remoto que anda con cualquier agente, o el CLI instalado en tu máquina para publicar carpetas de verdad.
Qué necesitás
Una cuenta de pinfra. Con eso elegís: darle a tu agente una clave para el MCP remoto (sirve con cualquier cliente), o instalar el CLI si tu agente tiene terminal y necesitás publicar una carpeta.
Opción A — MCP remoto (recomendada para cualquier agente)
platform.pinfra.app/mcp es un servidor MCP que corre adentro de la plataforma: no hay binario que instalar ni toolchain de Go. Sirve con cualquier cliente que hable MCP por HTTP (Claude Desktop, Claude Code, u otro). Necesitás una clave personal (Configuración → "Claves para conectar herramientas", o la que dejó pinfra login en ~/.pinfra/config.json):
claude mcp add --transport http pinfra https://platform.pinfra.app/mcp \ --header "Authorization: Bearer <tu-clave>"
La sintaxis de --header/-H es la del propio claude mcp add — para otro cliente, buscá cómo agrega un header HTTP al conectar un server remoto.
⚠ publicar_aplicacion está en el listado (mismo nombre, misma descripción) pero rechaza siempre por esta vía: no hay una carpeta de tu proyecto a la que la plataforma pueda acceder. Si el modelo la llama, te va a sugerir pinfra publish.
Opción B — el CLI en tu computadora (para publicar carpetas)
Un agente CON terminal (Claude Code, Cursor, Codex, Gemini CLI) puede hacer más que el MCP remoto: pinfra publish lee la carpeta de tu proyecto directo del disco donde corre, algo que un servidor adentro de la plataforma no puede hacer nunca.
Instalar
Mac / Linux
Windows (PowerShell)
Conectar tu computadora
Abre tu navegador para confirmar con un click. Para CI o un entorno headless, pinfra login --key acepta una clave personal sin prompt.
Vincular la carpeta (una sola vez)
Guarda el vínculo en .infra.json: después de esto, publish/status/logs ya no necesitan --app.
Publicar
Ver los logs de la aplicación publicada
agente.md — el onboarding de una sola línea
Si tu agente puede leer una URL y correr comandos, esta es la forma más corta de arrancar: pegale esta frase y que siga los pasos solo. Es la versión condensada de esta guía, escrita para que la lea un agente, no un humano.
Pedile a tu agente
Con cualquiera de las dos opciones configurada, probá pedirle a tu agente, en tu idioma:
- "Publicá esta carpeta como mi-tienda"
- "¿En qué dirección está publicada mi-tienda?"
- "Fijate qué aplicaciones tengo y publicá los cambios en la de turnos"
Qué puede hacer hoy tu agente, por opción
| MCP remoto | CLI local | |
|---|---|---|
| Ver tus aplicaciones | Sí — listar_aplicaciones | Sí — pinfra apps |
| Ver el estado de una publicación | Sí — estado_de_la_aplicacion | Sí — pinfra status |
| Publicar | No — rechaza siempre, sugiere pinfra publish | Sí — pinfra publish |
| Ver logs del container | No — no existe esa herramienta por MCP | Sí — pinfra logs |
| Ver y volver a una versión anterior | Sí — list_versions y restore_version | No — todavía no hay comando; restaurá desde la ficha en pinfra.app |
Seguridad
- La clave se guarda hasheada del lado del servidor — se te muestra una sola vez al crearla, y después solo vemos su huella corta.
- Podés darla de baja en cualquier momento desde Configuración → "Claves para conectar herramientas": deja de funcionar en el acto.
- La clave solo viaja por https:// (localhost es la única excepción, para desarrollo).
- Nunca la pegues a mano en un archivo que vaya a un repositorio (un .env commiteado, un script, etc.) — pasala por variable de entorno o dejá que pinfra login la guarde por vos.
Problemas frecuentes
"publicar_aplicacion" rechaza siempre por MCP remoto
Es esperado: el servidor MCP remoto no tiene acceso a ninguna carpeta de tu computadora. Para publicar de verdad, instalá el CLI (Opción B) y corré pinfra publish.
Tu agente no tiene terminal
Usá la Opción A (MCP remoto): funciona con Claude Desktop y cualquier otro cliente sin instalar nada, aunque no pueda publicar carpetas.
"Ya hay una publicación en curso para esta aplicación"
Algo se está publicando ahora mismo. Pedile a tu agente que consulte estado_de_la_aplicacion (MCP) o pinfra status (CLI) hasta que termine.
pinfra logs --follow no actualiza en vivo
Todavía no hace streaming: se acepta el flag pero muestra el resultado de una sola vez. Para "vigilar" logs hoy, repetí pinfra logs --since 30s en un loop.