Saltar al contenido

Buscar en la documentación

Busca componentes y documentación

Nuevo
Menú

Para LLM y agentes

Logic2B UI está diseñado para agentes de IA. Esta es su superficie legible por máquinas.

Todo el sitio está disponible en formatos aptos para máquinas. Si eres un LLM o estás construyendo un agente, usa estos endpoints en vez de extraer HTML.

Endpoints

Endpoint Contenido
/llms.txt Índice de toda la documentación inglesa con URL absolutas
/es/llms.txt Índice de las traducciones españolas
/es/llms-full.txt Toda la documentación española disponible en un Markdown
/es/docs/<page>.md Cualquier página española como Markdown plano
/r/index.json Índice del registro con cada componente y descripción
/r/<name>.json Payload completo: metadatos, código, API y contrato de accesibilidad
/r/versions.json Índice de versiones exactas, fechas y canales
/r/versions/<version>.json Manifiesto inmutable con URL de contenido e integridad SHA-256
/r/changelog/<name>.json Historial de versiones legible por máquinas
/tokens/default/manifest.json Manifiesto SHA-256 de los tokens portables
/mcp Endpoint MCP remoto mediante HTTP streamable

Instalar componentes programáticamente

El registro usa un esquema JSON abierto. Cada elemento contiene dependencies (npm), registryDependencies (otros elementos) y files[].content (el código TypeScript completo):

curl https://ui.logic2b.com/r/button.json

Cada payload registry:ui también publica api, generado desde sus exports de TypeScript, y accessibility: modelo de soporte, semántica/ARIA, interacción de teclado, responsabilidades del consumidor y limitaciones conocidas. Un agente debe preservar esos requisitos al componer o modificar un componente.

Para instalar en el proyecto del usuario, ejecuta la CLI:

npx logic2b@next add button

O resuelve una versión mediante /r/versions.json, descarga el payload direccionado por contenido del manifiesto inmutable, verifica su SHA-256, escribe files[].content, instala las dependencias y recorre registryDependencies.

Copy Prompt

Cada superficie de instalación —componentes, bloques, gráficos y el estudio /create— ofrece Copy Prompt junto al comando. Copia un encargo autocontenido con la ruta CLI, un fallback contra el JSON del registro, el tema exacto, la tabla de rutas y una lista de verificación. Un agente recibe así el contexto completo sin extraer páginas ni adivinar convenciones.

Servidor MCP

Requisitos del host y versiones beta

Las herramientas MCP devuelven datos y planes. Aplicar un plan requiere un host capaz de escribir archivos; instalar dependencias, compilar y verificar en el navegador requiere un entorno con el gestor de paquetes adecuado. Un chat que solo tiene MCP remoto puede consultar código y solicitar planes, pero no puede completar esos pasos por sí solo. El servidor remoto no accede a tus archivos.

El transporte stdio local requiere Node.js 18+ y npm. Usa @logic2b/mcp@next para la beta y logic2b@next para la CLI. Estos selectores npm son independientes de version del registro. Registra la versión del handshake MCP y --version de la CLI: next puede cambiar. El paquete npm @next resuelve a 1.0.0-rc.3 y coincide con el MCP remoto: resultados estructurados, lecturas verificadas por defecto, límites de entrada y el catálogo completo descrito aquí, incluido list_presets. Las instalaciones antiguas de 1.0.0-rc.2 devuelven JSON como texto y no incluyen esas novedades.

Si omites version, el MCP resuelve el canal next del registro a una versión exacta, verifica el SHA-256 de cada payload y devuelve registryVersion; una verificación fallida es un error, nunca una copia sin verificar. Las entradas están acotadas (32 items por llamada, 1 MB de CSS, cuerpos de 2 MB); los argumentos inválidos son errores JSON-RPC y los fallos de ejecución devuelven isError. /mcp es un endpoint de protocolo: un GET con HTTP 405 es esperado; comprueba la conexión con un cliente MCP, no navegando al endpoint.

El registro expone el Model Context Protocol de dos formas: remoto y stdio local. Para leer: list_components, search_components, get_component, get_demo, list_registry_versions y get_changelog. Las lecturas, instalaciones y operaciones de tema aceptan version como semver exacto, rango o canal, y verifican SHA-256 antes de responder.

Para planificar cambios en un proyecto: install_plan devuelve los archivos y dependencias exactos; scaffold_plan devuelve una app Next.js, Vite o Astro completa desde un starter de marketing, dashboard o auth. get_theme, decode_preset y apply_preset reconstruyen o parchean theme.css; list_presets descubre las mismas configuraciones curadas de /es/themes, con ids canónicos, enlaces al estudio y avisos medidos; contrast_audit comprueba WCAG 2.2 y APCA; lint_theme detecta tokens ausentes, duplicados o inválidos, deriva, contraste y fidelidad exacta a un preset. export_tokens resuelve cualquier preset al paquete global/claro/oscuro que alimenta las salidas CSS, iOS y Android.

Por ejemplo, un agente puede llamar a scaffold_plan con framework: "vite", starter: "dashboard", version: "next" y un preset, escribir los archivos e instalar dependencias. La respuesta conserva la versión exacta en components.json. CI compila ese mismo contrato para Next, Vite y Astro.

Remoto (sin instalar un servidor MCP local) — conecta un cliente MCP HTTP streamable:

https://ui.logic2b.com/mcp

Con Claude Code:

claude mcp add --transport http logic2b https://ui.logic2b.com/mcp

O en un cliente con configuración JSON:

{
  "mcpServers": {
    "logic2b": { "type": "http", "url": "https://ui.logic2b.com/mcp" }
  }
}

Local (stdio) — npx -y @logic2b/mcp@next ejecuta el paquete publicado como proceso local, con las diferencias de versión indicadas arriba.

Convenciones fiables para un agente

  • Cada componente usa cn() desde @/lib/utils.
  • Los colores siempre son tokens (bg-primary), nunca clases de paleta crudas.
  • Las variantes se definen y exportan con class-variance-authority.
  • Cada raíz incluye data-slot para una selección estable.

Inspección de proyectos en el candidato fuente

El candidato fuente añade logic2b inspect --json --details full y la herramienta MCP inspect_project, sin acceso a la red. Comprueba su presencia en --help o tools/list antes de utilizarlas. Inspeccionan configuración y huellas de archivos, identifican alias confirmados y modificaciones locales, y mantienen explícito lo desconocido. El MCP necesita una instantánea aportada por el anfitrión; no puede leer tu disco. Límites: 128 KiB de configuración, 1.000 huellas y rutas relativas de 256 caracteres. Solicita el detalle completo antes de conciliar destinos: los planes de instalación todavía no consumen este contexto automáticamente. Disponible en fuente no significa publicado.

Instrucciones gestionadas para agentes (candidato de código fuente)

El código actual incorpora agent_rules en MCP y rules en CLI. Comprueba su presencia en el catálogo de herramientas o en la ayuda del CLI; este cambio no implica que el paquete npm instalado ya lo incluya.

init, add y update generan o actualizan AGENTS.md y DESIGN.md. La opción --no-agent-rules lo desactiva. rules --format agents,claude,cursor,copilot añade la importación @AGENTS.md para Claude, una regla Cursor y una sección Copilot. El texto externo a los marcadores se conserva. Los marcadores dañados requieren reparación; el instalador informa por separado si fallan las reglas.

Sin terminal, agent_rules devuelve archivos a partir de preset, stack, iconLibrary, formats, registryVersion exacta e items instalados (nombre y, opcionalmente, tipo/categorías). Todos son opcionales. Un inventario omitido es desconocido: el catálogo disponible no prueba una instalación. Combina el bloque gestionado con las instrucciones existentes, sin sustituir el documento completo ni el frontmatter propio de Cursor. Las reglas ocupan hasta 6 KiB; los inventarios grandes indican cuántos nombres se muestran. DESIGN.md es una referencia separada del preset: prevalecen las personalizaciones del CSS real.

scaffold_plan incluye ambos documentos salvo con agentRules: false. El paquete MCP incluye skills/logic2b-ui/SKILL.md, que puedes copiar a la ubicación de skills de tu host; npx no lo instala allí automáticamente. La skill utiliza herramientas disponibles y comprobaciones del proyecto. Revisión, composición y propuestas siguen planificadas. Las reglas no autorizan ejecuciones nuevas ni exigen repetir una aprobación ya concedida por el usuario.