Skip to main content

​
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. Exclusivo de Pro.Endpoint: https://mcp.linkly.ai/mcp
Esta página describe cómo configurar el acceso local y el acceso en red local, que son gratuitos los dos. Para el acceso remoto por internet, consulta la guía de acceso remoto — esa vía es exclusiva de Pro; y si lo único que quieres es que una IA en la nube llegue a un conjunto concreto de material, normalmente encaja mejor una biblioteca en la nube, que es gratuita. Las diferencias entre todas las vías están en la visión general de las integraciones.

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:
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:

​
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:
Si usas Linkly AI CLI, puedes conectarte así:
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.

​
Cuando una herramienta no aparece

Publicamos nuevas herramientas MCP con cierta regularidad. La mayoría de los clientes de IA almacenan en caché la lista de herramientas del momento en que añadiste la conexión y nunca la actualizan por su cuenta, así que una herramienta recién publicada no aparecerá hasta que el cliente vuelva a obtener la lista. Si una herramienta documentada aquí falta en tu cliente:
  1. Actualiza la conexión en tu cliente — en ChatGPT: Configuración → Conectores → tu conector → Actualizar.
  2. Comprueba si la herramienta ya figura en la lista pero está desactivada. Actualmente ChatGPT añade las acciones recién descubiertas en estado desactivado: aparecen atenuadas y no se pueden invocar hasta que las habilites en esa lista. Normalmente basta con este paso.
  3. Si aun así no aparece, elimina la conexión y vuelve a añadirla.
  4. Inicia una conversación nueva. Una conversación ya en curso conserva la lista de herramientas con la que se inició.

​
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 nueve herramientas, conformando un flujo de trabajo progresivo de acceso a documentos:
  • search — búsqueda híbrida (BM25 + vectorial), punto de entrada principal
  • outline — esquemas de documentos
  • grep — coincidencia de regex dentro de un único documento
  • read — lectura de documento línea por línea
  • list_libraries — listar bibliotecas de conocimiento disponibles
  • explore — visión panorámica de una colección de documentos
  • find_paths — localizar rutas de carpeta por palabra clave para alimentar el path_glob de search
  • list — listar las entradas de un contenedor: un directorio del disco (folder), una biblioteca (library) o sus notas (notes)
  • note_save — crear o editar una nota, la única herramienta de escritura
Salvo note_save, todas son de solo lectura y no modifican ninguno de tus documentos. Cada respuesta exitosa lleva una marca de tiempo UTC: una línea final [meta] now=... en la salida Markdown, o un campo _meta.now de nivel superior en la salida JSON, útil para calcular fechas relativas como “el mes pasado”. Las respuestas de error no incluyen estos metadatos. Para tablas completas de parámetros, campos de respuesta, formato de metadatos de respuesta y ejemplos de uso, consulta Introducción a las herramientas MCP de Linkly AI.