TRMNL

Ejecuta tus pantallas ePaper TRMNL desde cualquier agente de IA: revisa tus dispositivos, planifica listas de reproducción y crea nuevas pantallas con tus propios datos.

Ver en trmnl.com

Servidor MCP alojado

npx add-mcp 'https://trmnl.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Saltar al contenido principal

Servidor MCP

Conecta Claude, ChatGPT, Cursor y otros agentes de IA a tu cuenta de TRMNL.

Escrito por Ryan Kulp

Actualizado esta semana

Tabla de contenidos

Conecta tu propio agente de IA a TRMNL. Claude, ChatGPT, Cursor y otros clientes MCP pueden leer y cambiar tus dispositivos, listas de reproducción y plugins, o editar el markup de un plugin privado, desde donde ya trabajas.

Esto es diferente del Agente de IA dentro de TRMNL, que construye plugins en tu navegador. El servidor MCP permite que un agente que traigas tú haga el mismo trabajo, y más, desde fuera del panel de control.

Hay dos formas de entrar. Si no estás seguro, conecta tu cuenta. Puedes limitarlo a un solo plugin al iniciar sesión.

Cuenta completa. Inicia sesión con tu cuenta de TRMNL, sin necesidad de clave. El agente accede a lo que permitas al iniciar sesión.
Un solo plugin. Una clave API MCP desde la configuración de un plugin privado. El agente accede solo al markup de ese plugin y nada más. Úsalo para un cliente que no pueda iniciar sesión, o para entregar un plugin a otra persona.

Requisitos previos

Una cuenta de TRMNL
Un cliente MCP, como Claude Code, Claude (web o escritorio), ChatGPT en un plan de pago, Cursor o Codex

Paso 1 - Añade el servidor a tu agente

El servidor está en https://trmnl.com/mcp. La forma de añadirlo depende del cliente.

Claude Code

Instala el plugin de TRMNL. Añade el servidor y la habilidad de agente TRMNL, que enseña a Claude las reglas del framework para el markup:

/plugin marketplace add usetrmnl/trmnl-agent-skills
/plugin install trmnl@trmnl-agent-skills

¿Prefieres el servidor por sí solo? Ejecuta claude mcp add --transport http trmnl https://trmnl.com/mcp en su lugar. Eso lo registra solo para la carpeta actual. Añade --scope user para usarlo en todas partes. La aplicación de escritorio de Claude Code lee la misma configuración.

Claude en la web y escritorio

TRMNL está en el directorio de Claude: ábrelo y elige Conectar.

O ve a Personalizar, luego Conectores, y elige Añadir conector personalizado. Pega https://trmnl.com/mcp y añádelo. En un plan de Team o Enterprise, un Propietario lo añade una vez en Configuración de organización, luego Conectores.

ChatGPT

Los conectores personalizados necesitan un plan de pago y el modo desarrollador. Abre Configuración, luego Apps y Conectores, luego Configuración avanzada, y activa el modo desarrollador. De vuelta en Apps y Conectores, elige Crear, pega https://trmnl.com/mcp y selecciona OAuth.

Cursor

La forma más rápida es un clic: Añadir TRMNL a Cursor. Cursor se abre, te pide confirmar, y te inicia sesión en TRMNL la primera vez que usa una herramienta.

O añade esto a ~/.cursor/mcp.json, y reinicia Cursor: {"mcpServers": {"trmnl": {"url": " https://trmnl.com/mcp"}}}

Otros agentes

En VS Code, un clic lo hace: Añadir TRMNL a VS Code. VS Code te pide confirmar, y luego te inicia sesión en TRMNL la primera vez que Copilot usa una herramienta.

En Gemini CLI, ejecuta gemini extensions install https://github.com/usetrmnl/trmnl-agent-skills. Añade el servidor y la habilidad de agente TRMNL.

Codex y la mayoría de otros clientes aceptan https://trmnl.com/mcp como servidor HTTP, o HTTP transmisible. El cliente debe soportar el inicio de sesión MCP. TRMNL también está listado en el Registro MCP oficial como com.trmnl/trmnl.

Dónde está listado TRMNL

También puedes encontrar el servidor TRMNL en estos directorios:

Paso 2 - Inicia sesión y elige qué puede hacer

La primera vez que el agente se conecta, TRMNL se abre en tu navegador y pregunta qué puede hacer. En Claude Code, ejecuta /mcp en una sesión y elige trmnl para iniciar esto. La pestaña del navegador puede quedar en blanco después. Eso es normal, el agente ya tiene lo que necesita.

Marcas lo que el agente puede hacer:

Leer tus dispositivos y sus registros, listas de reproducción, configuraciones de plugins y archivos de plugins privados
Contenido, para cambiar tu markup, configuraciones de plugins, listas de reproducción y mashups, instalar recetas y enviar imágenes
Dispositivos, para cambiar la configuración de tus dispositivos e identificar un dispositivo
Eliminar configuraciones de plugins y elementos de listas de reproducción, y limpiar la lista de reproducción de un dispositivo
Perfil, para ver tu información de perfil
Apps, para instalar aplicaciones y gestionarlas, incluyendo envíos a flotas y reservas de salas

Eliminar, Perfil y Apps comienzan sin marcar, así que un agente no puede eliminar nada a menos que lo digas. También puedes limitar el agente a algunos de tus dispositivos y configuraciones de plugins.

Paso 3 - ¡Listo!

Pide algo al agente. "Lista mis dispositivos." "¿Qué hay en la lista de reproducción de la pantalla de la cocina?" "Muestra mi calendario entre semana de 9 a 5 y Reddit por las noches."

Las herramientas TRMNL del agente vienen en pares, una que solo lee y otra que hace cambios. La mayoría de los clientes ejecutan las lecturas sin preguntar y consultan contigo antes de un cambio.

Para ver lo que has conectado, ve a Cuenta, luego Desarrollador, luego Agentes conectados. Cada agente muestra cuándo estuvo activo por última vez. Editar acceso cambia qué dispositivos y configuraciones de plugins alcanza, y Revocar lo desconecta de inmediato. Para cambiar lo que puede hacer, revócalo y conéctalo de nuevo. Una conexión sin uso durante 30 días se desconecta sola, y tu herramienta te pedirá iniciar sesión de nuevo la próxima vez.

Un plugin con una clave API MCP

Una clave alcanza un plugin privado: su markup, capturas de pantalla, variables de fusión, registros y actualizaciones de datos, además de la búsqueda de recetas y la guía del sistema de diseño. No puede ver tus dispositivos, listas de reproducción u otros plugins.

Abre la configuración de un plugin privado y haz clic en Guardar una vez si es nuevo. Encuentra Clave API MCP y elige Generar clave MCP. La clave comienza con ps_mcp_.
En Claude Code, ejecuta claude mcp add --transport http trmnl https://trmnl.com/mcp --header "Authorization: Bearer YOUR_KEY"
En otros clientes, usa https://trmnl.com/mcp?api_key=YOUR_KEY como dirección del servidor. La configuración del cliente MCP, bajo la clave, tiene un fragmento listo.

Las claves solo se ofrecen en plugins privados, y no en una copia de solo lectura de la receta de otra persona. Trata la clave como una contraseña. Revocar clave en la misma página corta el acceso al agente, y puedes generar una nueva.

Habilidades del agente

Las habilidades del agente TRMNL son las mismas reglas que sigue nuestro propio Agente de IA: el framework, Liquid, y lo que funciona en una pantalla ePaper. Funcionan sin el servidor MCP también, así que un agente puede escribir buen markup en tu máquina y tú lo pegas. Están empaquetadas para Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot y opencode.

Límites

Cada conexión puede enviar 60 solicitudes por minuto.
Un cambio que renderiza una pantalla, como una vista previa o una actualización, consume de la asignación horaria de renders de tu cuenta. El panel de control comparte la misma asignación.
Cada acción es una operación de la API de TRMNL. La referencia de autenticación cubre claves, OAuth y alcances en detalle.

Solución de problemas

El cliente dice "Necesita autenticación"
El servidor está añadido pero aún no has iniciado sesión. En Claude Code, ejecuta /mcp y elige trmnl. Otros clientes muestran un botón de Conectar.

Una acción responde 403 y nombra una capacidad.
No la marcaste al iniciar sesión. Revoca el agente en Agentes conectados y conéctalo de nuevo, marcando lo que necesita.

Una acción responde 403 y nombra un dispositivo o configuración de plugin.
Limitaste el agente. Amplíalo con Editar acceso en Agentes conectados.

El agente dice que la cuenta ha usado sus renders de la hora.
La asignación horaria de renders está agotada. Espera a que pase la hora, y luego intenta de nuevo. Reintentar antes no ayuda.

El servidor responde 401 con tu clave API de cuenta.
La clave API de cuenta de Cuenta, luego Desarrollador, es para la API REST y no funciona con el servidor MCP. Inicia sesión, o usa la Clave API MCP de un plugin.

El agente no puede ver tus dispositivos.
Está conectado con una clave de plugin, que alcanza solo un plugin. Conéctalo a la cuenta completa en su lugar.

Los campos de contraseña vuelven vacíos.
Eso es a propósito. El servidor nunca entrega secretos como contraseñas o claves API a un agente.

ChatGPT inicia sesión pero el conector falla después.
Esto se corrigió el 2 de octubre de 2026. Elimina el conector y créalo de nuevo.

Relacionado

Agente de IA, el constructor de plugins de TRMNL en el navegador
Plugins privados y Recetas de plugins
Apps de desarrollador, para construir tu propia app en la API de TRMNL
Claves API a nivel de usuario
Sincronización con GitHub
Programador de listas de reproducción

¿Te fue útil esta respuesta?

Reacción decepcionada😞Reacción neutral😐Reacción sonriente😃

Tabla de contenidos

{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://help.trmnl.com/en/","name":"All Collections","position":1},{"@type":"ListItem","item":"https://help.trmnl.com/en/collections/13694912-advanced","name":"Advanced","position":2},{"@type":"ListItem","name":"MCP Server","position":3}]}
{"@context":"https://schema.org","@type":"Article","description":"Connect Claude, ChatGPT, Cursor and other AI agents to your TRMNL account.","headline":"MCP Server","inLanguage":"en","publisher":{"@type":"Organization","name":"TRMNL Help Center"},"url":"https://help.trmnl.com/en/articles/17432548-mcp-server","author":{"@type":"Person","name":"Ryan Kulp"},"dateModified":"2026-10-09T18:09:33Z"}