QuickFigen desde tu plataforma o desde un agente

Se crea en Configuración → API y MCP, con un nombre que diga dónde se usará (hasta 3 llaves activas por cuenta). La llave entera se muestra una sola vez; después solo se ve su comienzo para reconocerla. Si se filtra, revócala y crea otra: deja de funcionar en la llamada siguiente.

Va en el servidor de tu plataforma, nunca en el navegador: la API no habilita CORS, así que una página de otro sitio no puede leer sus respuestas, justamente para que nadie deje la llave expuesta en el código de una página.

Por ahora la API está en piloto cerrado. Para pedir acceso, escribe a soporte@quickfigen.com.

La llave va en Authorization: Bearer qf_… (o en X-API-Key). El cuerpo es JSON:

Por ejemplo, la mediatriz de dos puntos, guardada como archivo:

curl -X POST https://www.quickfigen.com/api/v1/figure \
  -H "Authorization: Bearer qf_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"domain": "geometry", "script": "A = point(0, 0)\nB = point(4, 0)\nm = perpendicular_bisector(A, B)", "width": 480, "format": "svg"}' \
  -o figura.svg

Con "format": "json" la respuesta trae, además del SVG, lo que el script declaró y, en notes, lo que se dibujó con salvedades (por ejemplo, una regla de /qf-style que esa figura no puede aplicar, o en física una force() hacia abajo sobre un cuerpo que ya muestra su peso en el DCL):

{
  "ok": true,
  "domain": "geometry",
  "dslVersion": 1,
  "width": 480,
  "height": 472,
  "declared": ["A", "B", "m"],
  "notes": [],
  "fingerprint": "6b598355ad37a44e",
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" …"
}

La fingerprint identifica el pedido (gramática, script, tamaño y animación): el mismo pedido produce la misma figura, así que sirve como clave de caché de tu lado.

El servidor MCP vive en https://www.quickfigen.com/api/mcp (Streamable HTTP, sin sesiones) y pide la misma llave en el encabezado Authorization. En Claude Code se agrega así:

claude mcp add --transport http quickfigen https://www.quickfigen.com/api/mcp --header "Authorization: Bearer qf_TU_LLAVE"

Ofrece tres herramientas de solo lectura:

Con viewLink: true, qf_explain devuelve además viewUrl: un link de solo lectura, firmado, que vence a los 7 días. Cualquier persona con el link puede ver la explicación, sin cuenta, hasta que vence. Sin viewLink no se genera ningún link. Lo mismo con qf_booklet, que da un link por versión: el de la versión profesor muestra la clave a quien lo tenga.

Conectarse y listar herramientas no gasta cuota; cada dibujo, explicación o boletín, sí. Si la cuota se agota, el dibujo responde con un error que dice cuándo se renueva, para que el agente pueda explicárselo a la persona.

En claude.ai, al añadir un conector personalizado con su URL, se elige la autenticación «Sin inicio de sesión» y, en «Encabezados de solicitud», el encabezado authorization con el valor Bearer qf_TU_LLAVE (con la palabra Bearer y el espacio). El aviso de que el servidor parece pedir inicio de sesión se puede ignorar: la llave va en el encabezado. Según la documentación de Anthropic, esa sección está en beta para un grupo limitado de organizaciones; si no aparece, por ahora usa Claude Code.

Sirve en cualquier cliente MCP que permita configurar encabezados HTTP propios.

Cuentan también las llamadas que fallan: lo que se protege es el tiempo de cálculo. Al pasar un límite la API responde 429 con Retry-After. Si tu plataforma necesita más, escríbenos.

Un rechazo viene clasificado en kind, con un hint que dice qué hacer. Está pensado para que un agente reintente bien, o diga honestamente que no se puede:

{
  "ok": false,
  "kind": "other_grammar",
  "message": "Línea 1: Constructor desconocido: «block». …",
  "hint": "«block» no es de la gramática de geometría; existe en física (domain=\"physics\"). Reenvía el script con ese dominio; un mismo script no mezcla gramáticas.",
  "unsupported": [],
  "suggestedDomains": ["physics"]
}

Y los de la llave, en error: