# Lienzo

> El lienzo donde tu IA crea presentaciones y tú das el toque final. Lienzo habla MCP: cualquier IA (Claude Code, Codex, Cursor…) puede crear, editar, organizar, compartir y presentar con las mismas acciones que una persona, y ver su propio resultado para corregirlo.

## 1. Registrar a la persona (sin salir de la conversación)

Pídele su correo y solicita un código. Le llega un correo con 6 cifras; vale 15 minutos.

```sh
curl -s -X POST https://lienzo.cc/api/v1/agent/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"persona@ejemplo.com","client":"claude-code"}'
# → {"requestId":"…","expiresInSeconds":900,…}
```

`client` puede ser `claude-code`, `codex`, `cursor`, `chatgpt`, `gemini` u omitirse. Si el correo no tiene cuenta, se crea al canjear el código (el código prueba que controla el buzón).

## 2. Canjear el código por tu token MCP

Pídele el código que le llegó y envíalo con el `requestId`:

```sh
curl -s -X POST https://lienzo.cc/api/v1/agent/token \
  -H "Content-Type: application/json" \
  -d '{"requestId":"…","code":"482913"}'
# → {"token":"cpk_…","mcpUrl":"https://lienzo.cc/mcp","setup":{"claudeCode":[…],"codex":[…]},…}
```

El token se muestra una sola vez y trabaja sólo en la cuenta de esa persona. Lo puede revocar en https://lienzo.cc/app → Mi cuenta → Conecta tu IA.

## 3. Configurar el MCP

- **Claude Code:** `claude mcp add --transport http lienzo https://lienzo.cc/mcp --header "Authorization: Bearer cpk_…"`. Después, que la persona reinicie con `claude --continue` para cargar las herramientas sin perder la conversación.
- **Codex:** `codex mcp add lienzo --url https://lienzo.cc/mcp --bearer-token-env-var LIENZO_TOKEN` y guarda `export LIENZO_TOKEN=cpk_…` en el perfil de su shell (`~/.zshrc` o `~/.bashrc`). Después, `codex resume --last`. Si tu sandbox no tiene red, pide permiso para usar `curl`.
- **Otros clientes (HTTP):** URL `https://lienzo.cc/mcp`, cabecera `Authorization: Bearer cpk_…`. Protocolo MCP 2025-03-26, 2025-06-18 o 2025-11-25.
- **Sin reiniciar:** el MCP también responde a JSON-RPC por `curl` (`POST https://lienzo.cc/mcp`, `tools/call`).

## 4. Crear

- Empieza por `get_design_guide` y `create_presentation`; compón con `apply_operations` y revisa con `render_canvas` antes de entregar.
- Organiza en espacios, comparte con un enlace de solo lectura (`set_presentation_sharing`) y presenta.
- Las descripciones de las herramientas son la documentación: dicen límites y cómo recuperarte de cada error.

## Errores comunes

- `INVALID_CODE` (422): código incorrecto; quedan pocos intentos.
- `CODE_EXPIRED` / `REQUEST_REPLACED` / `REQUEST_USED` (410): pide un código nuevo con el paso 1.
- `TOO_MANY_REQUESTS` (429): demasiados códigos para ese correo; espera unos minutos.
- `SIGNUPS_CLOSED` (403): por ahora no se admiten cuentas nuevas; las existentes sí conectan.

## Enlaces

- [Lienzo](https://lienzo.cc/): qué es.
- [Crear cuenta o entrar](https://lienzo.cc/app): la web, para retocar a mano.