Skills

Instalación de la habilidad Showly

Agregando la habilidad oficial Showly a Claude Code o Codex.

La habilidad Showly envuelve el servidor MCP con mensajes activados por intención y un modelo de rechazo consciente del bucle de publicación. Esta página explica cómo instalarlo en Claude Code, Codex y cualquier otro agente compatible con MCP.

Cómo funciona la autorización

No pegas un token. El servidor MCP de Showly es un servidor HTTP remoto en https://mcp.showly.ai y utiliza el protocolo de enlace de autorización estándar MCP (OAuth 2.1 + PKCE). La primera vez que su agente llama a una herramienta Showly:

  1. El agente se conecta, obtiene un 401 y descubre automáticamente el servidor de autorización de Showly.
  2. Abre una pestaña del navegador en showly.ai donde inicia sesión y aprueba los ámbitos solicitados.
  3. Showly emite un token breve y de alcance directamente al agente. Nunca lo ves ni lo copias.

Entonces, el único trabajo del instalador es registrar la URL del servidor con su agente. El inicio de sesión se realiza en su navegador la primera vez que lo utiliza.

Requisitos previos

  • Un espacio de trabajo Showly y al menos un sitio conectado.
  • Permiso para aprobar el acceso del agente. El paso de aprobación requiere un rol con al menos site:write (propietario, administrador, desarrollador o miembro). La aprobación desde una cuenta con menos privilegios generará un token limitado a cualquier ámbito que realmente tenga.

Claude Code

El instalador canónico es el paquete @showly/mcp-server (bin showly-mcp). Ejecútelo con el objetivo claude-code:

npx @showly/mcp-server install --to claude-code

Esto escribe el bloque del servidor Showly MCP en su configuración Claude Code. Sin token, sin comando de inicio de sesión por separado. La próxima vez que invoque una herramienta Showly, el agente ejecuta el inicio de sesión en el navegador descrito anteriormente.

Pruebe la conexión desde el interior Claude Code:

Showly, enumera mis sitios.

La primera llamada abre una pestaña del navegador para aprobar el acceso; Después de aprobar, debería ver sus sitios en la lista, provenientes de mcp__showly__list_sites.

Codex

Utilice el mismo instalador con el objetivo codex. Escribe el servidor Showly en tu ~/.codex/config.toml por ti:

npx @showly/mcp-server install --to codex

Reinicie Codex para seleccionar el nuevo servidor, luego invoque una herramienta Showly para activar el inicio de sesión en el navegador.

Cualquier otro anfitrión MCP

Para inspeccionar la configuración que el instalador escribiría sin aplicarla, seleccione stdout:

npx @showly/mcp-server install --to stdout

Copie el bloque del servidor MCP impreso en la configuración de su host. Cualquier cliente MCP que admita el flujo de autorización estándar (WWW-Authenticate descubrimiento → consentimiento del navegador) se conecta a https://mcp.showly.ai sin ningún token manual. Si la máquina donde corre su agente no tiene navegador, o quien aprueba está en otro sitio, use el inicio de sesión sin interfaz que se describe abajo.

Inicio de sesión sin interfaz (flujo de dispositivo)

Cuando la máquina del agente no tiene navegador (un servidor, un contenedor, CI, una sesión remota) o quien aprueba está con el móvil y no ante esa máquina, ejecute npx @showly/mcp-server login --to claude-code. Imprime la dirección de la página y un código corto, espera mientras usted aprueba desde cualquier dispositivo y escribe la credencial en la configuración de su host cuando lo hace. --to codex escribe ~/.codex/config.toml, cuya entrada lee la credencial de la variable de entorno SHOWLY_TOKEN y no del archivo: el comando imprime la línea export SHOWLY_TOKEN=… correspondiente, y Codex no puede autenticarse hasta que esté definida donde se inicia. --to stdout no escribe nada y solo imprime un fragmento, y --print-token imprime únicamente el token para que CI pueda capturarlo sin que acabe en un archivo.

Apruebe solo si el código de la página coincide con el de su terminal. La pantalla de consentimiento le pide confirmarlo de forma explícita, porque el nombre que muestra un cliente lo eligió él mismo: el código es la parte que usted sí puede comprobar. Un código dura 15 minutos y abrir la página le concede 10 minutos más para iniciar sesión y aprobar; si caduca, ejecute el comando otra vez.

No es algo que su cliente descubra por su cuenta. Los clientes MCP no inician flujos de dispositivo, así que login es la única entrada. La credencial que escribe caduca a los 90 días y Showly no emite token de actualización: vuelva a ejecutar login entonces.

Solución de problemas

tool not found: mcp__showly__list_sites: la habilidad está instalada pero el servidor MCP aún no está conectado. En Claude Code ejecute claude mcp list y verifique la entrada showly; invoque una herramienta Showly una vez para activar el inicio de sesión.

El inicio de sesión en el navegador no aparece/está "no autorizado": es posible que su agente no admita el flujo de autorización estándar MCP. Confirma que es una versión reciente y luego vuelve a intentarlo; el agente debe poder seguir el descubrimiento 401 → WWW-Authenticate para abrir la página de consentimiento.

"No tienes permiso para aprobar": la cuenta de aprobación necesita al menos site:write. Inicie sesión con una cuenta de propietario/administrador/desarrollador/miembro, o haga que un compañero de equipo con ese rol lo apruebe.

"sitio no encontrado": los ámbitos aprobados o la lista de sitios permitidos no cubren el sitio sobre el que usted preguntó. Vuelva a ejecutar el inicio de sesión y apruebe los ámbitos necesarios, o amplíe el acceso desde la página Mi agente (/app/integrations).

Las llamadas a herramientas se bloquean: el servidor MCP no puede comunicarse con el API de Showly. Verifique su red; Si anuló el punto final, confirme que SHOWLY_MCP_URL (la URL del servidor MCP) y SHOWLY_API_URL (la base API) no apuntan a algún lugar obsoleto.

Revocar el acceso

Para revocar el acceso de un agente, abra la página Mi agente (/app/integrations), busque el agente y desconéctelo. La revocación surtirá efecto inmediatamente; Se le pedirá al agente que inicie sesión nuevamente en su próxima llamada. No hay ningún token que rotar manualmente: el agente obtiene uno nuevo a través del flujo del navegador. Si no hay navegador, lo obtiene con npx @showly/mcp-server login. Las credenciales del inicio de sesión sin interfaz caducan a los 90 días.