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 que los asistentes de IA se conecten de forma segura a herramientas externas y fuentes de datos. En lugar de copiar y pegar entre aplicaciones, puedes pedir 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 directorios principales de MCP, así que puedes instalarlo desde donde ya busques 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 Linkly CLI?
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 a menudo es una mejor opción 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 completo de comandos, 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.
Qué puedes hacer
Una vez conectado, puedes pedir a tu asistente de IA que:
- Crea enlaces cortos - "Crea un enlace corto para https://example.com"
- Monitorea el rendimiento - "¿Cuántos clics recibieron mis enlaces esta semana?"
- Gestiona enlaces - "Actualiza el enlace llamado 'promo' con un nuevo destino"
- Ver análisis - "Muéstrame clics por país para los últimos 30 días"
- Busca enlaces - "Encuentra todos los enlaces relacionados con el lanzamiento del producto"
- Gestiona dominios - "Lista mis dominios personalizados"
- Configura webhooks - "Suscribe
https://my-site.com/webhookpara recibir eventos de clics"
Primeros pasos
El Servidor MCP de Linkly alojado vive en https://mcp.linklyhq.com. No hay nada que instalar y ninguna clave API que copiar — el servidor usa OAuth, así que la primera vez que tu asistente de IA se conecta, 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
En Claude Desktop, ve a Settings → Connectors → Add custom connector. Ingresa un nombre (Linkly) y la URL del servidor MCP remoto:
https://mcp.linklyhq.com
Haz clic en Add, luego en Connect en el conector de Linkly. Se abre una pestaña del navegador para que inicies sesión y apruebes el acceso. Claude Desktop permanece conectado — sin archivo de configuración ni herramientas adicionales necesarias.
Claude code (CLI)
Claude Code admite 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 MCP de Linkly:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}
Herramientas disponibles
| Herramienta | Descripción |
|---|---|
create_link | Crea un nuevo enlace corto con parámetros UTM opcionales, píxeles y más |
update_link | Actualiza la configuración de un enlace existente |
delete_link | Elimina un enlace |
get_link | Obtiene detalles de un enlace específico |
list_links | Lista todos los enlaces en tu espacio de trabajo |
search_links | Busca enlaces por nombre, URL o nota |
get_clicks | Obtiene datos de clics recientes |
get_analytics | Obtiene datos de clics en series temporales para gráficos |
get_analytics_by | Obtiene clics agrupados por país, navegador, plataforma, etc. |
list_domains | Lista tus dominios personalizados |
list_webhooks | Lista las suscripciones a webhooks del espacio de trabajo |
subscribe_webhook | Suscribe una URL para recibir eventos de clics |
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 - Tus propios datos:
metadata, pares clave-valor como IDs de tu sistema. Se devuelve con el enlace e se incluye en las cargas útiles de webhook. Ver metadatos de enlace
Solución de problemas
"No se pudo conectar al servidor MCP"
- Confirma que
https://mcp.linklyhq.comsea accesible desde tu máquina - En Claude Code, ejecuta
/mcpy elige linkly para volver a activar el flujo de OAuth
"Autenticación fallida", "invalid_client", o el navegador sigue pidiendo iniciar sesión
Esto significa que tu cliente tiene un registro de conexión obsoleto. Borra las credenciales almacenadas en caché y vuelve a autorizar. En Claude Code, ejecuta /mcp → linkly → reconecta. En Claude Desktop, elimina el conector de Linkly en Settings → Connectors y vuelve a añadirlo, luego inicia sesión de nuevo.
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
- Comprueba que el servidor MCP está ejecutándose (busca el icono de herramientas en tu asistente)
Recursos relacionados
Preguntas frecuentes sobre el servidor MCP
¿Necesito instalar algo para usar el servidor MCP?
No. El servidor alojado en https://mcp.linklyhq.com usa OAuth — inicias sesión una vez en el navegador y tu asistente de IA permanece conectado. No hay software que instalar en tu máquina más allá del asistente de IA mismo.
¿Necesito una clave API?
No. El servidor MCP usa OAuth — inicias sesión en Linkly a través de tu navegador la primera vez que tu asistente de IA se conecta, y no hay clave API para copiar o pegar en ningún lugar.
¿Qué asistentes de IA admiten MCP?
Claude Desktop, Claude Code (CLI) y ChatGPT Desktop todos admiten MCP. Otras herramientas como Cursor y Windsurf también tienen soporte para MCP.
¿Es segura mi cuenta?
Sí. El servidor alojado usa OAuth 2.1 con PKCE — tu contraseña de Linkly solo se ingresa en app.linklyhq.com, y tu asistente de IA solo ve un token de acceso limitado a tu espacio de trabajo. El modelo de IA mismo nunca ve tus credenciales.
¿El servidor MCP respeta mi rol en el espacio de trabajo?
Sí. Tu asistente de IA puede hacer todo lo que tu rol permita y nada más. Si tienes el rol de Lectura, puede buscar enlaces y análisis pero no puede crear, editar o eliminar nada.
Disponibilidad del plan
Disponible desde Pro
Rastrea 500 clics mensuales con todas las funciones incluidas.