Servidor MCP de Linkly

El Servidor MCP de Linkly te permite conectar asistentes de IA a tu cuenta de Linkly usando el Protocolo de Contexto de Modelo. Una vez conectado, puedes crear y gestionar enlaces cortos a través de conversación natural.

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto que permite a los asistentes de IA conectarse de forma segura a herramientas externas y fuentes de datos. En lugar de copiar y pegar entre aplicaciones, puedes pedirle a tu asistente de IA que realice acciones directamente.

Asistentes de IA compatibles

El Servidor MCP de Linkly funciona con:

• Claude Desktop
• ChatGPT Desktop
• Otros clientes compatibles con MCP (Cursor, Windsurf, etc.)

Dónde encontrarlo

El Servidor MCP de Linkly está listado en los principales directorios de MCP, para que puedas instalarlo desde donde ya buscas conectores:

• Directorio de conectores de Claude — conecta con un clic en Claude (web y Desktop)
• Registro oficial de MCP — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — el plugin de Linkly para Claude Code y Cowork
• Código fuente en GitHub — licencia MIT

¿Servidor MCP o CLI de Linkly?

Si tu asistente de IA es un agente de codificación que puede ejecutar comandos de shell — como Claude Code o Cursor — la CLI de Linkly suele ser mejor que el servidor MCP. Los agentes de codificación ya están acostumbrados a usar herramientas de línea de comandos, y la CLI les proporciona salida --json en cada comando además de un comando linkly schema que imprime el árbol de comandos completo, para que el agente pueda descubrir todo lo que puede hacer. El servidor MCP sigue siendo la mejor opción para asistentes que no pueden ejecutar comandos de shell, como Claude Desktop y ChatGPT Desktop.

Lo que puedes hacer

Una vez conectado, puedes pedirle a tu asistente de IA que:

• Cree enlaces cortos - "Crea un enlace corto para https://example.com"
• Realice un seguimiento del rendimiento - "¿Cuántos clics recibieron mis enlaces esta semana?"
• Gestione enlaces - "Actualiza el enlace llamado 'promo' con un nuevo destino"
• Vea análisis - "Muéstrame los clics por país para los últimos 30 días"
• Busque enlaces - "Encuentra todos los enlaces relacionados con el lanzamiento del producto"
• Gestione dominios - "Lista mis dominios personalizados"
• Configure webhooks - "Suscribe https://my-site.com/webhook para recibir eventos de clic"

Primeros pasos

El Servidor MCP de Linkly alojado se encuentra en https://mcp.linklyhq.com. No hay nada que instalar ni clave API que copiar — el servidor usa OAuth, por lo que la primera vez que tu asistente de IA se conecte, se abre una ventana del navegador pidiéndote que inicies sesión en Linkly y apruebes el acceso. Después de eso, tu asistente se mantiene conectado.

https://mcp.linklyhq.com

Configuración

Claude desktop

En Claude Desktop, ve a Configuración → Conectores → Agregar conector personalizado. Introduce un nombre (Linkly) y la URL del servidor MCP remoto:

https://mcp.linklyhq.com

Haz clic en Agregar, luego en Conectar en el conector de Linkly. Se abre una pestaña del navegador para que inicies sesión y apruebes el acceso. Claude Desktop se mantiene conectado — no se necesita archivo de configuración ni herramientas adicionales.

Claude code (CLI)

Claude Code admite servidores MCP remotos de forma nativa. Agrega Linkly con un comando:

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

Luego ejecuta /mcp dentro de Claude Code, elige linkly, y autoriza en el navegador cuando se te solicite.

ChatGPT desktop

Abre tu archivo de configuración de ChatGPT:

• macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
• Windows: %APPDATA%\ChatGPT\mcp_servers.json

Agrega el servidor MCP de Linkly:

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

Herramientas disponibles

Opciones de creación de enlaces

Al crear enlaces, puedes especificar:

• Básico: url, name, note, domain, slug, enabled
• Parámetros UTM: utm_source, utm_medium, utm_campaign, utm_term, utm_content
• Open Graph: og_title, og_description, og_image
• Seguimiento: fb_pixel_id, ga4_tag_id, gtm_id
• Avanzado: cloaking, forward_params, block_bots, hide_referrer
• Caducidad: expiry_datetime, expiry_destination

Solución de problemas

"No se pudo conectar al servidor MCP"

• Confirma que https://mcp.linklyhq.com es accesible desde tu máquina
• En Claude Code, ejecuta /mcp y elige linkly para activar nuevamente el flujo de OAuth

"Error de autenticación", "invalid_client", o el navegador sigue pidiendo que inicies sesión

Esto significa que tu cliente tiene un registro de conexión antiguo almacenado. Borra las credenciales en caché y vuelve a autorizar. En Claude Code, ejecuta /mcp → linkly → reconectarse. En Claude Desktop, elimina el conector de Linkly en Configuración → Conectores y agrégalo de nuevo, luego inicia sesión nuevamente.

Las herramientas no aparecen

• Reinicia tu asistente de IA después de guardar la configuración
• Verifica que la sintaxis JSON en tu archivo de configuración sea válida
• Verifica que el servidor MCP esté en ejecución (busca el icono de herramientas en tu asistente)

Recursos relacionados

• Integración con Claude Desktop
• Integración con ChatGPT
• Documentación de la API de Linkly
• CLI de Linkly
• Webhooks
• Protocolo de Contexto de Modelo