Cómo usar PigeonCast MCP

1. Anota la ruta de MCP. En las instalaciones realizadas desde el sitio web oficial, la ruta predeterminada es C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe; en la versión de Microsoft Store, es el archivo Tools\pigeoncast-mcp.exe incluido en el paquete de la aplicación. Puedes buscar este nombre de archivo en el directorio de instalación. a. Si marcaste Add to PATH durante la instalación desde el sitio web oficial, puedes ejecutar pigeoncast-cli ping directamente en el terminal. Para configurar MCP, se recomienda aun así utilizar la ruta completa a pigeoncast-mcp.exe, de modo que el cliente de IA siempre pueda encontrar el programa.
2. Cambia el valor de command en el JSON siguiente por la ruta real de pigeoncast-mcp.exe en tu equipo. Ten en cuenta que las barras invertidas deben escribirse como \ en JSON. Copia el JSON con la ruta corregida en la ventana de chat de la IA e indícale: Aplicar globalmente.
3. Después de guardar la configuración, vuelve a cargar MCP en el cliente correspondiente o reinicia la aplicación. A continuación, deberías ver en la lista de herramientas nombres que empiecen por host_, como host_ping, host_discovery_list_devices y host_mirror_start.
4. Comprobación rápida: dile a la IA: "Usa host_ping de PigeonCast para comprobar si la aplicación está en ejecución." Si el programa principal ya está en ejecución, debería indicar que la operación se realizó correctamente; de lo contrario, informará de que falló la conexión mediante canalización.

Opción A: solo el proyecto actual (recomendada para compartir en equipo)

1. Crea .cursor/mcp.json en la raíz del proyecto.
2. Pega la configuración de mcpServers de la sección anterior y establece command en la ruta absoluta de pigeoncast-mcp.exe en el equipo local.
3. Abre Cursor → Configuración → MCP, confirma que aparece el servidor pigeoncast y haz clic en Recargar o actualiza la vista.

Opción B: disponible para todos los proyectos

1. Ve a Cursor → Configuración → MCP → Añadir nuevo servidor MCP global.
2. Selecciona stdio como tipo, introduce la ruta completa de pigeoncast-mcp.exe como comando y deja los argumentos vacíos. Como alternativa, edita manualmente el archivo de configuración de usuario, que varía según la versión y suele ser %USERPROFILE%.cursor\mcp.json, con el mismo formato que en la sección anterior.

Consejos

1. Asegúrate de que la aplicación principal de PigeonCast esté en ejecución antes de pedir al agente que busque dispositivos o inicie la transmisión de pantalla.
2. Si Cursor todavía mantiene un proceso MCP antiguo, vuelve a cargarlo después de cambiar la configuración. Si el problema persiste, cierra Cursor por completo y vuelve a abrirlo.
3. Para consultar descripciones detalladas de las herramientas y escenarios de prueba, abre mcp-usage-for-testers.md en el repositorio.

Opción A: añadir desde la línea de comandos (recomendada)

Ejecuta lo siguiente en PowerShell y sustituye la ruta por la de tu instalación:claude mcp add --scope user pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe" Si quieres que solo esté disponible para el proyecto actual:

claude mcp add --scope project pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"

Para comprobar que se ha añadido correctamente:

claude mcp list

Opción B: editar el archivo de configuración

Ejemplo de .mcp.json:

{
  "mcpServers": {
    "pigeoncast": {
      "type": "stdio",
      "command": "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe",
      "args": []
    }
  }
}

Después de guardar, reinicia la sesión de Claude Code o ejecuta dentro de ella el comando para volver a cargar MCP, según la versión actual.

1. Cierra Claude Desktop por completo, incluido el proceso de la bandeja del sistema.
2. Edita el archivo de configuración. Si utilizas la instalación MSIX, usa la ruta que aparece más abajo en Leído realmente por la aplicación en lugar de editar únicamente el archivo que abre el botón Editar configuración; de lo contrario, puede que el cambio no surta efecto.
3. En el nivel raíz del archivo JSON, añade o combina mcpServers con la misma estructura que en la sección 2 y establece command en la ruta absoluta de pigeoncast-mcp.exe.
4. Guarda el archivo y reinicia Claude Desktop.
5. En Configuración → Desarrollador, confirma que pigeoncast aparece en la lista de servidores MCP.

Codex utiliza TOML para configurar MCP. El archivo predeterminado es %USERPROFILE%.codex\config.toml. En el ámbito del proyecto, puedes usar .codex/config.toml en la raíz de un repositorio de confianza.

Opción A: añadir desde la línea de comandos

codex mcp add pigeoncast -- "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"

Para ver la configuración actual:

codex mcp list

Opción B: editar config.toml Añade lo siguiente a ~/.codex/config.toml:

[mcp_servers.pigeoncast]
command = "C:\Program Files\PigeonCast\Tools\pigeoncast-mcp.exe"
args = []
enabled = true

Si utilizas un archivo .codex/config.toml en el ámbito del proyecto, debes marcar el proyecto como de confianza; de lo contrario, es posible que el servidor MCP local no se cargue. Documentación: servidores MCP de Codex (consulta la documentación actual de OpenAI en caso de duda)

Cualquier cliente que admita MCP mediante stdio y permita especificar la ruta de un ejecutable junto con sus argumentos puede utilizar la misma configuración básica:

• command: la ruta absoluta a pigeoncast-mcp.exe
• args: [] (déjalo vacío)
• env: normalmente no se necesitan variables de entorno adicionales Toma el bloque mcpServers de la sección 2 y adapta el nombre del archivo y los nombres de los campos al cliente de destino. Algunos clientes utilizan campos como type: "stdio".