PoYo MCP Server
Todos los modelos de PoYo, dentro de tu Agent de IA.
Conecta una sola vez para que Codex, Claude Code, Cursor y VS Code puedan buscar modelos de imagen, vídeo, audio, chat y 3D, consultar los Schema y precios públicos actuales y ejecutar tareas mediante PoYo.
MCP es una conexión segura que permite a tu Agent de IA usar modelos de PoYo sin que tengas que escribir solicitudes API.
npx -y @poyoapi/mcpPuente stdio local para VS Code o clientes que solo admiten stdio. Requiere Node.js 20+; usa la configuración inferior.
Configuración
Conecta en tres pasos. Abre la configuración avanzada solo si necesitas limitar categorías o modelos.
Prepara tu API Key
Primero crea una PoYo API Key. El cliente la usará al conectarse.
No pegues una API Key real en un archivo de configuración compartido ni en una URL.
Elige un cliente y localiza su configuración
Selecciona la aplicación que utilizas para ver una sola ubicación relevante.
Entrada recomendada
Abre Settings en Codex, entra en MCP servers, selecciona Add server y elige Streamable HTTP.
Ver instrucciones oficiales del clienteArchivo de configuración manual
~/.codex/config.tomlSe aplica a
Todos los proyectos del usuario actual
Abre la configuración MCP en el cliente. Si no hay una entrada visual, abre o crea el archivo indicado arriba.
Las rutas que empiezan por ./ están dentro del proyecto abierto. Crea la carpeta o el archivo si hace falta.
Añade la configuración y verifica
Copia la configuración del cliente seleccionado, recarga MCP y completa una verificación gratuita.
Combina la configuración existente; no la sobrescribas
Si el archivo ya contiene otros MCP Server, combina solo la entrada del servidor poyo y conserva todo el contenido existente.
Añade la siguiente configuración a ~/.codex/config.toml
[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Guarda tu API Key como variable de entorno POYO_API_KEY antes de iniciar el cliente. Después de guardar, inicia una nueva sesión de Codex para que vuelva a cargar la configuración MCP.
¿Cómo configuro POYO_API_KEY?
Copia el comando de tu sistema, sustituye your_api_key por la Key real e inicia el cliente desde la misma sesión de terminal.
macOS / Linux
export POYO_API_KEY="your_api_key"Windows PowerShell
$env:POYO_API_KEY="your_api_key"Estos comandos solo afectan a la sesión de terminal actual. No guardes la Key real en archivos del proyecto, capturas ni registros públicos.
Deja que tu Agent ayude con la configuración
Copia un Prompt seguro que conserve la configuración existente, mantenga la Key real fuera de los archivos y muestre el diff antes de escribir.
Verifica la conexión
Comprueba estos estados en orden. Ninguno inicia una tarea de modelo de pago.
- 1Las herramientas de PoYo aparecen en el cliente: la configuración se ha cargado.
- 2poyo_account devuelve la cuenta: la API Key funciona.
- 3poyo_search_models devuelve modelos: el catálogo está disponible.
¿La conexión no funciona?
- No aparecen herramientas: confirma la ubicación del archivo y recarga el MCP Server.
- Falló la cuenta: confirma POYO_API_KEY y reinicia el cliente desde el mismo entorno.
- Falló la conexión: confirma https://api.poyo.ai/mcp y que la red o el proxy permiten acceso HTTPS.
Cuando las herramientas, la cuenta y el catálogo pasan la comprobación, PoYo MCP está conectado.
Hay 8 herramientas compactas disponibles por defecto
No es necesario seleccionar modelos primero. El Agent busca en el catálogo y después consulta Schema y precios.
poyo_search_modelspoyo_get_model_schemapoyo_get_pricingpoyo_chatpoyo_run_modelpoyo_submit_jobpoyo_check_jobpoyo_account
Endpoint
https://api.poyo.ai/mcp[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45Las configuraciones usan una variable de entorno o una entrada segura. La API Key nunca aparece en la URL.
¿Qué puede hacer un Agent con PoYo MCP?
Describe una tarea en lenguaje natural. El Agent busca un modelo adecuado, consulta sus entradas y precio, lo ejecuta y devuelve el resultado cuando termina una tarea larga.
Descubrir modelos
Buscar modelos actuales de imagen, vídeo, audio, chat o 3D a partir de una tarea en lenguaje natural
poyo_search_modelsConsultar entradas
Consultar el Schema de entrada, ejemplos, protocolos y capacidades actuales
poyo_get_model_schemaComprobar precios
Consultar el precio público actual antes de ejecutar una solicitud de pago
poyo_get_pricingEjecutar tareas cortas
Completar tareas de chat o generación que responden tras una espera breve
poyo_chatpoyo_run_modelContinuar tareas largas
Enviar una tarea larga, conservar su task_id y consultar después el estado y las salidas
poyo_submit_jobpoyo_check_jobConsultar la cuenta
Consultar la información actual de la cuenta y los créditos antes de ejecutar un modelo
poyo_account¿Cuándo conviene usar MCP, CLI o REST API?
Usa MCP cuando un Agent deba elegir y llamar modelos, PoYo CLI para automatización en terminal o CI y REST API para tráfico de aplicaciones o salida token a token.
Asistente de IA o Agent de programación
Elegir
MCP
Streamable HTTPPor qué encaja
Permitir que un Agent descubra modelos, consulte Schema y precios y llame herramientas dentro de un editor o conversación.
Scripts de terminal o CI
Elegir
PoYo CLI
@poyoapi/cliPor qué encaja
Descubrir modelos, ejecutar generaciones, esperar tareas y emitir JSON, JSONL o CSV desde el shell.
Backend de tu aplicación
Elegir
REST API
HTTP + JSON / SSEPor qué encaja
Gestionar tráfico de aplicaciones, streaming de tokens, polling, webhooks y tareas por lotes.
Preguntas frecuentes
Información sobre conexiones MCP, API Key, alcance de herramientas, facturación y recuperación de tareas largas.
Crea una API Key, sigue la documentación MCP para añadir PoYo a tu cliente y consulta tu cuenta, el Schema del modelo y el precio público.