Claves de API, la API de Craftkite y MCP

La API de Craftkite permite que tu propio código haga lo que haces en el estudio: crear apps a partir de una descripción, enviar mensajes, aprobar planes, seguir la compilación, abrir la vista previa, publicar, exportar el código, buscar problemas de seguridad y crear documentos. El servidor MCP ofrece las mismas acciones como herramientas, así que un asistente de IA compatible con MCP puede usar Craftkite por ti.

Crea una clave

1. Abre Cuenta y ve a API y MCP.
2. Haz clic en Crear clave, ponle un Nombre (por ejemplo, “canal de compilación”) y elige sus Permisos:
   • Leer proyectos: listar proyectos, tareas, vistas previas, publicaciones y análisis de seguridad.
   • Crear y cambiar: crear apps, enviar mensajes y aprobar planes (usa créditos).
   • Publicar, Exportar código y Documentos.
3. Elige cuándo Caduca y, si eres propietario o administrador de un espacio de trabajo de equipo, si es Para tus proyectos personales o los del espacio.
4. Copia la clave. Solo se muestra una vez; Craftkite guarda solo una huella de ella.

Revoca una clave cuando quieras con el icono de la papelera: las herramientas que la usan dejan de funcionar al momento. Las claves de API vienen con los planes de pago.

Usa la API REST

Envía la clave en la cabecera Authorization como token Bearer. La dirección de la API REST y la descripción OpenAPI aparecen en API y MCP. Un flujo típico:

1. POST /projects con un prompt crea la app; la respuesta incluye su primera tarea.
2. GET /tasks/{id} (o los eventos en vivo en /tasks/{id}/events) hasta que el estado sea awaiting_approval; la tarea muestra el plan y su presupuesto en créditos.
3. POST /tasks/{id}/approve la construye. POST /projects/{id}/preview devuelve la dirección de la vista previa.
4. POST /projects/{id}/deployments la publica. Si el análisis de seguridad encuentra un problema crítico, la respuesta es security-critical; vuelve a publicar con confirmSecurity: true para continuar.

Conecta un asistente de IA (MCP)

Añade la dirección del Servidor MCP a cualquier cliente MCP que admita servidores remotos (HTTP) y envía tu clave como token Bearer. El asistente ve herramientas como create_project, send_message, wait_for_task, approve_plan, get_preview_url y publish_project, limitadas a los permisos de tu clave.

Créditos y límites

Todo lo que inicia una clave usa tus créditos y los límites de tu plan, igual que en el estudio: cada compilación muestra primero su presupuesto y nunca cuesta más que el presupuesto que apruebas. Leer, las vistas previas, los análisis de seguridad y las exportaciones son gratis. Las claves tienen sus propios límites de solicitudes; si envías demasiadas, la respuesta indica cuántos segundos esperar.