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 necesita agregar el endpoint MCP de Linkly AI a su asistente de IA, y la IA podrá buscar, explorar y leer directamente sus documentos locales.

HTTP MCP (recomendado)

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

Stdio MCP

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

​
Requisitos previos

1

Instalar e iniciar Linkly AI Desktop

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

Confirmar que el servicio MCP está activo

Linkly AI Desktop inicia automáticamente el servicio MCP al arrancar. Puede 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:606060/mcp
Si elige el método Stdio MCP, también necesitará 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.
Ejecute en la terminal:
claude mcp add --transport http linkly-ai http://127.0.0.1:606060/mcp
El puerto 606060 es el puerto predeterminado del servicio MCP de Linkly AI. Si no puede conectarse, consulte 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 necesita instalar Linkly AI CLI y luego configurar linkly mcp como comando puente stdio en su asistente de IA.
Ejecute en la terminal:
claude mcp add linkly-ai -- linkly mcp

​
Verificar la integración

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

Buscar 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 sus 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 esquemas, cuándo leer el texto completo y cómo manejar la lectura paginada de documentos extensos.

Por favor, instale el Agent Skill linkly-ai-skills y complete la integración de herramientas de LinklyAI...

​
Descripción de parámetros

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