Saltar al contenido principal

​
Introducción a MCP

MCP (Model Context Protocol) es un protocolo abierto que permite a los asistentes de IA invocar herramientas externas para obtener información de contexto. Linkly AI Desktop incluye un servicio MCP integrado que se inicia automáticamente tras la instalación, sin necesidad de configuración adicional. Solo necesitas agregar el endpoint MCP de Linkly AI a tu asistente de IA, y la IA podrá buscar, explorar y leer directamente tus documentos locales.

​
Tres modos de acceso

Linkly AI ofrece tres modos de acceso MCP, adecuados para diferentes escenarios:

Acceso local

Úsalo directamente en herramientas de IA en tu propia máquina, sin necesidad de configuración adicional. Ideal para Claude Code, Cursor y otras aplicaciones locales.Endpoint: http://127.0.0.1:60606/mcp

Acceso en red local

Otros dispositivos en la misma red también pueden conectarse. Requiere habilitar el acceso en red local y usar un token de acceso.Endpoint: http://{IP-red-local}:60606/mcp

Acceso remoto (internet)

Acceso remoto a través de internet mediante un túnel. Ideal para ChatGPT, Claude.ai y otras aplicaciones de IA en línea.Endpoint: https://mcp.linkly.ai/mcp
Esta página describe cómo configurar el acceso local y el acceso en red local. Para el acceso remoto por internet, consulta la guía de acceso remoto.

HTTP MCP (recomendado)

La mayoría de los asistentes de IA admiten el protocolo de transporte HTTP. Conéctate directamente al endpoint MCP de Linkly AI sin necesidad de instalar la CLI.

Stdio MCP

Algunos asistentes de IA solo admiten el protocolo de transporte stdio y necesitan Linkly AI CLI como puente.
Si no estás seguro de cuál elegir, selecciona HTTP MCP. Solo necesitarás el método Stdio cuando tu asistente de IA explícitamente no admita transporte HTTP.

​
Requisitos previos

1

Instalar e iniciar Linkly AI Desktop

Ve a linkly.ai para descargar e instalar la aplicación de escritorio. Completa el asistente de inicialización en el primer inicio, y la aplicación comenzará automáticamente a indexar tus documentos.
2

Confirmar que el servicio MCP está activo

Linkly AI Desktop inicia automáticamente el servicio MCP al arrancar. Puedes consultar el estado y el número de puerto del servicio MCP en la configuración de la aplicación.Endpoint MCP predeterminado: http://127.0.0.1:60606/mcp
Si eliges el método Stdio MCP, también necesitarás instalar Linkly AI CLI.

​
Métodos de uso

​
HTTP MCP (recomendado)

Adecuado para asistentes de IA que admitan el protocolo de transporte HTTP/StreamableHTTP. Sin necesidad de instalar CLI, conexión directa.
Ejecuta en la terminal:
claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
El puerto 60606 es el puerto predeterminado del servicio MCP de Linkly AI. Si no puedes conectarte, consulta el número de puerto real en la configuración de la aplicación.

​
Stdio MCP

Adecuado para asistentes de IA que admitan el protocolo de transporte stdio. Primero necesitas instalar Linkly AI CLI y luego configurar linkly mcp como comando puente stdio en tu asistente de IA.
Ejecuta en la terminal:
claude mcp add linkly-ai -- linkly mcp

​
Acceso en red local

Si necesitas acceder a Linkly AI desde otro dispositivo en la misma red (como otro ordenador, n8n en un NAS, etc.), puedes habilitar el modo de acceso en red local.
1

Habilitar el acceso en red local

En Linkly AI Desktop, ve a Configuración → MCP, busca la sección “Acceso en red local” y activa el interruptor.
2

Obtener la URL de red local y el token de acceso

Una vez habilitado, la interfaz mostrará:
  • URL de red local: similar a http://192.168.x.x:60606/mcp
  • Token de acceso: una cadena de caracteres aleatorios
Copia ambos valores al dispositivo que necesitas conectar.
3

Configurar en otros dispositivos

Al agregar el servidor MCP en las herramientas de IA de otros dispositivos, usa la URL de red local como endpoint e incluye el token de acceso en el encabezado de la solicitud:
Authorization: Bearer <tu token de acceso>
Si usas Linkly AI CLI, puedes conectarte así:
linkly search "palabra clave" --endpoint http://192.168.x.x:60606/mcp --token <tu token de acceso>
El acceso en red local usa transmisión HTTP en texto plano. Solo se recomienda en redes de confianza como redes domésticas. No habilites esta función en WiFi público o entornos de red no confiables.

​
Verificar la integración

Después de completar la configuración, puedes enviar el siguiente prompt a tu asistente de IA para verificar:

Busca en mis documentos contenido sobre XX

Si la integración fue exitosa, el asistente de IA invocará la herramienta search de Linkly AI y devolverá resultados relevantes de tus documentos locales.

​
Uso combinado con Skills

Recomendamos encarecidamente instalar Linkly AI Skills junto con la configuración de MCP. Skills enseña al asistente de IA cómo usar eficientemente las herramientas de Linkly AI, incluyendo cuándo buscar, cuándo explorar índices, cuándo leer el texto completo y cómo gestionar la lectura paginada de documentos largos.

Por favor, ayúdame a instalar Agent Skill linkly-ai-skills y completa la integración de herramientas de LinklyAI...

​
Descripción de parámetros

El servicio MCP expone tres herramientas: search (búsqueda), outline (índice) y read (lectura), que conforman un flujo de trabajo progresivo de acceso a documentos. Consulta la documentación de herramientas: Introducción a las herramientas MCP de Linkly AI