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 mediante conversación natural.

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.

El Servidor MCP de Linkly funciona con:

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

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 obtuvieron 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://mi-sitio.com/webhook para recibir eventos de clics"

El Servidor MCP de Linkly está disponible de dos formas:

Usa nuestro servidor MCP alojado - no se requiere instalación:

https://mcp.linklyhq.com

Instala y ejecuta localmente usando npx:

npx -y linkly-mcp-server

O instala globalmente:

npm install -g linkly-mcp-server

Ver el paquete en npm.

1. 1Inicia sesión en tu panel de Linkly
2. 2Ve a Configuración → Claves de API
3. 3Copia tu Clave de API e ID de Espacio de Trabajo

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 MCP de Linkly:

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "tu-clave-de-api",
        "LINKLY_WORKSPACE_ID": "tu-id-de-espacio-de-trabajo"
      }
    }
  }
}

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:

Usando npx:

{
  "servers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "tu-clave-de-api"
      }
    }
  }
}

Usando el servidor alojado:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "tu-clave-de-api"
      }
    }
  }
}

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

• Verifica que tu clave de API e ID de Espacio de Trabajo sean correctos
• Asegúrate de tener Node.js instalado (v18 o posterior)
• Intenta ejecutar npx linkly-mcp-server en una terminal para ver cualquier error

• Verifica tu clave de API en el panel de Linkly en Configuración → Claves de API
• Asegúrate de que no haya espacios adicionales en tus credenciales
• Intenta regenerar tu clave de API

• 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)

• Confirma que la ruta del comando sea correcta
• Si usas el servidor alojado, verifica tu conexión a internet
• Verifica que el servidor MCP se ejecute manualmente desde la terminal

• Integración con Claude Desktop
• Integración con ChatGPT
• Documentación de la API de Linkly
• Webhooks
• Servidor MCP en npm
• Protocolo de Contexto de Modelo