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 conversaciones naturales.
¿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.)
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"
- Rastree el 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/webhookpara recibir eventos de clics"
Primeros Pasos
El Servidor MCP de Linkly alojado está disponible en https://mcp.linklyhq.com. No hay nada que instalar ni ninguna clave de API que copiar — el servidor usa OAuth, así que la primera vez que tu asistente de IA se conecte, se abrirá una ventana del navegador pidiéndote que inicies sesión en Linkly y autorices el acceso. Después de eso, tu asistente permanecerá 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
Agrega el servidor MCP de Linkly:
{
"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 abrirá una pestaña del navegador para que inicies sesión y autorices el acceso.
Claude Code (CLI)
Claude Code admite servidores MCP remotos de forma nativa. Agrega Linkly con un solo 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
| 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 recientes de clics |
get_analytics | Obtiene datos de clics en serie temporal 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 de 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 - Rastreo:
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.comsea accesible desde tu equipo - Si tu cliente usa
mcp-remote, asegúrate de tener Node.js v18 o posterior instalado - En Claude Code, ejecuta
/mcpy elige linkly para volver a activar el flujo de OAuth
"Falló la autenticación" / el navegador sigue pidiendo iniciar sesión
Borra las credenciales MCP 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 en caché en ~/.mcp-auth/ y 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 ícono 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 — simplemente inicias sesión una vez en el navegador y tu asistente de IA permanece conectado. No hay software que instalar en tu equipo más allá de tu propio asistente de IA.
¿Necesito una clave de 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 ninguna clave de API que copiar o pegar en ningún lado.
¿Qué asistentes de IA son compatibles con MCP?
Claude Desktop, Claude Code (CLI) y ChatGPT Desktop son compatibles con 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 introduce 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 en sí nunca ve tus credenciales.
¿Puedo usar MCP con las versiones web de Claude o ChatGPT?
No, MCP requiere las aplicaciones de escritorio o la CLI de Claude Code. Las versiones web no son compatibles con conexiones MCP.
¿Cómo actualizo el servidor MCP?
No hay nada que actualizar — implementamos mejoras continuamente al servidor alojado y cada cliente conectado las recibe automáticamente.
Rastrea 500 clics mensuales con todas las funciones incluidas.
No se requiere tarjeta de crédito