linkonda-mcp

Servidor MCP de Linkonda

Crea y gestiona enlaces cortos de Linkonda desde Claude, Claude Code, Cursor o cualquier otro cliente MCP.

Linkonda registra un recuento total de redirecciones por enlace y nada más — sin direcciones IP, geolocalización, datos de dispositivo ni referentes. Esto importa más de lo habitual para un agente, que puede generar enlaces en masa sin crear un conjunto de datos de visitantes que luego tengas que asegurar, conservar y responder solicitudes al respecto.

Funciona sin clave API

La mayoría de los servidores MCP de acortadores se niegan a iniciar sin credenciales. Este acorta URLs inmediatamente tras la instalación: los enlaces anónimos están limitados por red y caducan a los 30 días. Añade una clave cuando quieras enlaces que persistan y puedan gestionarse.

	Sin clave	Con LINKONDA_API_KEY
shorten_link	✅ 10 enlaces, caducan a los 30 días	✅ permanentes, guardados en tu cuenta
get_link_stats	✅	✅
check_quota	✅ asignación anónima	✅ tu plan
shorten_links_bulk, list_links, update_link, delete_link	✗	✅

La autenticación Bearer requiere un plan de pago — consulta precios. Crea una clave en el panel bajo API keys; se muestra una sola vez.

Instalación

Añade a la configuración de tu cliente MCP (Claude Desktop: claude_desktop_config.json; Claude Code: .mcp.json):

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"]
    }
  }
}

Para usar una clave API, añádela a la misma entrada:

{
  "mcpServers": {
    "linkonda": {
      "command": "npx",
      "args": ["-y", "@veranoapp/linkonda-mcp"],
      "env": { "LINKONDA_API_KEY": "lk_your_key_here" }
    }
  }
}

Variable	Predeterminado	Propósito
LINKONDA_API_KEY	(sin definir)	Clave Bearer. Omítela para ejecutar de forma anónima.
LINKONDA_API_BASE_URL	https://api.linkonda.com	Apunta a otra instancia.

Herramientas

Herramienta	Qué hace	Clave requerida
shorten_link	Acorta una URL	No
shorten_links_bulk	Acorta hasta 100 URLs en una sola solicitud	Sí
list_links	Lista tus enlaces con destinos y recuentos de clics	Sí
update_link	Cambia un destino, o pausa/reanuda un enlace	Sí
delete_link	Elimina permanentemente un enlace	Sí
get_link_stats	Recuento total de redirecciones de un enlace	No
check_quota	Enlaces activos frente a la asignación del plan	No

shorten_links_bulk es de éxito parcial: algunas entradas pueden fallar (cuota, URL no válida) mientras otras se crean, y la herramienta informa de ambas listas en lugar de solo los éxitos.

Lo que no puedes obtener

No hay datos por visitante que devolver, por lo que no existen herramientas para desgloses geográficos, de dispositivo o de referentes — esos datos nunca se recopilan. Si tu flujo de trabajo necesita atribución de clics, un acortador con seguimiento es la herramienta adecuada; consulta las comparaciones.

Desarrollo

npm install
npm run build
LINKONDA_API_KEY=lk_... npm start   # speaks MCP over stdio

npm run typecheck ejecuta el compilador sin emitir.