> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Siga esta guía para completar la instalación e integración de Linkly AI en pocos minutos

Esta guía de inicio rápido le permitirá construir su primera base de conocimiento local lista para IA con Linkly AI en pocos minutos, y aprender los métodos básicos de uso.

## Antes de empezar

Linkly AI incluye las siguientes aplicaciones y capacidades principales:

<CardGroup cols={2}>
  <Card title="Linkly AI Desktop" icon="desktop" iconType="duotone">
    Aplicación de escritorio (abreviada como Linkly AI). Tras la instalación,
    crea automáticamente índices de documentos y proporciona herramientas de
    búsqueda, esquema y lectura.
  </Card>

  <Card title="Linkly AI CLI" icon="terminal" iconType="duotone">
    Herramienta de línea de comandos que permite conectar su aplicación Linkly
    AI desde Bash e invocar sus herramientas. Ideal para uso con AI Agent.
  </Card>

  <Card title="MCP Server" icon="plug" iconType="duotone">
    Protocolo abierto para que los Agent obtengan contexto. Tras instalar Linkly
    AI, el servicio MCP se inicia automáticamente. Ideal para invocación por AI
    Agent.
  </Card>

  <Card title="linkly-ai-skills" icon="wand-magic-sparkles" iconType="duotone">
    Skills oficiales para Agent que guían al Agent sobre cómo conectarse y
    utilizar los servicios de herramientas de Linkly AI. Se recomienda
    encarecidamente su instalación.
  </Card>
</CardGroup>

## Paso 1: Instalar Linkly AI

Visite la página de descargas del sitio web oficial y seleccione la versión correspondiente a su sistema operativo:

<Card title="Descargar Linkly AI" icon="download" href="https://linkly.ai/#download">
  Seleccione la versión adecuada para su sistema operativo
</Card>

A continuación, haga doble clic en el paquete de instalación. Los pasos de instalación para cada plataforma son los siguientes:

<Tabs>
  <Tab title="macOS" icon="apple">
    <Steps>
      <Step title="Abrir el paquete de instalación">
        Haga doble clic en el archivo `.dmg` descargado para montar la imagen de
        disco
      </Step>

      <Step title="Arrastrar a Aplicaciones">
        Arrastre el icono de **LinklyAI** a la carpeta **Applications**
      </Step>

      <Step title="Iniciar la aplicación">
        Busque **LinklyAI** en Launchpad o en la carpeta Applications del Finder
        y haga doble clic para iniciar
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows" icon="windows">
    <Steps>
      <Step title="Ejecutar el instalador">
        Haga doble clic en el archivo de instalación `.exe` descargado
      </Step>

      <Step title="Completar la instalación">
        Siga las instrucciones del asistente de instalación. Se instala por
        defecto en el directorio del usuario
      </Step>

      <Step title="Iniciar la aplicación">
        Inicie **LinklyAI** desde el menú Inicio o el acceso directo del
        escritorio
      </Step>
    </Steps>
  </Tab>

  <Tab title="Linux" icon="linux">
    <Steps>
      <Step title="Método AppImage">
        `bash chmod +x LinklyAI-*.AppImage ./LinklyAI-*.AppImage `
      </Step>

      <Step title="O método paquete DEB">
        `bash sudo dpkg -i linkly-ai-*.deb `
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Paso 2: Inicializar Linkly AI

Al iniciar Linkly AI por primera vez, aparecerá un asistente de configuración que le guiará a través de 3 pasos de inicialización:

<Steps>
  <Step title="Seleccionar los directorios a indexar">
    Seleccione los directorios de documentos que desea que Linkly AI indexe:

    * **Mis Documentos**: Indexar solo los documentos del directorio `~/Documents` o `Mis Documentos`
    * **Toda la computadora**: Escanear todos los documentos accesibles con la mayor cobertura posible; requiere autorización
    * **Carpeta personalizada**: Seleccionar manualmente una carpeta específica
  </Step>

  <Step title="Verificar permisos de acceso">
    El sistema verificará automáticamente los permisos de acceso de la carpeta seleccionada. Si los permisos son insuficientes (común en macOS), vaya a **Ajustes del Sistema → Privacidad y Seguridad → Acceso completo al disco**, agregue Linkly AI y reinicie la aplicación.
  </Step>

  <Step title="Conectar sus herramientas de IA">
    Agregue el servicio MCP de Linkly AI a sus herramientas de IA habituales para habilitar la búsqueda inteligente de documentos.

    <Card>
      Le recomendamos usar Skills para facilitar la integración. Esta es la forma más sencilla: simplemente copie el siguiente Prompt en su asistente de IA y siga las instrucciones para completar la integración de herramientas y Skills simultáneamente:

      <Prompt description="Por favor, instale el Agent Skill linkly-ai-skills y...">
        Por favor, instale el Agent Skill linkly-ai-skills y complete la integración de herramientas de LinklyAI, consulte: [https://linkly.ai/docs/es/use-skills](https://linkly.ai/docs/es/use-skills)
      </Prompt>
    </Card>

    También puede integrar manualmente las herramientas MCP, aunque seguimos recomendando [instalar Skills](use-skills) para obtener una mejor experiencia de uso:

    <Tabs>
      <Tab title="Claude Code">
        Ejecute en la terminal:

        ```bash theme={null}
        claude mcp add --transport http linkly-ai http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cursor">
        1. Abra Settings → MCP Servers → Add Server
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>

      <Tab title="Codex">
        Ejecute en la terminal:

        ```bash theme={null}
        codex mcp add linkly-ai --url http://127.0.0.1:60606/mcp
        ```
      </Tab>

      <Tab title="Cherry Studio">
        1. Abra Settings → MCP Servers → Add
        2. Name: `linkly-ai`
        3. Type: `StreamableHTTP`
        4. URL: `http://127.0.0.1:60606/mcp`
      </Tab>
    </Tabs>

    <Tip>El puerto `60606` 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.</Tip>
  </Step>
</Steps>

## Paso 3: Primer uso

Tras iniciar la aplicación, Linkly AI comenzará inmediatamente a indexar sus documentos y los monitoreará de forma continua. La indexación completa se completará en un periodo de entre unos minutos y varias decenas de minutos (dependiendo de la cantidad de documentos y el rendimiento del equipo).

<Note>
  En el primer inicio, es necesario descargar un archivo de modelo de aproximadamente 100 MB, lo que puede tardar desde unos minutos hasta varias decenas de minutos, pero esto no afecta el uso de la función de búsqueda por palabras clave.

  Una vez completada la descarga y la indexación completa, podrá utilizar la función de búsqueda por lenguaje natural.
</Note>

Tiene dos formas de usar LinklyAI:

<Card title="Buscar documentos con el lanzador" icon="keyboard">
  Puede hacer clic en el icono de la aplicación (logo L) en la bandeja del sistema, o usar el atajo global `CMD/Ctrl + Shift + L` para abrir la ventana del lanzador de búsqueda. Introduzca palabras clave o lenguaje descriptivo para encontrar documentos objetivo.

  También puede previsualizar, ver metadatos, abrir documentos, copiar enlaces y más. Para más información, consulte la [documentación del lanzador de búsqueda de texto completo](use-launcher).
</Card>

<Card title="Usar con AI Agent" icon="robot">
  Este es el método que más recomendamos, que le proporcionará una experiencia de interacción y eficiencia de investigación sin precedentes.

  Después de completar la integración con su asistente de IA o instalar [Skills](use-skills), agregue `use linkly-ai` después de cualquier Prompt para utilizar activamente las potentes capacidades de búsqueda de Linkly AI.
</Card>