CompteamDocumentaciónUsar Compteam con agentes de IA

Usar Compteam con agentes de IA

Conecta un cliente MCP compatible para descubrir clases públicas de BJJ o gestionar de forma segura tu asistencia en Compteam.

Qué hace el servidor MCP de Compteam

El Protocolo de Contexto de Modelo (MCP) permite que agentes de IA compatibles utilicen un conjunto reducido y controlado de herramientas de Compteam. La búsqueda pública funciona sin cuenta. La información personal o de menores vinculados siempre requiere iniciar sesión en Compteam.

Disponible sin iniciar sesión

  • Buscar clubes de Compteam que publiquen un horario público de clases.
  • Ver las clases públicas de un club para una semana seleccionada.
  • Consultar los planes públicos de membresía de un club, con precio y periodicidad recurrentes y, si corresponde, la cuota de inscripción única.
  • Consultar datos públicos de una sede, como dirección, enlaces de contacto y redes sociales, idioma, moneda, políticas y enlaces para reservar, registrarse o visitar la página del club.

Disponible después de conectar tu cuenta de Compteam

Estas funciones conectadas a la cuenta solo están disponibles mediante el complemento de Compteam para ChatGPT/OpenAI o un cliente MCP registrado por Compteam. El atleta debe completar la autenticación de Compteam dentro del chat antes de que el cliente pueda acceder a datos personales o realizar acciones.

  • Ver tu propio perfil de miembro y los menores vinculados a tu cuenta.
  • Consultar próximas clases y un estado limitado de membresía o pagos.
  • Confirmar o cancelar una reserva para ti o para un menor vinculado.
  • Abrir y enviar una consulta para una clase de prueba gratuita elegible.

Registrar un cliente MCP

La búsqueda pública no requiere registro. Si tu cliente necesita herramientas conectadas a una cuenta, envíanos los datos siguientes. Revisamos cada cliente manualmente y respondemos con la configuración OAuth y el alcance aprobado.

  1. Añade el endpoint de Compteam y prueba primero la búsqueda pública.
  2. Envía los datos del cliente, los enlaces de seguridad y las URI OAuth exactas.
  3. Compteam confirma el registro del cliente y las capacidades disponibles.

Bootstrap OAuth para operadores de clientes

Utiliza este descriptor de solo lectura para descubrir el recurso MCP, los metadatos del servidor de autorización de Supabase, el método PKCE requerido y la ruta de solicitud de registro. Nunca crea credenciales ni concede acceso: Compteam debe aprobar y activar primero cada ID de cliente.

Abrir descriptor de bootstrap OAuth: https://api.compteam.io/api/v1/public/mcp-client-registration/bootstrap
Las integraciones de OpenAI y ChatGPT deben utilizar el proceso oficial de envío del marketplace de OpenAI. La integración de Compteam estará disponible próximamente: vuelve a consultar de vez en cuando para saber cuándo se publica. Utiliza este formulario para otros clientes MCP.

Solicitar el registro del cliente

No incluyas contraseñas, secretos de cliente, claves API ni datos de miembros.

Completa la comprobación de seguridad antes de enviar.

Al enviar este formulario, aceptas que Compteam utilice estos datos para revisar tu solicitud de cliente MCP y contactarte. Consulta nuestra política de privacidad para más información.

Full MCP clients only · registration_full

Registration flows for full MCP clients

These account, branch, membership, billing, and consent flows are supported through an explicitly approved full MCP client (`registration_full`) after the athlete authenticates in the chat. They are not available to anonymous, OpenAI/ChatGPT marketplace, or `marketplace_safe` clients.

  1. Adult first registration: create an athlete account, select an existing gym, or start a new unmanaged gym.
  2. Imported and managed-profile claims: match an invited or imported profile after account verification without creating a duplicate athlete.
  3. Joining an additional branch: keep one personal profile while adding membership at another gym.
  4. Guardian-led registration for children under 16: a guardian creates the child profile and gives required training consent.
  5. Athlete-created unmanaged gyms: an athlete can create a branch that starts unmanaged and remains claimable by a branch administrator.
  6. New branch registration and unmanaged-branch claiming: create a new organization/branch or claim an eligible unmanaged branch during admin setup.
  7. Membership-plan eligibility and approval gates: age/tier eligibility, self-subscription approval, and branch activation rules are checked before access is granted.
  8. Exact terms versions and required consent: the current branch terms version, privacy/data-processing consent, and any membership signature are recorded.
  9. SEPA mandate validation: IBAN, account-holder details, mandate authorization, and branch billing requirements are validated before a plan is submitted.
  10. Signup-fee clearance status: registrations can remain pending until the one-time signup fee is reconciled or explicitly cleared by the branch.
  11. Optional authenticated adult profile photo: an adult may upload a profile photo after authentication; it can be skipped and added later.

Full MCP client access (`registration_full`) is granted per registered client ID. After OAuth, the athlete must authenticate in the chat and the client must refresh its tool list before these registration tools appear. OpenAI/ChatGPT and marketplace_safe clients cannot create athletes, branches, memberships, mandates, or consents. Sensitive billing and photo fields stay in the secure registration form.

Conectar un cliente compatible

Los clientes compatibles con el Registro pueden encontrar Compteam por su nombre verificado. Otros clientes MCP pueden conectarse directamente al endpoint HTTPS.

Nombre en el Registro
io.compteam/compteam
Endpoint
https://api.compteam.io/mcp
Transporte
Streamable HTTP

Si el cliente acepta una entrada JSON de servidor MCP, utiliza esta configuración genérica:

{
  "mcpServers": {
    "compteam": {
      "type": "streamable-http",
      "url": "https://api.compteam.io/mcp"
    }
  }
}

Seguridad y límites de la cuenta

  • Las herramientas conectadas solo pueden acceder a tu perfil o a un menor ya vinculado a tu cuenta.
  • El agente debe pedir confirmación antes de cambiar una reserva o enviar una consulta de clase de prueba.
  • Los planes de membresía se muestran solo con fines informativos; no se puede contratar una membresía, pagar clases ni realizar pagos mediante este servidor MCP.
  • La autenticación utiliza la conexión OAuth del cliente. No pegues un token web normal de Compteam en un cliente MCP.

Ejemplos de preguntas

Después de añadir Compteam a tu agente, prueba:

  • “Busca clubes de Compteam con clases públicas de BJJ.”
  • “Muestra las clases públicas de este club para la próxima semana.”
  • “Muestra los planes de membresía y sus precios en este club.”
  • “Muéstrame la dirección, Instagram, las políticas y los enlaces públicos de reserva y registro de esta sede.”
  • “Muestra mis próximas clases de Compteam.”
  • “Cancela mi reserva para la clase de mañana.”
  • “Pregunta a este club por una clase de prueba gratuita.”