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:

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/webhook para 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

HerramientaDescripción
create_linkCrea un nuevo enlace corto con parámetros UTM opcionales, píxeles y más
update_linkActualiza la configuración de un enlace existente
delete_linkElimina un enlace
get_linkObtiene detalles de un enlace específico
list_linksLista todos los enlaces en tu espacio de trabajo
search_linksBusca enlaces por nombre, URL o nota
get_clicksObtiene datos recientes de clics
get_analyticsObtiene datos de clics en serie temporal para gráficos
get_analytics_byObtiene clics agrupados por país, navegador, plataforma, etc.
list_domainsLista tus dominios personalizados
list_webhooksLista las suscripciones de webhooks del espacio de trabajo
subscribe_webhookSuscribe 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.com sea accesible desde tu equipo
  • Si tu cliente usa mcp-remote, asegúrate de tener Node.js v18 o posterior instalado
  • En Claude Code, ejecuta /mcp y 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 /mcplinkly → 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