Un lugar para hablar con tu agente.

01Antes de empezar

Crea una cuenta y una conversación en la app de pruebas internas de Pushyou a la que te invitaron. El acceso web requiere aprobar un QR en esa app. La guía de conexión permite elegir la conversación y comprobar la entrega.

Con OAuth eliges las conversaciones y permisos durante la aprobación; no necesitas otra clave API. Las claves de programa son una alternativa en Ajustes → Conexiones. Crear una conversación requiere acceso a todas las salas y conversations:write.

02Autenticación

El servidor usa Streamable HTTP. Con OAuth, el cliente abre un flujo de aprobación; confirma las conversaciones y permisos en Pushyou. Una clave de programa aplica los mismos controles. Mantén separadas las configuraciones OAuth y Bearer.

https://pushyou.app/mcp

Añade el servidor a ~/.codex/config.toml y ejecuta codex mcp login pushyou. Elimina la configuración Bearer existente para usar OAuth. También puedes usar el control de autenticación MCP de la aplicación o del IDE.

[mcp_servers.pushyou]
url = "https://pushyou.app/mcp"

03Comprueba un intercambio real

Empieza por pushyou_get_account y pushyou_list_conversations. Confirma la cuenta, los permisos y la sala antes de enviar. Sustituye YOUR_CONVERSATION_ID. Los ejemplos son argumentos de herramientas MCP, no cuerpos REST.

{}

{
  "limit": 20
}

{
  "conversation_id": "YOUR_CONVERSATION_ID",
  "id": "docs-mcp-message-01",
  "text": "Pushyou connection verified.",
  "notify": true
}

Responde en Pushyou y llama una vez a pushyou_get_events. Revisa events y next_cursor. Una llamada correcta no demuestra que el dispositivo recibiera una notificación. Conectar MCP tampoco mantiene al agente activo en segundo plano.

{
  "conversation_id": "YOUR_CONVERSATION_ID",
  "after": 0
}

Las listas MCP usan limit (1–50, 20 por defecto) y before. Los eventos usan after. Las listas de mensajes resumen las tarjetas; pushyou_get_message devuelve el contenido completo. Usa pushyou_get_media para fotos originales o rangos de bytes de archivos grandes.

04Respuestas y ejecución

Responde en la app y consulta los eventos. Tras procesar realmente una respuesta o acción ordinaria, guarda el resultado, envía su ACK y conserva next_cursor en almacenamiento persistente. El ACK no elimina el evento ni concede ejecución exclusiva. Usa un único programa de respuesta por sala o coordina los consumidores.

Las tareas reúnen aprobación y resultado. Tras la aprobación del propietario, un proceso consulta eventos con task_protocol=1, guarda su token de ejecución y reclama el intento. Mantiene la concesión con heartbeat y guarda el resultado real antes de complete. Completar también confirma el evento; un ACK independiente no termina una tarea pendiente.

Webhooks

También hay webhooks de respuesta firmados. Configúralos en los ajustes de Webhooks de respuesta de la app móvil. Verifica la firma del cuerpo original y evita duplicados por ID de entrega. HTTP 2xx confirma recepción, no finalización de la tarea. La guía de flujos detalla firmas y reintentos.

05Archivos y vistas

En MCP, llama a pushyou_prepare_media_upload con media_id, filename, content_type, tamaño en bytes y SHA-256. Envía los bytes originales mediante POST a upload.url, con los encabezados específicos devueltos, en cinco minutos. Después envía attachment_ids. REST ofrece la misma preparación. No sustituyas la autorización de carga por una clave de cuenta o token OAuth MCP.

Usa pushyou_set_view con una tarjeta report, actions o html para publicar una vista opcional. Envía view como null para retirarla. Se abre desde su conversación. El HTML no accede a redes externas, credenciales de la app ni almacenamiento del navegador; las acciones declaradas generan eventos en la misma sala.

Card =
  { type: "report", title: string, items: { title: string, body?: string, label?: string }[] }
| { type: "actions", title: string, body?: string, actions: { id: ID, label: string }[] }
| { type: "html", title: string, html: string, height?: integer, actions?: { id: ID, label: string }[] }

Field = { id: ID, label: string, type: "text" | "multiline" | "number" | "date" | "select" | "checkbox", required?: boolean, options?: string[], min?: number, max?: number }

06Referencia de herramientas

Estas son las herramientas del servidor. La respuesta autenticada de tools/list incluye solo las permitidas para tu conexión, con sus esquemas de entrada actuales. Se comprueba el acceso a la sala en cada llamada.

07Solución de problemas

Los errores REST devuelven un estado distinto de 2xx y {"error": "…"}. El cliente muestra los errores MCP; revisa el error estructurado y los permisos de la conexión.