Servidor Linkly MCP

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

¿Qué es MCP?

El Protocolo de Contexto de Modelos (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 Linkly MCP funciona con:

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

Qué 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 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 de 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 clics"

Primeros Pasos

El Servidor Linkly MCP alojado se encuentra en https://mcp.linklyhq.com. No hay nada que instalar ni clave API que copiar — el servidor utiliza OAuth, así 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 permanece conectado.

https://mcp.linklyhq.com

Configuración

Claude Desktop

Abre tu archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade el servidor Linkly MCP:

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

Reinicia Claude Desktop. La primera vez que uses una herramienta de Linkly, se abre una pestaña del navegador para que inicies sesión y apruebes el acceso.

Claude Code (CLI)

Claude Code soporta servidores MCP remotos de forma nativa. Añade 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

Añade el servidor Linkly MCP:

{
  "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
• Expiración: expiry_datetime, expiry_destination

Solución de Problemas

"No se pudo conectar al servidor MCP"

• Confirma que https://mcp.linklyhq.com sea accesible desde tu máquina
• Si tu cliente usa mcp-remote, asegúrate de que Node.js v18 o posterior esté instalado
• En Claude Code, ejecuta /mcp y elige linkly para volver a activar el flujo de OAuth

"La autenticación falló" / el navegador sigue pidiendo iniciar sesión

Borra las credenciales de MCP almacenadas en caché de tu cliente y vuelve a autorizar. En Claude Code, ejecuta /mcp → linkly → reconectar. En Claude Desktop, cierra la aplicación, elimina el token de mcp-remote almacenado en caché en ~/.mcp-auth/, luego reinicia.

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é ejecutándose (busca el icono de herramientas en tu asistente)

Recursos Relacionados

• Integración Claude Desktop
• Integración ChatGPT
• Documentación de la API de Linkly
• Webhooks
• Protocolo de Contexto de Modelos