Para los usuarios avanzados de macOS, desarrolladores de software y directores técnicos, Raycast se ha convertido en el centro neurálgico indiscutible del flujo de trabajo diario. Sin embargo, muchos usuarios continúan interactuando con Raycast AI como si fuera un simple chatbot conversacional aislado, limitándolo a la generación de texto plano y alternando manualmente entre GitHub, Linear, Notion, la terminal y Finder para aplicar los resultados.
Raycast rompe esta limitación mediante AI Tools (también conocidas en la documentación oficial como AI Extensions). Aprovechando la llamada nativa a funciones (Function Calling) integrada directamente en AI Chat y Quick AI, modelos avanzados como Claude 3.5 Sonnet y GPT-4o pueden descubrir, consultar y ejecutar acciones de forma autónoma tanto en herramientas locales del sistema como en extensiones SaaS de terceros.
Esta guía detalla cómo instalar extensiones compatibles con herramientas, invocar y encadenar consultas mediante la sintaxis @, establecer reglas de seguridad y permisos con Auto-review, afinar el comportamiento con instrucciones personalizadas y conectar servidores MCP (Model Context Protocol) para convertir tu Mac en un centro de comando agentico de alto rendimiento.
1. Requisitos previos y arquitectura de funcionamiento
Antes de configurar AI Tools, es importante comprender los requisitos operativos y la mecánica interna de Raycast:
- Suscripción a Raycast Pro: El uso de AI Tools y AI Chat completo requiere una suscripción activa a Raycast Pro. Este plan desbloquea el acceso a modelos de frontera (como Claude 3.5 Sonnet y GPT-4o), ventanas de contexto ampliadas y el motor de ejecución de herramientas.
- Selección de modelos con soporte de herramientas: No todos los modelos gestionan llamadas a funciones con la misma fiabilidad. En Settings → AI → Models o en la barra lateral de AI Chat, asegúrate de utilizar un modelo con soporte nativo de llamadas a herramientas y capacidad de razonamiento lógico.
- Comandos estándar frente a AI Tools: Los comandos convencionales de Raycast se abren en la interfaz principal para mostrar vistas de usuario (como listas o formularios). En cambio, las AI Tools son funciones de fondo sin interfaz gráfica que las extensiones declaran para que el modelo de IA las invoque con argumentos estructurados según la intención del usuario.
2. Descubrimiento e instalación de extensiones con herramientas
Raycast incluye un repertorio de herramientas locales listas para usar y permite ampliar el catálogo conectando servicios externos desde la Raycast Store.
Herramientas locales integradas del sistema
Las siguientes herramientas están activas en macOS sin necesidad de configuraciones adicionales:
@finder: Busca, examina y gestiona archivos y carpetas locales en el Finder.@file-search: Búsqueda instantánea de archivos locales impulsada por el índice del sistema.@terminal: Ejecuta scripts y comandos de shell, analizando las salidas devueltas directamente en el chat.@clipboard: Consulta el historial del portapapeles, extrae fragmentos específicos y actualiza su contenido.@browser: Lee e interpreta el árbol DOM de la pestaña activa en tu navegador (requiere instalar la extensión gratuita Raycast Browser Companion).@screen-awareness: Captura el contexto de la aplicación activa en primer plano, el texto seleccionado y capturas de pantalla.@calendar: Revisa próximas reuniones, compromisos en agenda y bloques de tiempo libre.@raycast-notes: Consulta, crea y actualiza notas en el espacio integrado de Raycast Notes.
Instalación de extensiones de terceros mediante filtros de la tienda
Para vincular Raycast AI con herramientas colaborativas como GitHub, Linear, Jira o Notion:
- Abre el buscador raíz de Raycast mediante tu atajo habitual (como
⌥ Espacioo⌘ Espacio). - Escribe
Storey presiona Enter. - Presiona
⌘ Ppara desplegar el selector de categorías en la barra de navegación. - Selecciona la categoría AI Extensions. Esto filtrará exclusivamente las extensiones que declaran puntos de acceso a herramientas para la IA.
- Selecciona la extensión deseada (por ejemplo, GitHub, Linear, Notion, Todoist o Spotify) y presiona Enter para instalarla.
- Completa el proceso de autenticación. Al instalarse, la extensión te guiará para iniciar sesión mediante OAuth o solicitará tu clave de API o Personal Access Token (PAT).
3. Invocación y encadenamiento de herramientas en AI Chat
Una vez instaladas, las extensiones registran sus herramientas de manera inmediata en el contexto del asistente. Se pueden utilizar tanto en AI Chat (comando AI Chat o mediante ⌘ J desde Quick AI) como en consultas rápidas.
La sintaxis de mención @
En el compositor de AI Chat, escribe @. Aparecerá un menú desplegable con todas las herramientas y extensiones activas instaladas en tu equipo. Elige una de la lista o escribe su alias:
@github Muestra los pull requests abiertos donde se solicita mi revisión y resume los comentarios que bloquean la aprobación.
@linear Crea una incidencia con título "Implementar limitación de tasa en webhooks" con prioridad alta en el equipo Platform.
@browser Resume la página de documentación de API que tengo abierta en el navegador y destaca los cambios incompatibles.
Al presionar Enter, el modelo evalúa los parámetros necesarios y ejecuta la llamada en segundo plano. En la ventana de conversación aparece una tarjeta interactiva que muestra los parámetros enviados y la respuesta estructurada devuelta por el servicio.
Encadenamiento de múltiples herramientas en un solo prompt
El verdadero salto de productividad para perfiles técnicos reside en coordinar múltiples herramientas en una única instrucción:
@calendar @linear Revisa si tengo bloques libres de más de una hora esta tarde; de ser así, lista las tareas de Linear asignadas a mí en el ciclo actual para avanzar en ellas.
@terminal @github Revisa el git status en mi directorio actual, resume los commits recientes y redacta una descripción estándar para abrir un PR en GitHub.
El modelo planifica las etapas de manera secuencial: consulta primero el calendario o el repositorio local, integra esas salidas intermedias en su contexto y después ejecuta la acción correspondiente en Linear o redacta el contenido para GitHub sin requerir copiar y pegar datos manualmente.
4. Configuración de permisos, reglas de Auto-review y seguridad
Dado que las AI Tools pueden ejecutar comandos de terminal, alterar estructuras de archivos y modificar registros en plataformas remotas, Raycast implementa un sólido marco de seguridad para prevenir ejecuciones accidentales.
Modos globales de permisos
Accede a Settings → AI → Tools para definir la postura de seguridad global:
| Modo de permiso | Comportamiento | Perfil recomendado |
|---|---|---|
| Ask | Solicita confirmación explícita antes de ejecutar cualquier acción que no sea de solo lectura o no esté previamente autorizada. | Entornos corporativos estrictos; equipos con políticas de seguridad elevadas |
| Auto (Predeterminado en Pro) | Evalúa automáticamente el riesgo. Permite consultas seguras de solo lectura y pausa para pedir confirmación ante modificaciones o credenciales. | Desarrolladores; usuarios avanzados; equilibrio ideal entre velocidad y control |
| Always Allow | Ejecuta todas las herramientas de forma inmediata sin mostrar ventanas de confirmación. | Entornos de pruebas aislados (sandboxes); automatizaciones desatendidas |
Criterios de evaluación en el modo Auto
El motor Auto distingue con claridad entre acciones seguras y sensibles:
- Aprobación automática sin confirmación: Consultas de solo lectura (leer incidencias, ver eventos de calendario, buscar archivos), modificaciones de archivos restringidas al directorio de trabajo activo del chat, y comandos seguros de desarrollo (como
git status,git log,npm test). - Pausa obligatoria para confirmación: Acciones destructivas (eliminar archivos, borrar registros, cerrar incidencias masivamente), scripts que alteren la configuración del sistema, o intentos de acceder a credenciales privadas (archivos
.env, claves SSHid_rsao claves de nube).
Puedes personalizar estos comportamientos en Settings → AI → Tools mediante Auto-review Rules, vinculando acciones específicas a "Allow automatically" o "Ask first".
Interfaz de aprobación y atajos de teclado
Cuando una herramienta requiere autorización, la conversación se detiene y muestra una tarjeta descriptiva:
- Presiona
Enter: Permitir una vez (Allow), autorizando únicamente esta invocación. - Presiona
⌘ Enter: Permitir siempre (Always Allow). La herramienta se añade a Globally Allowed Tools y no volverá a pedir permiso en el futuro. - Presiona
Esc: Denegar (Deny). El modelo recibe la negativa y continúa la conversación buscando vías alternativas. - Para comandos de
@terminal, haz clic en Show Command para auditar el comando CLI exacto antes de autorizar su ejecución.
Anulación de permisos por conversación
Si necesitas aplicar una política de seguridad distinta en una conversación puntual sin alterar la configuración global, abre la barra lateral de ajustes dentro de la ventana de AI Chat (o presiona ⌘ K y selecciona Change Permissions…) para alternar entre Inherited, Ask, Auto y Always Allow.
5. Ajuste del comportamiento con instrucciones personalizadas
Al interactuar con servicios como Linear o GitHub, los modelos carecen de conocimiento sobre convenciones de tu equipo o restricciones de horario. Raycast permite definir Custom Instructions individuales por extensión:
- Ve a Raycast Settings → Extensions.
- Selecciona la extensión instalada en la lista lateral (por ejemplo, Linear o Calendar).
- En el panel derecho, localiza la herramienta identificada generalmente como Ask.
- Despliega la herramienta y busca el campo de texto libre Custom Instructions.
- Escribe las directrices de contexto que el modelo debe respetar siempre que interactúe con esa extensión.
Ejemplos prácticos de configuración
Para Linear:
Por defecto, asigna todas las búsquedas y creaciones de incidencias al equipo "Platform Engineering". Al crear tickets, asigna prioridad "Medium" a menos que se indique urgencia explícita, y vincula la tarea al ciclo activo.
Para Calendar:
Nunca programes ni propongas reuniones antes de las 10:00 AM ni después de las 5:30 PM. Asegura siempre un espacio de amortiguación mínimo de 15 minutos entre eventos consecutivos.
Para GitHub:
Filtra las consultas de pull requests exclusivamente dentro de la organización "octocorp-dev". Ignora los PR automáticos generados por dependabot al compilar elementos pendientes de mi revisión.
Una vez guardadas, Raycast inyecta estas instrucciones en el contexto de la IA en cada invocación de @linear o @calendar, ahorrándote repetir restricciones en cada solicitud.
6. Integración avanzada: Model Context Protocol (MCP)
Si las extensiones de la tienda pública no cubren tus bases de datos privadas, APIs internas o microservicios de desarrollo, los usuarios avanzados pueden conectar servidores Model Context Protocol (MCP) directamente en Raycast.
- Abre el buscador de Raycast y ejecuta el comando Install MCP Server (o dirígete a Manage MCP Servers → Install New Server).
- Configura los parámetros del servidor:
- Name & Icon: El nombre e icono con el que se invocará mediante
@en el chat. - Transport: Elige Standard Input/Output (stdio) para procesos locales ejecutados en tu máquina o HTTP para servidores remotos.
- Command & Arguments: Para herramientas locales, define el ejecutable y sus argumentos (por ejemplo,
npx -y @modelcontextprotocol/server-postgreso un script local de Python). - Environment: Introduce variables de entorno con credenciales de conexión o tokens de API.
- Name & Icon: El nombre e icono con el que se invocará mediante
- Guarda la configuración con
⌘ Enter. Raycast iniciará el proceso en segundo plano, leerá el esquema de herramientas mediante JSON-RPC y las incorporará a AI Chat.
Los servidores MCP se utilizan exactamente igual que las extensiones nativas: puedes escribir @postgres Consulta los usuarios activos de los últimos 7 días manteniendo el control estricto de permisos y auditoría.
7. Consejos de productividad para usuarios avanzados
- Asigna un atajo global dedicado: Configura una combinación de teclas exclusiva para AI Chat en
Settings → Extensions → AI → AI Chat(como⌥ Co⌃ Espacio) para invocar tu centro de herramientas desde cualquier pantalla de macOS sin fricción. - Aprovecha la conciencia de pantalla y texto seleccionado: Selecciona un registro de error en tu terminal o editor, abre Quick AI e introduce
@github busca incidencias resueltas con este mensaje de errorpara enlazar contexto local y plataformas remotas al instante. - Audita periódicamente las herramientas permitidas: Revisa
Settings → AI → Tools → See Allow List. Si actualizas extensiones o cambian tus políticas de seguridad, utiliza Reset All para restablecer las confirmaciones paso a paso.
Configurar adecuadamente Raycast AI Tools transforma el clásico buscador de escritorio en un agente autónomo e integrado, capaz de coordinar tu sistema operativo local y tus plataformas SaaS mediante comandos de teclado naturales y precisos.