> ## 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.

# Usar Linkly AI en Raycast

> Integra la base de conocimiento local de Linkly AI en Raycast AI para que esta herramienta de productividad de macOS pueda buscar y leer tus documentos privados

## Requisitos previos

* [Raycast](https://raycast.com) instalado (requiere suscripción Raycast Pro para usar funciones de IA)
* [Linkly AI CLI](/docs/es/use-cli) instalado (Raycast solo admite transporte Stdio, es obligatorio usar la CLI)
* Linkly AI Desktop iniciado con el servicio MCP en ejecución

## Pasos de configuración

<Steps>
  <Step title="Abrir la extensión MCP">
    Busca **Install Server** en Raycast, o ve a **Raycast Store** para instalar
    la extensión MCP (si aún no está instalada).
  </Step>

  <Step title="Agregar Linkly AI">
    Ejecuta el comando **Install Server** y completa: - **Name**: `linkly-ai` -
    **Type**: `stdio` - **Command**: `linkly` - **Arguments**: `mcp`
  </Step>

  <Step title="Reiniciar Raycast">
    Tras guardar, sal completamente y reinicia Raycast para que la configuración
    surta efecto.
  </Step>
</Steps>

<Note>
  Raycast actualmente **solo admite transporte Stdio** y no admite URL HTTP. Por
  tanto, es obligatorio instalar primero Linkly AI CLI para que actúe como
  puente de comunicación con la aplicación de escritorio.
</Note>

## Empezar a usar

Una vez completada la configuración, en Raycast AI Chat escribe `@linkly-ai` para invocar la herramienta, o haz preguntas directamente y Raycast llamará automáticamente a las herramientas de Linkly AI. Por ejemplo:

* "Busca en mis documentos contenido sobre diseño de producto"
* "@linkly-ai read my project readme"

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="Indica que no encuentra el comando linkly">
    Raycast usa un entorno PATH independiente. Asegúrate de que el comando
    `linkly` esté instalado en una ruta estándar (como `/usr/local/bin` o
    `/opt/homebrew/bin`). Puedes ejecutar `which linkly` en la terminal para
    confirmar la ruta y asegurarte de que esté en el PATH de Raycast. Tras
    modificar el PATH, debes reiniciar Raycast completamente para que surta
    efecto.
  </Accordion>

  <Accordion title="La lista de herramientas está vacía">
    Confirma que Linkly AI Desktop esté iniciado y el servicio MCP en ejecución.
    Raycast se conecta a la CLI en cada llamada, por lo que la aplicación de
    escritorio debe estar en ejecución.
  </Accordion>
</AccordionGroup>