Conecta tu cliente MCP compatible a INWOUT con tu clave personal.
Para conectar INWOUT necesitas dos cosas: el servidor MCP (una dirección, la misma para todos los clientes) y tu clave personal, que generas tú desde tu perfil.
Cualquier cliente compatible con MCP se conecta al mismo servidor. Lo único que cambia de una aplicación a otra es dónde te pide estos datos.
Es la aplicación de IA con la que hablas: Claude, ChatGPT, Gemini, Codex, Copilot u otras. El cliente se conecta a INWOUT mediante MCP para consultar tus datos y hacer acciones en tu nombre.

****a1b2).La clave es personal y actúa en tu nombre. Trátala como una contraseña.
Si generas una clave nueva, la anterior deja de funcionar al instante y los clientes configurados con ella se desconectan.
Así verás la clave al generarla: cópiala en ese momento, porque después solo se muestran los cuatro últimos caracteres.
Son tres datos, y son los mismos para cualquier cliente:
| Servidor MCP | https://app.inwout.com/mcp/ |
| Transporte | HTTP |
| Autenticación | Cabecera Authorization: Api-Key TU_CLAVE |
Hoy funciona con Claude Code y con Codex. Desde el chat de ChatGPT o el chat de Claude todavía no: eso llegará con el inicio de sesión mediante OAuth.
Copia la dirección tal cual, con la barra final y sin formato de enlace. La cabecera empieza por Api-Key (con el espacio), no Bearer.
Claude Code es el agente de Anthropic. Funciona en el terminal y también dentro de la app de escritorio de Claude (pestaña Code), que ya lo incluye: no hace falta instalar nada más. Necesitas un plan de pago de Claude.
Descargar la app de Claude · Documentación de Claude Code
Claude Code — desde el terminal:
claude mcp add --transport http inwout https://app.inwout.com/mcp/ --header "Authorization: Api-Key TU_CLAVE"Codex es el agente de OpenAI. Se usa desde su app de escritorio o desde la CLI, y se entra con una cuenta de ChatGPT.
Abre ~/.codex/config.toml (haz antes una copia si ya existe) y añade este bloque sin cambiar el resto del archivo. Sustituye TU_CLAVE por tu clave directamente en el archivo:
~/.codex/config.toml
[mcp_servers.inwout]
url = "https://app.inwout.com/mcp/"
http_headers = { "Authorization" = "Api-Key TU_CLAVE" }En macOS o Linux, protege el archivo:
Terminal — permisos del archivo
chmod 600 ~/.codex/config.tomlCierra Codex del todo (⌘Q en Mac) y vuelve a abrirlo. Comprueba la conexión con una consulta de lectura: «¿Qué horario tengo asignado?».
La clave queda guardada en texto plano en ese archivo. No lo compartas. Si generas una clave nueva, cámbiala también aquí.
~/.codex/config.toml — alternativa CLI
[mcp_servers.inwout]
url = "https://app.inwout.com/mcp/"
env_http_headers = { "Authorization" = "INWOUT_MCP_AUTH" }Terminal — variable de entorno
export INWOUT_MCP_AUTH="Api-Key TU_CLAVE"Solo sirve si abres Codex desde ese mismo terminal: la app abierta desde el Dock no recibe la variable. Usa una sola de las dos opciones.
La cabecera debe ser Api-Key, no Bearer: por eso no sirve la opción bearer_token_env_var de Codex.
Usa siempre una consulta de lectura como primera prueba, nunca una acción que escriba:
Si responden con tus datos reales, la conexión está bien.
INWOUT expone 11 consultas, 13 acciones y 2 recursos de contexto. Las consultas llegan a lo mismo que tu usuario ya puede ver en INWOUT: tus datos y, si eres responsable, los de las personas que gestionas.
| Qué preguntas | Capacidad |
|---|---|
| Fichajes en un rango de fechas, con pausas y pendientes de validación | get_users_checks |
| Permisos y ausencias, por fechas y estado | get_users_permits |
| Horas teóricas, trabajadas y extra, con desglose y acumulado anual | get_users_worked_hours |
| Saldos de vacaciones y de cada tipo de permiso con límite | get_users_permit_balances |
| Horario asignado, turnos, pausas y flexibilidad | get_users_timetable |
| Tipos de permiso disponibles | get_permit_types |
| Festivos del calendario de tu centro de trabajo | get_public_holidays |
| Tu departamento: responsable y tamaño | get_department_info |
| Personas que puedes ver o que gestionas | get_users |
| Detalle de un fichaje: historial de cambios y si se registró con geolocalización | get_check_detail |
| Detalle de un permiso, con sus acciones y el hilo de mensajes | get_permit_detail |
| Qué haces | Capacidad |
|---|---|
| Fichar entrada o salida | create_check |
| Iniciar o terminar una pausa | create_break |
| Modificar un fichaje tuyo (según tu empresa, queda pendiente de validación) | modify_check |
| Solicitar un permiso | request_permit |
| Cancelar un permiso tuyo pendiente | cancel_permit |
| Editar un permiso: cambiar fechas, horas o tipo sin cancelarlo. Si no eres quien lo aprueba, vuelve a pendiente. | edit_permit |
| Qué haces | Capacidad |
|---|---|
| Validar una corrección de fichaje | validate_check_modification |
| Rechazar una corrección de fichaje (vuelve al último valor validado) | reject_check_modification |
| Aprobar un permiso pendiente | approve_permit |
| Rechazar un permiso pendiente | reject_permit |
| Pedir el justificante de un permiso | request_justification |
| Aprobar un justificante | approve_justification |
| Crear un fichaje manual para otra persona | create_manual_check |
Recursos de contexto · Tu perfil (inwout://user/profile) y la configuración de tu empresa (inwout://company/detail).
Puedes ver el detalle en la página pública de INWOUT .
No veo el campo MCP en mi perfil
Dos motivos posibles: tu empresa no tiene MCP activado —lo activa INWOUT— o estás mirando el perfil de otra persona. El campo MCP solo aparece en tu propio perfil.
He generado la clave pero el cliente no conecta
Repasa los tres datos: el transporte debe ser HTTP; la cabecera es Authorization: Api-Key TU_CLAVE, no Bearer; y la dirección termina en /mcp/, con la barra final.
Funcionaba y ha dejado de funcionar
O has generado una clave nueva, que invalida la anterior, o tu empresa ha desactivado MCP: en ese caso se eliminan todas las claves.
Conecta, pero una acción no aparece
No todas las funciones de INWOUT están expuestas mediante MCP. Consulta la lista de capacidades.
Me dice que no tengo permisos
La operación excede lo que tu usuario puede hacer en INWOUT. Por ejemplo, solo puedes modificar tus propios fichajes, y solo puedes aprobar permisos o correcciones de las personas que gestionas.
Los datos no son los que esperaba
Las consultas por fecha usan rangos: comprueba que el agente ha entendido el periodo. Si no se indica fecha de fin, se usa hoy.
El MCP de INWOUT está disponible e incluido en el plan Profesional y en el Pack Freemium. No está en el plan gratuito ni en la prueba de 30 días. Lo activamos nosotros con tu plan, no el administrador de la cuenta: una vez activado, cada persona genera su clave desde su perfil de INWOUT.
¿Todavía no lo tienes activo?