Para agentes

Esta página reúne lo que un asistente necesita para entender y operar la plataforma sin ejecutar JavaScript. Todo lo que se lista aquí es público: leer la documentación no pide token; actuar sobre la plataforma, sí.

Por dónde empezar

Dirección	Qué es
`/agent.md`	El briefing: qué es cierto aquí, dónde llamar y qué significa cada negativa. Empieza por aquí
`/api/infra/agent`	El mismo briefing en JSON, con la tabla de códigos de error y cuáles se pueden reintentar
`/llms.txt`	El índice: el MCP, el CLI y una línea por página de esta documentación
`/llms-full.txt`	Toda la documentación en un solo cuerpo
`/skill.md`	La guía operativa de la API HTTP, con sus trampas

El mismo briefing lo entrega el servidor MCP al conectarse y fundaia guide en la terminal, sin red.

Tres formas de actuar

MCP: https://infrastructure.fundaia.com/api/infra/mcp con Authorization: Bearer fdi_…. Una herramienta por capacidad y nada que instalar. Es el camino más corto.
CLI: cargo install fundaia, luego fundaia guide y fundaia schema --json, que describe cada comando y si lee, escribe, arranca o destruye algo. Todo comando acepta --json.
API HTTP: las mismas operaciones, con sus convenciones.

Una página en markdown

Cualquier página de esta documentación se sirve en markdown de dos formas:

GET /docs/deployments.md

GET /docs/deployments
Accept: text/markdown

La segunda usa la misma dirección que abre una persona: sin la cabecera devuelve la aplicación, y con ella, markdown. Un enlace copiado de una conversación funciona en los dos sitios.

Lo que evita la mayoría de errores

Para que un servicio alcance a otro, usa una conexión (connect_services, fundaia connect), no copies valores: escribe referencias como ${{ Postgres.DATABASE_URL }}.
Crear un servicio ya lo despliega; no encadenes un despliegue detrás.
Un despliegue es asíncrono en la API; deploy_service y fundaia deploy esperan por ti.
Cuando algo falla, el despliegue dice la etapa en la que se paró: es mejor punto de partida que los registros. Ver Despliegues.