Model Context Protocol

Servidor MCP de LinkTwin: deja que tu agente de IA cree y gestione enlaces.

El servidor MCP oficial para acortar enlaces y crear deep links. Conecta Claude, Cursor y otros asistentes de IA a tu cuenta de LinkTwin y simplemente pide: crea enlaces cortos y deep links, organiza colecciones, asocia píxeles, genera códigos QR y lee tus analíticas.

Ver la configuración
npx -y @linktwin/mcp
  • Licencia MIT, en npm
  • Se ejecuta en tu máquina
  • Funciona con cualquier cliente MCP
Asistente de IA 34 herramientas de LinkTwin
Crea un enlace corto para mi video de desk tour https://www.youtube.com/watch?v=x7K2pQ9mW4s con el alias desk-tour y añádelo a mi colección YouTube.
linktwin create_linkEn ejecución Listo
{
  "url": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  "custom": "desk-tour",
  "collections": ["YouTube"]
}

Listo. Tu nuevo enlace está en la colección YouTube:

linktw.in/desk-tourSe abre en la app de YouTube
Ejemplos de conversaciones. Los nombres y argumentos de las herramientas son los reales.

Por qué un servidor MCP

De "acorta esto" a listo, sin salir de tu chat.

Cambiar a un panel o conectar la API REST a mano interrumpe tu flujo. El servidor MCP de LinkTwin le da a tu asistente de IA herramientas de gestión de enlaces de primera clase, para que pueda crear enlaces de campaña, deep links y códigos QR por ti mientras tú sigues en la conversación.

Pasos para lograrlo

  • Panel y copiar y pegar
  • Servidor MCP de LinkTwin
Crea un enlace con alias
Encuentra tu mejor enlace de este mes
Contado para alguien que ya inició sesión. Cada bloque es una acción. Algunos clientes te dejan permitir siempre una herramienta, lo que también elimina el paso de aprobación.
La tarea Sin un MCP Con el MCP de LinkTwin
Crear enlaces Copiar y pegar entre el chat y el panel Crea enlaces con solo pedirlo
Segmentación y UTM Escribir a mano las llamadas a la API y los encabezados de autenticación Deep links, segmentación y UTM en un solo prompt
Tus números La IA no puede ver tus enlaces ni tus estadísticas La IA lee tus analíticas bajo demanda
Trabajo repetitivo Lento, propenso a errores, repetitivo Operaciones masivas en segundos

Configuración

Conéctate en tres pasos

Nada que instalar: npx ejecuta el servidor cuando hace falta. Solo necesitas Node.js 18 o superior y tu clave API.

  1. Obtén tu clave de API

    Copia tu clave API desde Configuración o desde la página Servidor MCP de tu panel de LinkTwin. El acceso a la API se incluye en todos los planes.

  2. Agrega el fragmento de configuración

    Pega el JSON de abajo en la configuración de tu cliente de IA y añade tu clave API.

  3. Solo pídelo

    Reinicia tu cliente y pídele que cree, edite o analice enlaces. Las herramientas de LinkTwin aparecen automáticamente.

Un fragmento para conectar

Agrega esto a Claude Desktop, Cursor o cualquier cliente MCP y luego reinicia.

Claude Desktop

En Claude Desktop abre Configuración, luego Desarrollador y luego Editar configuración. Pega el bloque en claude_desktop_config.json.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}
Cursor

En Cursor, crea .cursor/mcp.json en tu proyecto y pega el bloque.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}
Otros clientes MCP

Claude Code, Windsurf, Cline y otros clientes MCP aceptan el mismo JSON en su configuración MCP.

{
  "mcpServers": {
    "linktwin": {
      "command": "npx",
      "args": ["-y", "@linktwin/mcp"],
      "env": { "LINKTWIN_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Dos variables de entorno

El servidor se comunica por JSON-RPC sobre stdio y lee su configuración del bloque env de tu archivo de configuración.

VariableQué hace
LINKTWIN_API_KEY Obligatoria. Tu clave API de la página Configuración de LinkTwin.
LINKTWIN_BASE_URL Opcional. La raíz del sitio a la que llama el servidor. Por defecto, https://linktw.in.

Funciona con

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • Cline
  • Cualquier cliente MCP
  • Node.js 18 o superior, nada más que instalar.
  • Las herramientas se llaman según lo que hacen, así que puedes pedirlas con tus propias palabras.
  • ¿Prefieres la terminal? Usa la CLI de LinkTwin. ¿Estás creando tu propia integración? Lee la documentación de la API.

Capacidades

Todo lo que tu agente puede gestionar

34 herramientas que cubren toda la superficie de gestión de enlaces de LinkTwin. Todas las herramientas de enlaces admiten segmentación por país, dispositivo e idioma, variantes de prueba A/B y parámetros UTM, configurados en un solo prompt.

34

herramientas en siete grupos. Cada una envuelve un endpoint de la API REST de LinkTwin y valida sus datos antes de ejecutarse.

Enlaces6

Crea, edita, lista y elimina enlaces con alias personalizados, caducidad, contraseñas y límites de clics.

  • create_linkCrear enlace corto
  • list_linksListar enlaces
  • get_linkObtener enlace
  • update_linkActualizar enlace
  • delete_linkEliminar enlace
  • bulk_delete_linksEliminar enlaces en bloque

Analíticas4

Estadísticas de clics por enlace y de toda la cuenta: principales países, referentes, navegadores, dispositivos y tendencias diarias.

  • get_link_statsObtener analíticas del enlace
  • get_dashboard_statsEstadísticas del panel de la cuenta
  • get_detailed_statsEstadísticas detalladas de la cuenta
  • get_day_trendTendencia diaria de la cuenta

Colecciones6

Agrupa enlaces en colecciones y gestiona tus dominios personalizados con tu marca.

  • list_collectionsLista las colecciones
  • get_collectionObtener elementos de la colección
  • create_collectionCrear colección
  • update_collectionActualizar colección
  • add_links_to_collectionAñadir/quitar enlaces de una colección
  • delete_collectionEliminar colección

Dominios4

Añade dominios personalizados y elige adónde envían a los visitantes el dominio raíz y los enlaces que no existen.

  • list_domainsListar dominios
  • add_domainAñadir dominio personalizado
  • update_domainActualizar dominio
  • delete_domainEliminar dominio

Píxeles6

Crea píxeles de Facebook, GTM y otros, y adjúntalos a enlaces en masa.

  • list_pixelsListar píxeles
  • get_pixelObtener píxel
  • create_pixelCrear píxel
  • update_pixelActualizar píxel
  • delete_pixelEliminar píxel
  • assign_pixel_to_linksAsignar píxel a enlaces

Códigos QR5

Genera y actualiza códigos QR para cualquier enlace, con colores y logos.

  • list_qr_codesListar Códigos QR
  • get_qr_codeObtener código QR
  • create_qr_codeCrear código QR
  • update_qr_codeActualizar código QR
  • delete_qr_codeEliminar código QR

Cuenta3

Consulta tu plan y tu uso, configura tu dominio y tu zona horaria predeterminados, y cambia de espacio de trabajo.

  • get_accountObtener información de la cuenta
  • update_account_settingsActualizar configuración de la cuenta
  • switch_workspaceCambiar de espacio de trabajo

Prueba a pedírselo a tu asistente

Escribe la petición como la dirías. El asistente elige las herramientas, completa los argumentos y te cuenta lo que hizo.

Crea un enlace de campaña

Crea un enlace corto para https://example.com/spring-sale con el alias spring-sale y agrégalo a mi colección de Marketing.
  • Llama a
  • create_link

Dirige a los visitantes según su país

Crea un deep link que abra example.ca para los visitantes canadienses y example.com para todos los demás.
  • Llama a
  • create_link

Encuentra tus mejores enlaces

¿Cuáles de mis enlaces tuvieron más clics este mes y de dónde vino el tráfico?
  • Llama a
  • get_detailed_stats

Códigos QR y retargeting

Genera un código QR para mi último enlace y adjúntale mi píxel de Facebook.
  • Llama a
  • list_links
  • create_qr_code
  • list_pixels
  • assign_pixel_to_links

Limpia pruebas antiguas

Busca mis enlaces que tengan "test" en el título y elimínalos.
  • Llama a
  • list_links
  • bulk_delete_links

Trabaja en un espacio de trabajo de equipo

Cambia al espacio de trabajo de mi equipo y lista los dominios personalizados que podemos usar.
  • Llama a
  • get_account
  • switch_workspace
  • list_domains

Cómo funciona el servidor MCP de LinkTwin

Tu cliente de IA inicia el servidor en tu computadora con npx y se comunica con él por stdio. El servidor llama a la API de LinkTwin por HTTPS con tu clave API, dentro de tu propia cuenta.

  1. Tu cliente de IA Claude, Cursor, Windsurf, Cline o cualquier cliente MCP
  2. Servidor MCP de LinkTwin Iniciado por npx -y @linktwin/mcp En tu computadora
  3. API de LinkTwin Tus enlaces, colecciones, píxeles, códigos QR y estadísticas
  • Solo hace lo que permite tu clave API, dentro de tu propia cuenta y espacio de trabajo.
  • Los errores, como una clave incorrecta, un límite de solicitudes, un límite del plan o datos no válidos, vuelven como resultados de la herramienta marcados como error, para que el agente pueda explicarlo o reintentar.
  • No se elimina nada a menos que el agente llame a una herramienta de eliminación, como delete_link o bulk_delete_links.
  • Regenera tu clave API en cualquier momento para revocar el acceso al instante.

Preguntas sobre el servidor MCP

Todo sobre el MCP de acortamiento de enlaces y deep linking. ¿Aún tienes preguntas? Contáctanos.

¿Qué es el servidor MCP de LinkTwin?

El servidor MCP de LinkTwin es el servidor oficial de Model Context Protocol (MCP) para acortar enlaces y crear deep links. Conecta asistentes de IA como Claude y Cursor a tu cuenta de LinkTwin, para que puedan crear, editar y gestionar enlaces cortos y deep links, organizar colecciones, asociar píxeles de retargeting, generar códigos QR y leer analíticas de clics, todo desde una conversación en lenguaje natural.

¿Qué es un servidor MCP (Model Context Protocol)?

MCP es un estándar abierto que permite a los asistentes de IA conectarse a herramientas y datos externos. Un servidor MCP expone un conjunto de herramientas que el asistente puede llamar. El servidor MCP de LinkTwin expone 34 herramientas de gestión de enlaces, así que cualquier app compatible con MCP (Claude Desktop, Claude Code, Cursor, Windsurf, Cline y más) puede gestionar tus enlaces por ti.

¿El MCP de acortamiento de enlaces es gratuito?

El servidor MCP en sí es gratis y tiene licencia MIT, publicado en npm como @linktwin/mcp. Funciona a través de la API de LinkTwin, y el acceso a la API se incluye en todos los planes. Puedes crear primero una cuenta gratis y pasar a un plan superior cuando estés listo para conectar tu agente.

¿Qué clientes de IA son compatibles?

Cualquier cliente que hable el Model Context Protocol por stdio, como Claude Desktop, Claude Code, Cursor, Windsurf y Cline. Añades un fragmento de JSON a la configuración MCP del cliente y las herramientas de LinkTwin aparecen al reiniciarlo.

¿El servidor MCP puede crear deep links y no solo enlaces cortos?

Sí. Es un MCP de deep linking además de un MCP de acortamiento de enlaces. A través de tu asistente puedes crear enlaces que se abren en apps como YouTube, Amazon y Spotify, con segmentación por país, dispositivo e idioma, variantes de prueba A/B, parámetros UTM, dominios personalizados y salida del navegador integrado. Son las mismas opciones que en el panel y la API de LinkTwin.

¿Cómo obtengo mi clave de API?

Inicia sesión en LinkTwin y abre Configuración, o Herramientas e integraciones y luego Servidor MCP, en tu panel. Copia tu clave API y pégala en la configuración de tu cliente MCP como LINKTWIN_API_KEY. La clave aparece cuando tu plan incluye acceso a la API.

¿Es seguro darle a un agente de IA acceso a mis enlaces?

El servidor MCP se ejecuta en tu propia computadora y solo hace lo que permite tu clave API, dentro de tu propia cuenta. Tu clave va de tu máquina a la API de LinkTwin y nunca se comparte con terceros. Eliminar cualquier cosa requiere una llamada explícita a una herramienta, y puedes regenerar tu clave API en cualquier momento para revocar el acceso al instante.

¿Qué herramientas incluye el servidor MCP de LinkTwin?

34 herramientas en siete grupos: enlaces (create_link, list_links, get_link, update_link, delete_link y bulk_delete_links), analíticas (get_link_stats, get_dashboard_stats, get_detailed_stats y get_day_trend), colecciones, dominios personalizados, píxeles de retargeting, códigos QR y tu cuenta. Cada una es una capa fina sobre la API REST de LinkTwin, explicada en la documentación de la API.

¿Necesito instalar algo?

Solo Node.js 18 o superior. El fragmento de configuración ejecuta el servidor cuando hace falta con npx -y @linktwin/mcp, así que no hay instalación global y siempre obtienes la versión publicada.

Una API key, tres formas de construir

La API REST, el servidor MCP y la CLI usan la misma API key y gestionan los mismos enlaces.

Dale a tu IA el poder de gestionar enlaces

Conecta el servidor MCP de LinkTwin y empieza a crear enlaces conversando.

npx -y @linktwin/mcp

El acceso a la API está disponible en todos los planes. Ver planes