Integraciones de MYOPL
Desarrolla con MYOPL
Crea una integración con MYOPL mediante el endpoint MCP público o personal que aparece a continuación. Aquí encontrarás documentación del protocolo, permisos OAuth y contratos de API legibles por máquinas. Para configurar tu aplicación de IA paso a paso, utiliza Conecta tu IA.
Publicado Actualizado
MCP público
Utiliza MCP Streamable HTTP sin estado con JSON-RPC mediante HTTP POST. Empieza con initialize y después utiliza tools/list y tools/call. El acceso público no requiere una cuenta de MYOPL, clave de API ni inicio de sesión con OAuth.
- prepare_pickleball_browse: Buscar canchas públicas, clubes, sesiones de juego abierto o destinos de clasificaciones en un lugar indicado; no muestra disponibilidad en tiempo real ni permite reservar.
- search_pickleball_rules: Buscar extractos del reglamento oficial USA Pickleball 2026 con citas.
- search_myopl_help: Buscar ayuda del producto.
- search_myopl_website: Buscar información pública del sitio web de MYOPL.
- get_public_player_rating: Consultar ratings exactos de cuatro decimales, índice de fiabilidad, partidos jugados/ganados/perdidos y puntos ganados/perdidos por nombre de usuario. Los clientes compatibles pueden mostrar una tarjeta de rating de MYOPL.
MCP personal (OAuth)
Conecta la cuenta de MYOPL de un usuario con su consentimiento mediante OAuth con código de autorización y PKCE S256. Las conexiones personales están disponibles con MYOPL Plus y planes superiores.
Descubre el recurso protegido y el servidor de autorización y después utiliza una identidad de cliente publicada compatible o el registro dinámico de clientes. Los usuarios inician sesión en MYOPL y aprueban los permisos solicitados; no deberían tener que introducir un identificador ni un secreto de cliente de desarrollador.
Solicita solo los permisos que necesita tu integración. Utiliza el token de renovación cuando caduque el acceso, guarda de forma segura los nuevos tokens de renovación y vuelve a intentarlo tras los límites temporales de solicitudes. Los usuarios pueden desconectar el acceso en Messenger, en Ajustes > OPL Intelligence.
| Permiso OAuth | Acceso |
|---|---|
| myopl:rating:read | Leer los OPL Ratings publicados del usuario. |
| myopl:sessions:read | Buscar las sesiones de liga del usuario. |
| myopl:rsvp:write | Preparar una confirmación de asistencia para su aprobación explícita en MYOPL. |
| myopl:statistics:read | Leer las tarjetas de estadísticas propias del usuario; no requiere mejorar el plan. |
Implementa tu cliente MCP
Utiliza MYOPL como fuente de datos estructurados de pickleball en tu asistente o aplicación. Desarrolla con los esquemas publicados de las herramientas y los registros devueltos para presentar la información de MYOPL en tu propia interfaz.
- Negocia el protocolo: Llama a initialize y después envía la cabecera MCP-Protocol-Version negociada. Envía JSON-RPC mediante POST con Content-Type: application/json y Accept: application/json, text/event-stream.
- Descubre antes de llamar: Consulta tools/list y valida los argumentos según cada inputSchema. Utiliza tools/call con el nombre exacto de la herramienta; lee structuredContent para los datos de la aplicación y content para la alternativa de texto.
- Muestra una sola tarjeta: Los clientes compatibles con MCP Apps pueden usar resources/list y resources/read con los metadatos de interfaz de la herramienta de rating. Los demás deben mostrar los ratings y totales devueltos en texto. Conserva los valores exactos, distingue null de cero e incluye enlaces a las fuentes de MYOPL.
- Gestiona cada tipo de error: Lee los errores JSON-RPC y los resultados isError de las herramientas. Respeta Retry-After en HTTP 429. Para el acceso personal, renueva los tokens caducados mediante OAuth en lugar de pedir al usuario que inicie sesión repetidamente.
- Verifica el flujo completo: Prueba la consulta de datos actuales, la tarjeta o alternativa de texto, el inicio de sesión, la renovación de tokens y la desconexión por el usuario en cada cliente compatible. Una respuesta correcta de una herramienta no verifica por sí sola la visualización o renovación de todos los clientes.
Integraciones de servidor y HMAC
El acceso de servidor se revisa por separado. Las integraciones aprobadas reciben un identificador de cliente y un secreto compartido de firma mediante un proceso seguro de incorporación. HMAC firma las solicitudes para que MYOPL pueda verificar el remitente y la integridad de la solicitud.
Guarda los secretos de firma en tu servidor. No deben incluirse en código del navegador, aplicaciones móviles ni pantallas de conexión de jugadores. Para solicitar acceso, rotación o una nueva integración, elige IA, API y Desarrolladores en el formulario de contacto. Incluye el nombre de tu aplicación, el caso de uso, las URL HTTPS exactas de retorno de OAuth y los permisos solicitados; no envíes secretos.