Si quieres conectar componentes de 21st.dev a un editor de código con IA, usa el nuevo 21st MCP, no una configuración nueva e independiente de Magic MCP. Crea una clave de API nueva en 21st.dev/mcp, instala el servidor para tu editor y confirma que el editor muestre las herramientas actuales de 21st antes de usarlo en un proyecto de cliente.

Las cuentas gratuitas pueden buscar en la biblioteca y recuperar dos componentes al día entre la web, MCP y CLI. Los planes Builder de pago quitan ese límite de recuperación, mientras que la generación con IA alojada requiere un plan con IA habilitada y créditos.

Puntos clave

  • Usa el 21st MCP unificado y la 21st CLI para las instalaciones nuevas.
  • Crea una clave de API nueva en 21st.dev/mcp; las claves de Magic retiradas ya no funcionan.
  • Claude Code y Cursor tienen flujos de configuración propios. Windsurf y VS Code pueden usar el endpoint HTTP en streaming (streamable HTTP).
  • Las cuentas gratuitas reciben dos recuperaciones de código de componentes al día entre web, MCP y CLI.
  • La generación con IA usa créditos, y la pista de precio junto con el registro de uso muestran cuánto cuesta cada generación.
  • Trata 21st MCP como un servicio de interfaz alojado, no como hosting web, correo electrónico, software de seguridad ni herramienta SEO.

¿Qué hace 21st MCP y quién lo necesita?

Si estás construyendo un sitio web en React, Tailwind u otra base de front-end compatible, 21st MCP conecta tu editor de código con IA con la biblioteca de componentes de 21st.dev. Puedes pedirle al editor que busque un componente o un tema, recupere el código de un componente, encuentre un logotipo, consulte ideas de diseño o genere interfaz con la IA alojada de 21st cuando tu cuenta tenga acceso a IA.

Manos escribiendo en una laptop sobre una mesa de cafetería, junto a una libreta con bocetos de cajas

La ventaja práctica es que puedes mantener la solicitud dentro de Claude Code, Cursor, Windsurf o VS Code. Por ejemplo, puedes pedirle al editor que busque una tabla de precios adaptable que siga tus tokens de Tailwind existentes, y luego recuperar el código y adaptarlo a tu proyecto. Los nombres de herramientas preferidos actualmente son search, get_component, generate, get_inspiration y search_logo.

El nombre puede causar confusión porque Magic MCP fue el nombre y el paquete anterior. 21st.dev ahora describe el servicio como 21st MCP unificado. Las configuraciones existentes de @21st-dev/magic siguen funcionando a través de un proxy de compatibilidad, pero las instalaciones nuevas deben usar la 21st CLI.

Esto es útil para un freelancer, un dueño de pequeño negocio o un desarrollador que quiere tener código de componentes disponible en un editor con IA. No reemplaza a un proveedor de hosting web como Hostinger, a una instalación de WordPress, a un registrador de dominios, al correo electrónico alojado, al software de seguridad ni a una herramienta SEO. Ayuda a producir o recuperar código de interfaz, mientras que el hosting, el dominio, el correo, las copias de seguridad y la configuración de búsqueda, que van por separado, siguen gestionando el sitio en vivo.

Para una evaluación más amplia de la biblioteca de componentes y sus límites, usa la reseña de 21st.dev. Si tu decisión inmediata es si el límite gratuito justifica pagar, continúa a la sección de precios y luego a la comparativa de precios de 21st.dev.

¿Cómo pasas de Magic MCP al 21st MCP actual?

Si ya tienes Magic MCP configurado, primero anota el nombre actual del servidor, el archivo de configuración, el editor y el proyecto que lo usa. No canceles un plan de pago ni elimines una configuración que funcione antes de que el servidor nuevo se haya conectado y haya devuelto las herramientas que necesitas.

El cambio principal es la autenticación. Las claves de API de Magic retiradas se restablecieron y ya no funcionan. Crea una clave nueva en 21st.dev/mcp, cópiala en la nueva configuración y manténla privada. Una clave de API es la credencial que usa el servidor alojado para identificar tu cuenta, así que no la subas a un repositorio ni la pegues en código visible para el cliente.

Las instalaciones nuevas usan la 21st CLI:

npx @21st-dev/cli@latest init --client claude
npx @21st-dev/cli@latest init --client cursor
npx @21st-dev/cli@latest init --client windsurf
npx @21st-dev/cli@latest init --client vscode

Elige el cliente que corresponda al editor que usas. La CLI escribe la configuración correspondiente a ese editor. Cuando termine, reinicia o actualiza el editor y revisa si el servidor de 21st aparece en su lista de MCP. Una conexión correcta debe mostrar herramientas como search y get_component. La herramienta generate puede no aparecer si tu cuenta tiene acceso a componentes pero no a la IA alojada de 21st.

Si la configuración nueva funciona, haz una búsqueda pequeña y recupera un componente en un proyecto no crítico. Comprueba que el código devuelto corresponda a la biblioteca esperada y que tu editor pueda usarlo. Conserva la configuración anterior hasta que esta comprobación pase. Después puedes dejar de usar la entrada antigua de Magic, pero guarda una copia de sus ajustes por si otro proyecto todavía depende de ella.

El paquete anterior sigue disponible para los clientes que solo admiten entrada y salida estándar, conocida como stdio:

{
  "mcpServers": {
    "21st": {
      "command": "npx",
      "args": ["-y", "@21st-dev/magic@latest"],
      "env": {
        "API_KEY_21ST": "YOUR_21ST_API_KEY"
      }
    }
  }
}

Usa esta ruta de compatibilidad solo cuando el editor no pueda conectarse al servidor HTTP alojado. El servidor unificado es la vía preferida para una configuración nueva, y reduce la probabilidad de que un cliente antiguo muestre nombres de herramientas retirados o respuestas mal formadas.

¿Cómo conectas Claude Code, Cursor, Windsurf y VS Code?

Elige primero un editor, crea la clave nueva y agrega un solo servidor 21st con nombre. Después de guardar la configuración, verifica el servidor antes de agregarlo a un proyecto de cliente. La configuración varía un poco porque cada editor guarda las conexiones MCP en un lugar distinto.

Un joven en un escritorio con una laptop conectada por cable a un monitor que muestra dos diseños de página

Claude Code

Claude Code tiene un comando de terminal directo para el servidor HTTP alojado:

claude mcp add --transport http 21st https://21st.dev/api/mcp \
  --header "x-api-key: YOUR_21ST_API_KEY"

El endpoint es el servidor 21st MCP alojado. La clave va en el encabezado, no en un prompt ni en un archivo de código.

Verifica la conexión desde la terminal:

claude mcp list
claude mcp get 21st

Dentro de Claude Code, /mcp abre la administración de servidores. Una entrada que funciona debe mostrar el servidor 21st como conectado y dejar disponibles las herramientas actuales. Pide a Claude Code que busque un componente antes de pedirle que genere uno. Así separas los problemas de conexión de los problemas de acceso de la cuenta.

Si Claude Code omite el servidor, confirma que la entrada remota tenga "type": "http" en su configuración JSON. Una URL remota sin el tipo HTTP puede tratarse como una entrada de servidor no válida o incompleta. Si necesitas volver atrás, conserva el archivo que funciona, desactiva solo la nueva entrada de 21st y restaura la configuración anterior después de anotar el error.

Cursor

Cursor permite instalar con un clic desde Customize (personalizar) y luego MCPs (servidores MCP). También acepta una entrada manual en mcp.json:

{
  "mcpServers": {
    "21st": {
      "type": "http",
      "url": "https://21st.dev/api/mcp",
      "headers": {
        "x-api-key": "YOUR_21ST_API_KEY"
      }
    }
  }
}

Cursor pone las herramientas MCP habilitadas a disposición del chat y pide aprobación de forma predeterminada. Después de guardar, actualiza el panel MCP y confirma que el servidor 21st esté habilitado. Pide una búsqueda de componente y luego recupera un componente pequeño. Si la búsqueda funciona pero falta la generación, revisa el acceso a IA de la cuenta en lugar de reconectar una y otra vez.

Los registros MCP de Cursor pueden ayudarte a separar una clave inválida de un problema del servidor o de la red. Guarda la clave fuera de los archivos del proyecto que se comparten con un cliente. Si la entrada falla, copia la configuración a una nota local segura, desactiva la entrada fallida y vuelve a intentar con una clave recién generada.

Windsurf

Windsurf usa los controles MCP de Cascade o su archivo de configuración global:

~/.codeium/windsurf/mcp_config.json

Usa la misma estructura mcpServers y el endpoint HTTP alojado. Guarda el archivo y luego actualiza la barra de herramientas MCP en Windsurf. El servidor debe aparecer como disponible, y Cascade debería poder llamar a search o get_component.

Si el servidor aparece pero no se conecta, revisa la barra de herramientas MCP y los registros. Confirma que el nombre del encabezado sea exactamente x-api-key, que la clave sea nueva y que la URL no se haya copiado con comillas o espacios adicionales. Una búsqueda exitosa es la primera comprobación útil. La recuperación de un componente es la siguiente, y la generación alojada llega después, solo si tu cuenta lo permite.

VS Code

En VS Code, abre Chat, luego Open Customizations (abrir personalizaciones), MCP Servers (servidores MCP) y Add Server (agregar servidor). Selecciona HTTP, escribe el endpoint alojado y agrega el encabezado de autenticación x-api-key. VS Code también admite un archivo .mcp.json nativo con el formato mcpServers.

Después de guardar, vuelve a abrir los controles de servidores MCP y confirma que 21st esté conectado. Pide a VS Code que busque en la biblioteca de 21st e identifique la herramienta devuelta por su nombre. Si muestra nombres antiguos como 21st_magic_component_builder o logo_search, es posible que la capa de compatibilidad esté traduciendo nombres heredados. Los nombres actuales son los preferidos, pero los nombres antiguos siguen traduciéndose por compatibilidad.

En cualquier editor, la secuencia de trabajo es la misma, y así los problemas de conexión se mantienen separados de los problemas de la cuenta. Si una configuración falla, vuelve atrás desactivando solo esa entrada del servidor y conservando el archivo anterior. No elimines una configuración de editor que funcione hasta que el reemplazo haya superado una prueba pequeña en un proyecto.

Revisa una configuración nueva de 21st MCP en orden

Toca un paso para seguir el avance.

  1. Agrega el servidorCrea una clave nueva en 21st.dev/mcp y agrega un solo servidor 21st con nombre en tu editor.
  2. Confirma la conexiónRevisa que el editor muestre el servidor como conectado.
  3. Haz una búsquedaPide una búsqueda de componente antes que cualquier otra cosa.
  4. Recupera un componenteTrae un componente pequeño a un proyecto no crítico.
  5. Prueba la generaciónUsa generate solo si tu cuenta tiene acceso a IA alojada.

¿Qué es gratis, qué usa créditos y qué compra un crédito?

Si solo necesitas encontrar componentes o recuperar código de vez en cuando, prueba la cuenta gratuita antes de pagar. La búsqueda es gratis en todos los planes. Las cuentas gratuitas reciben dos recuperaciones de código de componentes al día entre el sitio de 21st, MCP y CLI, así que usar la misma cuenta en varios lugares no crea una cuota diaria separada para cada uno.

Los planes Builder de pago quitan el límite de recuperación de componentes. La generación con IA alojada es independiente de la recuperación y requiere un plan con IA habilitada. Por eso, una conexión MCP exitosa no demuestra que la generación esté disponible.

Toca una fila para resaltarla o un encabezado de columna para ordenar.

PlanPrecio y período de facturaciónCréditosMonto a pagar según los términos mostrados actualmente
Free$0, de forma continuaSin créditos de IA mensuales$0
Builder$6 al mes, facturado anualmenteNinguno$72 por adelantado al año
Builder + AIDesde $15 al mes, facturado anualmente500, 1,000 o 2,000 al mes$180 por adelantado al año en el nivel de 500 créditos mostrado
Team$7.50 por asiento al mes, facturado anualmenteCréditos de IA opcionales$90 por asiento por adelantado al año

Precios verificados el 18 de noviembre de 2026. Los montos anuales mostrados son los precios recurrentes actuales, pero los términos de 21st indican que los precios y las cuotas futuras pueden cambiar según el plan y se muestran antes de la compra. Los planes se renuevan a la tarifa vigente en ese momento, así que confirma el monto en tu pantalla de facturación antes de que empiece cada nuevo periodo.

Builder + AI agrega créditos mensuales, generación con varios modelos, modelos premium y Design Bug Bot. El saldo de la cuenta se comparte entre la web, MCP y CLI. Los paquetes adicionales dan 100 créditos por $5 y se acumulan después de que se haya usado la cuota mensual. Los créditos mensuales del plan vencen en el reinicio correspondiente, mientras que los paquetes comprados por separado se acumulan hasta que se usan.

Un crédito no equivale a un número fijo de generaciones. 21st dice que el uso de créditos depende del costo real del modelo, así que un borrador más corto cuesta menos que uno más largo. Revisa la pista de precio de la generación antes de empezar y luego el registro de uso. Un prompt que genera tres variantes de encabezado de panel puede consumir una cantidad distinta a la de una solicitud corta de un solo componente.

Antes de pagar, confirma el nivel elegido, el cargo anual completo, la cuota de créditos y los términos de facturación vigentes. Los planes de pago y los paquetes de créditos no son reembolsables, salvo que la ley aplicable o una aprobación por escrito disponga otra cosa. La cancelación detiene las renovaciones futuras y conserva el acceso pagado hasta el final del período de facturación actual, sujeto a los términos de suspensión o terminación.

¿Cuáles son los límites antes de usar 21st MCP en un proyecto de cliente?

Si decides si esto encaja en un flujo de trabajo con clientes, separa la conexión útil de la responsabilidad sobre el sitio final. 21st MCP puede buscar, recuperar y, a veces, generar código de interfaz, pero no es un servicio de hosting ni de despliegue.

Una dueña de tienda compara una maqueta impresa de página con una laptop sobre su mostrador

No ofrece almacenamiento del sitio, cuotas de ancho de banda, asignaciones de inodos, dominios, correo electrónico, copias de seguridad, un acuerdo de nivel de servicio (SLA) de hosting ni una garantía de tiempo de actividad (uptime). Aun así necesitas un servicio de hosting, un dominio, un proveedor de correo, controles de seguridad y un proceso SEO. Un proveedor independiente como WordPress.org puede definir la aplicación, pero eso no convierte a MCP en una plataforma de sitio web en vivo.

El código generado no tiene garantía de estar listo para producción, ni de ser accesible, adaptable, seguro ni compatible con tu proyecto. Revísalo frente al sistema de diseño del cliente, sus dependencias, sus necesidades de licencia, sus formularios, su analítica y su comportamiento adaptable antes de integrarlo.

Los servidores MCP pueden acceder a servicios externos y ejecutar código en tu nombre. Revisa el repositorio, el endpoint, los permisos solicitados y el alcance de la clave de API antes de habilitar el servidor. En un proyecto de cliente, guarda la clave en el proceso aprobado de gestión de secretos, registra qué cuenta es dueña de la suscripción y confirma por separado quién pagará el uso del editor.

La prueba más limpia es un proyecto pequeño que no sea de producción. Busca un componente, recupera su código, revisa los archivos generados y ejecuta las verificaciones normales del proyecto. Mantén una rama o copia en buen estado para poder quitar el componente nuevo sin quitar el resto del trabajo del cliente.

¿Cómo resuelves herramientas faltantes, claves inválidas y conexiones fallidas?

Si falta el servidor, empieza por la clave y la configuración del cliente. Una clave Magic retirada no se autenticará. Crea una clave nueva en 21st.dev/mcp, actualiza el encabezado x-api-key o la variable de entorno, actualiza el editor y vuelve a conectar.

Si Claude Code omite el servidor, confirma que la entrada remota use "type": "http". Revisa claude mcp list y claude mcp get 21st. En Cursor, revisa los MCP Logs (registros MCP). En Windsurf, usa la barra de herramientas MCP y los registros. En VS Code, vuelve a abrir los controles de servidores MCP y confirma que la entrada HTTP esté habilitada.

Si el servidor se conecta pero no muestra generate, es posible que el acceso a componentes esté activo sin acceso a la IA alojada de 21st. Revisa si get_usage.aiGenerationEnabled es true. Si es false, habilita un plan con IA si encaja con tu uso, y luego actualiza la lista de herramientas del editor o vuelve a conectar el servidor.

Una respuesta ai_subscription_required significa que la cuenta no puede hacer esa llamada de generación. Deja de reintentar la misma solicitud hasta que se habilite el acceso a IA. La búsqueda y la recuperación de componentes pueden seguir funcionando sin generación alojada, sujetas al límite gratuito de recuperación o a la cuota del plan.

Si ves respuestas mal formadas o nombres de herramientas desactualizados, pasa al 21st MCP unificado con una clave nueva. Los clientes que solo admiten stdio pueden usar el paquete de compatibilidad. Conserva la configuración anterior antes de cambiarla y desactiva la entrada fallida solo después de que el reemplazo haya superado una prueba de búsqueda y recuperación.

¿Qué paso sigue según tu decisión de precios o de producto?

Si solo necesitas código de componentes de vez en cuando, quédate en Free y lleva la cuenta de las dos recuperaciones diarias en todos los puntos de acceso de 21st. Revisa el registro de uso después de cada recuperación para saber si el límite compartido se ajusta a tu trabajo normal.

Una persona planifica el mes en un escritorio con un calendario de pared, un teléfono y una laptop

Si necesitas recuperación regular pero no IA alojada, Builder es la opción más clara, con $72 por adelantado al año, facturado anualmente a $6 al mes. Confirma el monto de renovación y las cuotas vigentes al momento de pagar, porque los precios futuros no están fijados por la cifra que se muestra hoy. Precios verificados el 18 de noviembre de 2026.

Si necesitas generación alojada, compara el compromiso anual mostrado de Builder + AI y su nivel de créditos con los prompts que esperas usar. Revisa la pista de precio antes de cada generación y compárala con el registro de uso. Un paquete de créditos puede ayudar después de la cuota mensual, pero su precio de $5 cubre 100 créditos y no convierte la generación en ilimitada.

Si varias personas necesitan acceso, revisa los precios por asiento de Team y los créditos de IA opcionales. Confirma la cantidad de asientos, el cargo anual total y los cargos separados de plan y de uso de cada editor antes de suscribirte. La suscripción de 21st no paga el uso de Claude Code, Cursor, Windsurf ni VS Code.

Antes de pagar o de conectar 21st a un flujo de trabajo de cliente, revisa los términos de compra y la configuración de facturación vigente. Trata los planes de pago y los paquetes de créditos como no reembolsables, salvo que la ley aplicable o una aprobación por escrito digan otra cosa. Si la disponibilidad importa para una fecha límite, revisa el estado actual de 21st y sus canales de soporte, porque MCP es un servicio alojado que depende de otros servicios.

Para una decisión de producto más amplia después de la configuración, compara la reseña de 21st.dev. Si la pregunta principal es el costo, los créditos y el compromiso anual, usa la guía de precios de 21st.dev.

Comprueba lo que aprendiste

Elige una respuesta para comprobarla.

1. ¿Dónde creas la clave de API del 21st MCP actual?

Ver la respuesta

En 21st.dev/mcp. Las claves de Magic retiradas se restablecieron y ya no funcionan, así que crea una clave nueva en 21st.dev/mcp.

2. Una cuenta gratuita está conectada al servidor de 21st. ¿Qué puede hacer?

Ver la respuesta

Buscar en la biblioteca y recuperar dos componentes al día. Las dos recuperaciones diarias se comparten entre la web, MCP y CLI, y la generación alojada requiere un plan con IA habilitada.

3. Tu editor se conecta, pero no muestra ninguna herramienta generate. ¿Qué debes revisar primero?

Ver la respuesta

Si get_usage.aiGenerationEnabled es true. La cuenta puede tener acceso a componentes sin tener acceso a la IA alojada de 21st.

Preguntas frecuentes

Las respuestas siguientes cubren las preguntas de configuración y facturación que suelen aparecer después de la primera conexión.

¿Sigue disponible 21st.dev Magic MCP?

Magic MCP ahora se llama 21st MCP, y las instalaciones nuevas deben usar la 21st CLI unificada. Las configuraciones existentes de @21st-dev/magic siguen funcionando con un proxy de compatibilidad para los clientes que necesitan stdio.

¿Dónde creas una clave de API de 21st MCP?

Crea una clave nueva en 21st.dev/mcp. Las claves de Magic retiradas se restablecieron, así que una clave anterior no se autenticará con el servidor actual.

¿Puedes usar 21st MCP gratis?

Sí. Las cuentas gratuitas pueden buscar en la biblioteca de componentes y recuperar dos componentes al día entre la web, MCP y CLI. La generación con IA alojada requiere un plan con IA habilitada.

¿Buscar usa un crédito de IA?

La búsqueda y la recuperación de componentes son independientes de la generación con IA alojada. No toda llamada MCP consume un crédito de IA, pero la recuperación sigue contando para el límite diario de componentes de la cuenta gratuita.

¿Por qué el editor se conecta pero no muestra una herramienta de generación?

Es posible que la cuenta tenga acceso a componentes sin acceso a la IA alojada de 21st. Revisa si get_usage.aiGenerationEnabled es true, luego habilita un plan con IA y actualiza la lista de herramientas MCP del editor.

¿Puede Cursor instalar 21st MCP sin un comando de terminal?

Sí. Cursor permite instalar con un clic desde Customize (personalizar) y luego MCPs (servidores MCP). También admite una entrada manual en mcp.json con el endpoint HTTP alojado y el encabezado x-api-key.

¿Qué editor necesita el proxy de compatibilidad?

Los clientes que solo admiten stdio pueden usar el paquete anterior @21st-dev/magic como ruta de compatibilidad. Claude Code, Cursor, Windsurf y VS Code tienen rutas de configuración para el servidor HTTP alojado actual.

¿Se acumulan los créditos de 21st?

Los créditos mensuales del plan vencen en el reinicio correspondiente. Los paquetes de créditos comprados por separado se acumulan hasta que se usan, no tienen valor en efectivo, no se pueden transferir y no son reembolsables, salvo cuando lo exija la ley.

¿Cancelar un plan de pago quita el acceso de inmediato?

La cancelación detiene las renovaciones futuras y normalmente conserva el acceso pagado hasta el final del período de facturación actual. Los términos permiten suspender o terminar el acceso en algunas circunstancias, así que revisa la configuración de facturación vigente antes de cancelar.

¿Es 21st MCP un servicio de hosting web?

No. Conecta un editor con componentes de interfaz y funciones de IA alojada. No ofrece almacenamiento de sitio web, dominios, correo electrónico, copias de seguridad, despliegue ni garantía de tiempo de actividad (uptime).

El siguiente paso práctico es crear la clave nueva, instalar el servidor para un editor y confirmar search y get_component en un proyecto pequeño. Cuando eso funcione, compara el límite gratuito con tu uso real antes de elegir un plan anual o un paquete de créditos.

Glosario

Toca un término para ver qué significa.

Servidor MCP
Servicio que conecta un editor de código con IA con herramientas externas, aquí la biblioteca de componentes de 21st.
Clave de API
La credencial que identifica tu cuenta ante el servidor alojado. Manténla fuera de los repositorios.
stdio
Entrada y salida estándar, el tipo de conexión que usa el paquete de compatibilidad anterior.
Proxy de compatibilidad
La ruta que mantiene funcionando las configuraciones existentes de @21st-dev/magic.
Recuperación de componentes
Traer el código de un componente a tu proyecto. Las cuentas gratuitas reciben dos al día.
Generación con IA alojada
Interfaz generada por la IA de 21st, que requiere un plan con IA habilitada y créditos.
Crédito
Una unidad de uso de IA. Su costo depende del costo real del modelo, no de un número fijo de generaciones.
Pista de precio
La estimación de costo que se muestra antes de que empiece una generación.

Encuentra más reseñas y guías en Even Reviews. ¿Viste algo que corregir? Escríbenos e incluye el título de la página.