Cómo configurar PigeonCast MCP en Mac
Esta guía explica cómo instalar PigeonCast Tools en un Mac, conectar PigeonCast a asistentes de IA como Cursor, Claude Desktop, Codex y Windsurf, y usar instrucciones en lenguaje natural para controlar la aplicación PigeonCast.
Temas cubiertos:
Guía paso a paso
Instalar PigeonCast Tools en tu Mac
PigeonCast Tools funciona en macOS 13 o versiones posteriores, tanto en Mac con Apple Silicon como en Mac con procesador Intel.
Antes de empezar, asegúrate de que la aplicación principal PigeonCast esté instalada y pueda abrirse desde la carpeta Aplicaciones. El asistente de IA solo puede ayudarte cuando PigeonCast está en ejecución.
Paso 1: Abre la imagen del instalador de PigeonCast Tools (.dmg) que has descargado.
Paso 2: Haz doble clic en Install o Install.command.
Paso 3: Si tu Mac te solicita una contraseña, introduce tu contraseña de inicio de sesión y confirma.
Paso 4: Espera hasta que aparezca el mensaje que indica que la instalación ha finalizado.
Conectar PigeonCast a tu asistente de IA
Después de la instalación, añade la conexión de PigeonCast a la aplicación de IA que utilices con más frecuencia. Solo tienes que completar esta configuración una vez.
El instalador incluye una carpeta config con configuraciones de ejemplo para distintas aplicaciones. Sustituye la ruta de ejemplo por la ruta local real de pigeoncast-mcp en tu Mac. Después de guardar la configuración, cierra por completo la aplicación de IA y vuelve a abrirla.
Cursor
Paso 1: Abre Cursor y ve a Configuración -> MCP.
Paso 2: Añade un nuevo servidor MCP.
Paso 3: Pega el contenido del ejemplo de Cursor incluido en la carpeta config.
Paso 4: Guarda la configuración, cierra Cursor por completo y vuelve a abrirlo.
Paso 5: Comprueba que pigeoncast aparezca como conectado en la lista de MCP.
Claude Desktop
Paso 1: Cierra Claude por completo desde la barra de menús.
Paso 2: Abre con TextEdit el archivo de configuración de MCP de Claude. Se incluye un ejemplo en config/claude-desktop.
Paso 3: Añade la configuración de PigeonCast basándote en el ejemplo y guarda el archivo.
Paso 4: Vuelve a abrir Claude Desktop.
Windsurf
Paso 1: Abre la configuración relacionada con MCP en Windsurf.
Paso 2: Añade PigeonCast siguiendo el ejemplo de Windsurf incluido en la carpeta config.
Paso 3: Reinicia Windsurf.
Codex (OpenAI Codex)
Paso 1: Abre Codex y ve a Configuración -> MCP.
Paso 2: Añade un servidor MCP llamado pigeoncast.
Paso 3: Establece la ruta del programa en /usr/local/bin/pigeoncast-mcp. Si realizaste la instalación con Install, normalmente esta es la ruta correcta.
Paso 4: Guarda la configuración, cierra Codex por completo y vuelve a abrirlo.
Paso 5: Comprueba que pigeoncast esté habilitado en la configuración de MCP.
Si utilizas la línea de comandos de Codex, ejecuta:
codex mcp add pigeoncast -- /usr/local/bin/pigeoncast-mcp
codex mcp list
Otras aplicaciones de IA
Utiliza los ejemplos correspondientes de la carpeta config del instalador y añádelos en la configuración de MCP, Herramientas o Complementos de tu aplicación.
Usar instrucciones de PigeonCast listas para copiar
Cuando la conexión se haya establecido correctamente, asegúrate de que PigeonCast esté abierto y prueba instrucciones como las de los siguientes ejemplos.
Comprobar si PigeonCast está en ejecución
Comprueba si PigeonCast está en ejecución.
Buscar televisores o dispositivos de transmisión en tu red
Usa PigeonCast para buscar en mi red local dispositivos que puedan recibir una transmisión y muéstramelos en una lista.
Transmitir la pantalla de tu ordenador a un televisor
Usa PigeonCast para buscar dispositivos receptores disponibles, elige uno y transmite a él la pantalla de mi ordenador. Avísame si tengo que introducir el PIN o la contraseña que aparezca en el televisor.
Transmitir solo la ventana de una aplicación
Usa PigeonCast para buscar dispositivos y, a continuación, transmite la ventana de Safari al televisor del salón.
Sustituye Safari por el nombre de la aplicación que realmente quieras transmitir.
Detener la sesión de transmisión actual
Usa PigeonCast para detener la sesión actual de duplicación de pantalla.
Abrir la interfaz de PigeonCast
Abre la página Enviar pantalla de PigeonCast.
Abre la ventana principal de PigeonCast.
Ejecutar una acción combinada
Primero busca dispositivos de transmisión en mi casa, elige un televisor con PigeonCast e inicia la transmisión de mi pantalla principal. Si aparece un PIN en el televisor, recuérdame que debo introducirlo.
Solucionar problemas de permisos y conexión
Paso 1: Si la duplicación falla de inmediato, abre Ajustes del Sistema -> Privacidad y seguridad -> Grabación de pantalla y habilita para PigeonCast el permiso de grabación de pantalla.
Paso 2: Abre siempre PigeonCast antes de enviar instrucciones al asistente de IA.
Paso 3: Si el televisor solicita un PIN o una contraseña de AirPlay, indícale el PIN al asistente de IA o introdúcelo manualmente en la ventana de PigeonCast.
Paso 4: Cuando sea necesario, ajusta parámetros de duplicación como resolution, fps y quality directamente en el chat con la IA.
Paso 5: Si el asistente de IA no puede conectarse a PigeonCast, comprueba que PigeonCast esté abierto, cierra por completo la aplicación de IA, vuelve a abrirla e inténtalo de nuevo.
Nota: PigeonCast Tools te permite controlar la aplicación PigeonCast instalada mediante una conversación con una IA. No sustituye la instalación de la aplicación principal PigeonCast.
Obtener ayuda
Si sigues necesitando ayuda, utiliza los siguientes canales de asistencia.
- Sitio web oficial: https://pigeoncast.com
- Correo electrónico: feedback@falconai.com.cn