Índice
¿Qué es el MCP de Golfmanager?
El MCP (siglas de Model Context Protocol) es un idioma común que hablan los asistentes de inteligencia artificial —como ChatGPT o Claude— para conectarse con programas externos. Es, dicho en corto, un enchufe estándar: si un programa ofrece un MCP, cualquier asistente que hable ese idioma puede usarlo.
El MCP de Golfmanager es ese enchufe aplicado a tu club. Cuando lo conectas, el asistente deja de ser una herramienta que solo escribe texto y pasa a poder consultar y trabajar con los datos reales de tu club: reservas, clientes, ventas, bonos, stock… y todo ello sin salir de la conversación.
Es importante entender una cosa desde el principio: el asistente no recibe una copia de tu base de datos. Lo que hace es pedirle cosas a Golfmanager en el momento, igual que haría una persona entrando en la aplicación, y Golfmanager le responde. Cada petición lleva una credencial que dice quién es y de qué club, y el asistente solo puede hacer exactamente lo que ese usuario podría hacer con su ratón.
¿Qué problema resuelve?
El día a día del club está lleno de preguntas que exigen entrar en una pantalla, filtrar, exportar y comparar. Con el MCP conectado, esas preguntas se hacen hablando:
"¿Cuántas reservas tengo mañana por la mañana y cuántos huecos quedan libres?"
"Búscame los clientes que no han venido desde enero."
"Créame la reserva de este grupo de cuatro para el sábado a las 10:00."
"Genera un link de pago para estas dos ventas y dime cuál es la URL."
"Recárgale 50 € de bono a este socio."
"Compárame la ocupación de julio con la del año pasado."
El beneficio no es solo la comodidad: es que desaparece el paso intermedio de exportar a Excel y cuadrar a mano. El asistente pregunta, cruza y te da la respuesta ya trabajada, con los datos de este momento.
¿Qué sistemas conecta y en qué sentido van los datos?
La conexión une dos sistemas:
Tu Golfmanager (tu club, y solo tu club).
Tu asistente de IA: ChatGPT o Claude, con tu propia cuenta.
El sentido de los datos es este:
Tú le pides algo al asistente en lenguaje normal.
El asistente traduce esa petición a una llamada al MCP de Golfmanager, enviando tu credencial.
Golfmanager comprueba la credencial y los permisos del usuario y ejecuta la petición.
Golfmanager devuelve el resultado (los datos, o la confirmación de lo que se ha creado).
El asistente te lo explica en lenguaje normal.
ℹ️ La conexión la inicia siempre el asistente. Golfmanager nunca envía nada por su cuenta a ChatGPT ni a Claude: solo contesta cuando le preguntan, y solo a quien lleva una credencial válida de tu club.
¿Qué puede hacer el asistente con tu club?
Al conectarse, el asistente recibe una lista de herramientas disponibles. Agrupadas por temas, son estas:
Consultar y descubrir
Ver qué información existe en tu club y qué campos tiene cada ficha (clientes, reservas, ventas, productos…).
Ver la configuración del club: idioma, moneda, zona horaria y módulos instalados.
Listar y buscar fichas con filtros, orden y paginación, y abrir una ficha concreta.
Reservas
Buscar disponibilidad (huecos y tee times) con sus precios.
Crear reservas, individuales o en grupo.
Anular reservas, con o sin aviso al cliente.
Sacar estadísticas de reservas por rango de fechas, por día o por recurso.
Ventas y cobros
Crear un link de pago para una o varias ventas.
Cobrar ventas con una forma de pago.
Anular ventas.
Crear o modificar una venta (en estado borrador o pendiente).
Bonos y stock
Recargar el bono de un cliente.
Crear un pedido de compra a proveedor con sus líneas.
Regularizar el stock de un producto en un almacén.
El resto de la aplicación
Existe además una herramienta general que permite al asistente llamar a cualquier otra función de la API de Golfmanager que no esté en la lista anterior, para casos concretos o de módulos específicos.
⚠️ Ojo: no todo es consultar. Varias de estas herramientas escriben de verdad en tu club: crean reservas, anulan ventas o mueven stock. No son simulaciones. Léelo como si le dieras a alguien el ratón: puede hacer lo mismo que tú.
Requisitos previos (incluida la cuenta de pago)
Tener el módulo MCP instalado en tu Golfmanager. Si no lo tienes, escríbenos a support@golfmanager.com y lo activamos.
Tener tu propio usuario de Golfmanager con acceso a la aplicación. La credencial se crea desde tu ficha de usuario y solo para ti: nadie puede crear una credencial "en nombre de" otra persona.
Una cuenta de pago en el asistente. Ni ChatGPT ni Claude permiten conectar servidores MCP propios en sus planes gratuitos de forma completa. En la práctica necesitas: ChatGPT Plus, Pro, Business, Enterprise o Edu, o bien Claude Pro, Max, Team o Enterprise.
Que tu Golfmanager sea accesible desde internet (lo normal si trabajas con la versión en la nube): el asistente se conecta desde fuera, no desde el ordenador del club.
Un poco de cuidado con los permisos. El asistente hereda los permisos de tu usuario. Si tu usuario es administrador, el asistente también lo será.
💡 Recomendación: si vas a hacer pruebas, plantéate crear un usuario de Golfmanager con permisos limitados (por ejemplo, solo consulta) y generar la credencial desde ese usuario. Así el asistente ve lo que necesita y nada más.
Paso 1 — Crear tu credencial en Golfmanager
La credencial es la llave que identifica al asistente ante tu club. Se crea una vez, se copia y se pega en el asistente.
Entra en Golfmanager con tu usuario.
Ve a Configuración > Usuarios y abre tu propio usuario (solo funciona en tu ficha; en la de otra persona el botón se negará).
Busca la tarjeta Credenciales MCP y pulsa Nueva credencial.
Ponle un nombre que te diga en qué aparato o en qué asistente la vas a usar (por ejemplo, "Claude del portátil de recepción" o "ChatGPT de dirección"). Golfmanager propone uno por defecto según el aparato desde el que entras.
Pulsa Aceptar. Se abre una ventana con el token (una cadena larga de letras y números) y con la dirección del servidor.
Copia el token con el botón de copiar y pégalo donde lo vayas a usar.
⚠️ El token se enseña una sola vez. Golfmanager no guarda el token, solo una huella suya que sirve para reconocerlo. Si cierras esa ventana sin copiarlo, no hay forma de recuperarlo: habrá que revocar la credencial y crear otra. No pasa nada grave, pero es un minuto perdido.
Esa misma ventana trae, en pestañas, el texto ya preparado para pegar en varios asistentes: "Cualquier agente" (los datos sueltos), "Claude Code" (el comando completo) y "Codex" (el bloque de configuración). Los dos datos que necesitarás siempre son:
La URL del servidor MCP, con la forma https://tuclub.golfmanager.com/api/mcp (la que aparezca en la ventana, con el dominio de tu club).
El header de autorización: Authorization: Bearer <tu token>.
Y un dato más que a veces piden: el tipo de transporte es HTTP (streamable).
Paso 2 — Conectarlo a Claude
En Claude, los servidores MCP se llaman conectores (connectors). Hay tres caminos según cómo uses Claude.
Opción A — Claude en la web o en la aplicación de escritorio (plan Pro o Max)
Entra en Claude con tu cuenta y abre los Ajustes.
Ve a la sección Conectores (Connectors).
Pulsa + y elige Añadir conector personalizado (Add custom connector).
En la URL del servidor, pega la URL que encontrarás en la pestaña Seguridad > Usuarios > Credenciales MCP en la sección 'Conectar Claude o ChatGPT'.
Abre los Ajustes avanzados y, en el apartado de headers de la petición, añade uno llamado Authorization con el valor Bearer <tu token> (la palabra Bearer, un espacio y el token).
Pulsa Añadir y, al volver, activa el conector.
Opción B — Claude en un equipo o empresa (planes Team y Enterprise)
El conector lo añade el propietario (Owner) de la organización, no cada usuario.
El propietario entra en Ajustes de la organización > Conectores, pulsa Añadir, elige Personalizado y rellena la URL y el header igual que arriba.
Después, cada usuario lo ve en sus propios Conectores y solo tiene que pulsar Conectar.
Opción C — Claude Code (para usuarios técnicos)
Si trabajas con Claude Code, la ventana del token te da el comando ya hecho. Tiene esta forma:
claude mcp add --transport http tuclub https://xxxxx.com/api/mcp --header "Authorization: Bearer <tu token>"
ℹ️ Sobre los headers en Claude: la opción de pegar un token fijo como header está disponible pero es relativamente nueva en la interfaz de Claude, y su ubicación exacta dentro de "Ajustes avanzados" puede cambiar de una versión a otra. Si no la encuentras, busca "MCP" o "conector" en el buscador de los ajustes.
Paso 3 — Conectarlo a ChatGPT
En ChatGPT hay que elegir bien por dónde se conecta, porque no todas las versiones admiten el mismo tipo de llave.
Opción A — Aplicación de escritorio de ChatGPT (la vía recomendada)
🚨 ChatGPT no permite crear conectores personalizados hasta activar el Modo desarrollador. Para ello debes dirigirte a: Foto de perfil → Configuración → Aplicaciones y conectores → Configuración avanzada → Modo desarrollador.
Requiere una cuenta de pago: Plus, Pro, Team, Enterprise o Edu.
En cuentas Team o Enterprise, el administrador del workspace debe haber habilitado esta opción en los permisos.
Una vez hayas configurado el modo desarrollador:
Abre la aplicación de escritorio de ChatGPT con tu cuenta de pago.
Entra en los Ajustes y busca el apartado de servidores MCP (dentro de conectores / aplicaciones, según la versión).
Pulsa Añadir servidor.
Ponle un nombre (por ejemplo, el de tu club).
En tipo, elige Streamable HTTP (no STDIO).
En URL, pega https://tuclub.golfmanager.com/api/mcp.
En los headers, añade Authorization con el valor Bearer <tu token>.
Guarda y comprueba que el servidor aparece como conectado y con sus herramientas listadas.
Opción B — Codex (CLI o extensión del editor)
Codex comparte la configuración de servidores MCP con la aplicación de escritorio. En su fichero de configuración ~/.codex/config.toml hay que añadir un bloque con estas tres líneas (la ventana del token lo trae ya escrito):
[mcp_servers.tuclub]url = "https://tuclub.golfmanager.com/api/mcp"http_headers = { "Authorization" = "Bearer <tu token>" }
Lo que hoy NO funciona: los conectores del ChatGPT web
ChatGPT en el navegador permite añadir conectores personalizados activando el modo desarrollador (Ajustes > Aplicaciones y conectores > Avanzado). Sin embargo, ese formulario solo admite hoy dos tipos de identificación: OAuth o ninguna. No permite pegar un token fijo como el de Golfmanager.
⚠️ Conclusión práctica: para usar el MCP de Golfmanager con ChatGPT, hazlo desde la aplicación de escritorio (o desde Codex). Desde el ChatGPT del navegador no es posible por ahora, porque no hay dónde escribir el token. Es una limitación de ChatGPT, no de Golfmanager.
Cómo comprobar que funciona
En el asistente, comprueba que el servidor aparece conectado y que muestra una lista de herramientas (buscar disponibilidad, listar fichas, crear reserva…).
Hazle una pregunta inofensiva de solo lectura, por ejemplo: "¿Qué configuración tiene mi club: moneda, idioma y módulos instalados?" o "Dime cuántas reservas hay mañana". Si responde con datos reales, la conexión funciona.
Comprueba que apunta a tu club: al conectarse, el servidor se identifica con el nombre de tu club. Si el asistente nombra otro club, algo se ha pegado mal.
Vuelve a Golfmanager, a tu usuario > Credenciales MCP: la columna Último uso debe mostrar la fecha y hora de hace un momento.
Si algo falla, estas son las causas habituales:
"Credencial no válida": el token está incompleto o mal pegado. Fíjate en que empiece por Bearer seguido de un espacio, y en que no se haya cortado al copiar.
"MCP no está instalado en este tenant": falta el módulo en tu club. Escríbenos a support@golfmanager.com.
"El usuario de esta credencial ya no está activo": el usuario de Golfmanager se ha desactivado o borrado. Crea la credencial desde un usuario activo.
No aparece ninguna herramienta: revisa que el tipo de conexión sea HTTP streamable y que la URL termine exactamente en /api/mcp.
Seguridad: qué protege la credencial
Es personal. La credencial se crea desde tu propia ficha y actúa como tú: el asistente ve y hace lo que tus permisos permiten, ni más ni menos. Todo lo que haga queda registrado como hecho por tu usuario.
Es de un solo club. El token está atado al club para el que se emitió. Aunque alguien lo apuntara a otro club, no abriría: no es una llave maestra.
No es tu contraseña ni tu clave de API. Es una llave aparte, para un asistente concreto. Si se pierde el portátil, revocas esa credencial y el resto de integraciones del club siguen funcionando.
Golfmanager no guarda el token. Guarda solo una huella criptográfica. Ni siquiera nosotros podemos leerlo después.
Puedes tener varias. Una por aparato o por asistente. Cada una tiene su propio límite de uso y se revoca por separado.
Las herramientas internas de Golfmanager no se ofrecen. Existen herramientas de diagnóstico reservadas al personal de Golfmanager; al asistente de un club ni siquiera se le enseña que existen.
🔒 Trata el token como una contraseña. No lo pegues en un chat de equipo, en un correo ni en un documento compartido. Quien lo tenga puede actuar en tu club con tu nombre.
Revocar una credencial
Ve a Configuración > Usuarios y abre tu usuario.
En la tarjeta Credenciales MCP, marca la credencial (o varias) que quieras anular.
Pulsa Revocar y confirma.
El efecto es inmediato: el asistente que usaba ese token deja de tener acceso en la siguiente petición. Revoca sin miedo cuando cambies de ordenador, cuando dejes de usar un asistente o ante la menor duda de que el token haya podido verse. Crear otra credencial cuesta menos de un minuto.
Limitaciones a tener en cuenta
Hace falta una cuenta de pago en ChatGPT o en Claude. Los planes gratuitos no permiten esta conexión de forma utilizable.
El ChatGPT del navegador no sirve todavía: sus conectores personalizados solo admiten OAuth o ninguna identificación, y aquí hace falta un token. Usa la aplicación de escritorio o Codex.
El asistente puede escribir de verdad. Crear reservas, anular ventas o mover stock son acciones reales sobre tu club. Revisa lo que te propone antes de confirmar.
El asistente puede equivocarse. Interpreta lo que le pides; si la petición es ambigua, puede aplicarla a la fecha o al cliente que no era. Para acciones delicadas, pídele primero que te enseñe lo que va a hacer.
Los datos van a un servicio externo. Lo que el asistente consulte pasa por los servidores de OpenAI o de Anthropic. Tenlo en cuenta con datos personales de clientes y con la normativa de protección de datos de tu país.
Hay límites de uso, los mismos que se aplican a la API de tu club: un asistente muy insistente puede topar con ellos.
Una credencial, un usuario. Si el usuario se desactiva, su credencial deja de funcionar.
Los menús de ChatGPT y de Claude cambian a menudo. Los nombres exactos de las opciones pueden variar respecto a los de este artículo; la información que hay que introducir (URL y header) no cambia.
Preguntas frecuentes
¿El asistente se descarga mi base de datos?
No. Pregunta y recibe solo lo que necesita para responder, en el momento. No hay copia ni sincronización de tu base de datos.
¿Puede alguien de mi equipo crear una credencial para otra persona?
No. Cada usuario crea las suyas desde su propia ficha. Si se intenta desde la ficha de otro, el sistema lo impide: una credencial equivale a la identidad de esa persona.
He perdido el token, ¿lo puedo volver a ver?
No. Se muestra una sola vez. Revoca la credencial y crea otra.
¿Puedo usar la misma credencial en ChatGPT y en Claude?
Técnicamente sí, pero no es recomendable. Crea una por asistente: así sabes cuál usa cada uno y puedes cortar solo uno si hace falta.
¿Se puede limitar lo que el asistente ve o hace?
Sí, a través de los permisos del usuario desde el que se crea la credencial. No hay una lista de herramientas que se pueda activar y desactivar en Golfmanager, pero muchos asistentes permiten desactivar herramientas concretas en su propia configuración del servidor.
¿Queda registro de lo que hace el asistente?
Sí. Las acciones se registran como hechas por el usuario de la credencial, igual que si esa persona las hubiera hecho en pantalla. Además, la credencial guarda la fecha de último uso.
¿Sirve con Claude Code, Codex u otros agentes de programación?
Sí. Cualquier cliente que hable MCP por HTTP y permita enviar un header sirve. La propia ventana del token trae el texto listo para Claude Code y para Codex.
¿Vale la versión gratuita de ChatGPT o de Claude?
No para este uso. Se necesita un plan de pago: ChatGPT Plus, Pro, Business, Enterprise o Edu; o Claude Pro, Max, Team o Enterprise.
¿Y si mi club está instalado en un servidor propio?
Funciona igual, siempre que la dirección sea accesible desde internet: el asistente se conecta desde los servidores de OpenAI o Anthropic, no desde tu red local.
Buenas prácticas recomendadas
Una credencial por asistente y por aparato, con un nombre que diga cuál es.
Empieza solo consultando. Dedica los primeros días a preguntas de lectura antes de dejar que cree o anule nada.
Usa un usuario con permisos ajustados si el asistente solo tiene que informar.
Pide confirmación antes de actuar: "enséñame primero lo que vas a hacer" es una buena costumbre con cualquier asistente.
Revisa de vez en cuando la lista de credenciales y revoca las que ya no uses o cuyo Último uso lleve meses parado.
Revoca de inmediato si un ordenador se pierde, si alguien deja el club o ante cualquier duda.
No compartas el token por chat, correo ni documentos compartidos.
Si tienes cualquier duda o necesitas que activemos el módulo en tu club, escríbenos a support@golfmanager.com.