Instala la CLI y las habilidades de agente

La CLI crafty crea sitios a partir de una plantilla inicial, despliega las compilaciones en Crafty Hosting y genera tipos de TypeScript. También instala las habilidades de agente de Crafty: instrucciones que enseñan a un agente de IA (Claude Code, Claude.ai, Claude Desktop u otro agente que lea habilidades) a modelar contenido, construir un frontend con el SDK y desplegarlo.

Instala la CLI

La CLI necesita Node.js 20 o posterior.

npm i -g @craftware/crafty-cli
crafty --version

Sin una instalación global, ejecuta cualquier comando con npx:

npx @craftware/crafty-cli <command>

Luego inicia sesión en tu tenant. El tenant se toma de CRAFTY_API_URL en el .env del proyecto; fuera de un proyecto, pásalo con --host:

crafty login                                  # dentro de un proyecto con CRAFTY_API_URL
crafty login --host=https://your-tenant.crafty.do

crafty login abre el navegador para aprobar la CLI y guarda una sesión por tenant en ~/.crafty/credentials. Para empezar un sitio nuevo, npm create crafty@latest hace en un solo paso la instalación, el inicio de sesión y el sitio (consulta Plantillas y despliegue).

Las habilidades de agente

Habilidad	Qué enseña
`crafty-cms`	Modelado de contenido mediante MCP, el SDK de JavaScript, el editor visual y las migraciones de sitios.
`crafty-deploy`	Plantillas, `crafty.json`, despliegues desde una laptop o CI, y dominios personalizados.

Instálalas con la CLI

crafty skills list                       # las habilidades que incluye esta versión de la CLI
crafty skills install                    # todas las habilidades, en .claude/skills/ del proyecto
crafty skills install crafty-cms         # solo las habilidades indicadas
crafty skills install --global           # en ~/.claude/skills/ (todos los proyectos)
crafty skills install --dir=.agents/skills   # en la carpeta de habilidades de otro agente

Sin instalar la CLI: npx @craftware/crafty-cli skills install. Si tu CLI instalada no reconoce crafty skills, actualízala con crafty update.

Una habilidad copiada en un proyecto no se actualiza sola. Ejecuta crafty skills install de nuevo después de actualizar la CLI para reemplazarla por la versión actual.

Descárgalas para Claude.ai o Claude Desktop

Cada habilidad también se publica como un zip con su carpeta y su SKILL.md:

Para añadir una en Claude.ai o Claude Desktop:

Descarga el zip. No lo descomprimas.
Abre Settings → Capabilities y comprueba que la ejecución de código esté activada; las habilidades la necesitan.
En Skills, elige Upload skill y selecciona el zip.
Activa la habilidad. Claude la usa cuando una conversación trata sobre Crafty.

Los zips se reconstruyen en cada despliegue de la documentación, así que una descarga siempre es la versión más reciente. Súbelo de nuevo para actualizar la copia en Claude.

Conecta también el servidor MCP

Las habilidades explican el flujo de trabajo; las acciones en sí pasan por el servidor MCP del tenant (https://your-tenant.crafty.do/mcp). Añádelo como conector en Claude.ai o Claude Desktop, o en Claude Code:

claude mcp add --transport http crafty https://your-tenant.crafty.do/mcp \
  --header "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

Modelado de contenido mediante MCP cubre todos los clientes, tokens y permisos; Primeros pasos cubre el flujo completo.