Servidor MCP de Linkly

Servidor oficial del Model Context Protocol (MCP) para Linkly, la plataforma de acortador 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 obtener instrucciones de configuración.

⚠️ El paquete npm linkly-mcp-server está obsoleto. El flujo autohospedado / 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

Related MCP server: DWZ Short URL 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 clics

• 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 desviación 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

Enlaces

• Sitio web de Linkly

• Documentación

• Referencia de la API

• Repositorio de GitHub

Soporte

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

Publicación en el registro de MCP (mantenedores)

El server.json en la raíz del repositorio es el manifiesto del registro oficial de MCP para el servidor com.linklyhq/linkly. Es solo remoto: apunta a los clientes al servidor alojado y, a propósito, 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 obtener más detalles.

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

chatgpt-app-submission.json es la importación de envío del SDK de Apps 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 haya que escribirlas 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:

1. Implementa el worker (haz push a la rama conectada / wrangler deploy).

2. Panel de la plataforma → la aplicación Linkly → crea una nueva versión borrador (mantén la misma URL de MCP https://mcp.linklyhq.com).

3. En la sección MCP, haz clic en Scan Tools para volver a leer la lista de herramientas en vivo y las anotaciones.

4. Arrastra chatgpt-app-submission.json al formulario (parte superior de la página) para rellenar las justificaciones.

5. 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 o eliminen herramientas o cambien sus readOnlyHint/destructiveHint. La marca destructiva es true solo para las 5 herramientas realmente destructivas (delete_link, delete_domain, batchDeleteLinks, unsubscribe_webhook, unsubscribe_link_webhook); las creaciones/actualizaciones/suscripciones son aditivas (false).

Licencia

MIT