Linkly

MCP oficial de acortador de URL de Linkly: crea enlaces cortos de marca, rastrea análisis de clics, gestiona dominios y webhooks. Alojado, OAuth, sin claves de API.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de Linkly

Servidor oficial del Model Context Protocol (MCP) para Linkly, la plataforma de acortamiento de URL y gestión de enlaces.

Este repositorio impulsa el servidor MCP alojado en https://mcp.linklyhq.com. Esa es la única forma compatible de conectar un asistente de IA a Linkly mediante MCP. Consulta https://linklyhq.com/support/mcp-server para las instrucciones de configuración.

⚠️ El paquete npm linkly-mcp-server está obsoleto. El flujo autoalojado / con clave de API ya no se mantiene. Todos los usuarios deben migrar al servidor alojado: utiliza OAuth 2.1 con PKCE, no requiere claves de API ni instalación local, y siempre ejecuta el conjunto de herramientas más reciente. El paquete npm seguirá existiendo en el registro por compatibilidad con versiones anteriores, pero no recibirá nuevas herramientas ni correcciones de errores, y podría dejar de publicarse en el futuro.

Documentación

Para documentación completa, guías de configuración y ejemplos, visita: https://linklyhq.com/support/mcp-server

Características

Crear, actualizar y eliminar enlaces cortos
Ver análisis y estadísticas de clics
Gestionar dominios personalizados y favicons
Configurar webhooks para eventos de clic
Buscar y filtrar enlaces
Exportar datos de clics

Uso del servidor alojado

URL del servidor: https://mcp.linklyhq.com

Conecta tu cliente MCP al servidor alojado e inicia sesión en Linkly cuando se abra tu navegador. Eso es todo: sin claves de API, sin instalación, sin desviaciones de configuración.

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

Herramientas disponibles

Herramienta	Descripción
`create_link`	Crear un nuevo enlace corto
`update_link`	Actualizar un enlace existente
`delete_link`	Eliminar un enlace
`get_link`	Obtener detalles del enlace
`list_links`	Listar todos los enlaces del espacio de trabajo
`search_links`	Buscar enlaces por nombre, URL o nota
`get_analytics`	Obtener datos de clics en series temporales
`get_analytics_by`	Obtener clics agrupados por dimensión
`get_clicks`	Obtener datos de clics recientes
`export_clicks`	Exportar registros de clics detallados
`list_domains`	Listar dominios personalizados
`create_domain`	Añadir un dominio personalizado
`delete_domain`	Eliminar un dominio personalizado
`update_domain_favicon`	Actualizar el favicon del dominio
`list_webhooks`	Listar webhooks del espacio de trabajo
`subscribe_webhook`	Añadir un webhook
`unsubscribe_webhook`	Eliminar un webhook
`list_link_webhooks`	Listar webhooks específicos de enlaces
`subscribe_link_webhook`	Añadir un webhook de enlace
`unsubscribe_link_webhook`	Eliminar un webhook de enlace

Enlaces

Soporte

Para ayuda y soporte, visita Soporte de Linkly o escribe a support@linklyhq.com.

Publicación en el Registro MCP (mantenedores)

El server.json en la raíz del repositorio es el manifiesto del Registro MCP oficial para el servidor com.linklyhq/linkly. Es solo remoto: apunta a los clientes al servidor alojado y, intencionalmente, no incluye ningún paquete (la distribución npm obsoleta se eliminó en v2.0.0).

La publicación requiere acceso DNS a linklyhq.com: el espacio de nombres com.linklyhq se verifica mediante un registro DNS TXT en el ápice del dominio:

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

Consulta la guía de autenticación del registro para más detalles.

Actualización de la aplicación ChatGPT (mantenedores)

chatgpt-app-submission.json es la importación de envío del Apps SDK de OpenAI: rellena previamente las anotaciones por herramienta y las tres justificaciones de seguridad (solo lectura / mundo abierto / destructivo) para las 25 herramientas, para que no tengan que escribirse a mano en el panel.

OpenAI congela una instantánea de metadatos en el momento de la publicación y no detecta automáticamente los cambios de MCP, por lo que después de implementar cambios en el servidor se publica una nueva versión:

Implementa el worker (haz push a la rama conectada / wrangler deploy).
Panel de la plataforma → la aplicación Linkly → crea una nueva versión borrador (mantén la misma URL MCP https://mcp.linklyhq.com).
En la sección MCP, haz clic en Scan Tools para volver a leer la lista de herramientas en vivo y las anotaciones.
Arrastra chatgpt-app-submission.json al formulario (parte superior de la página) para completar las justificaciones.
Revisa Testing y luego Submit. La versión publicada sigue ejecutándose contra el servidor en vivo hasta que se apruebe la nueva.

Mantén este archivo sincronizado con el worker siempre que se añadan/eliminen herramientas o cambien sus readOnlyHint/destructiveHint. La marca destructiva es true solo para las 5 herramientas genuinamente destructivas (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook); las creaciones/actualizaciones/suscripciones son aditivas (false).

Licencia

MIT