Conectar INWOUT a un cliente MCP

    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.

    ¿Qué es un «cliente»?

    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.

    Ilustración: Claude y Codex se conectan al MCP de INWOUT para consultar horas, vacaciones o permisos, y para registrar un fichaje desde el móvil o por tarjeta.
    ¿Nuevo en esto? Descubre qué es un MCP de INWOUT, de INWOUT AI, en inwout.com

    Antes de empezar

    • Tu empresa debe tener MCP activado. Lo activa INWOUT, no el administrador de tu cuenta.
    • Necesitas tu propio usuario de INWOUT: nadie puede generar la clave por ti.
    • Necesitas un cliente compatible con MCP que te permita añadir una cabecera de autenticación propia.

    1. Genera tu clave

    1. Entra en INWOUT con tu usuario.
    2. Ve a la información de tu perfil.
    3. Pulsa Editar.
    4. Localiza el campo MCP.
    5. Genera la clave.
    6. Cópiala ahora. Es la única vez que la verás entera: después el campo solo muestra los cuatro últimos caracteres (****a1b2).
    Importante

    La clave es personal y actúa en tu nombre. Trátala como una contraseña.

    Nota

    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.

    2. Añade INWOUT a tu cliente

    Son tres datos, y son los mismos para cualquier cliente:

    Servidor MCPhttps://app.inwout.com/mcp/
    TransporteHTTP
    AutenticaciónCabecera 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.

    Dónde poner estos datos

    Claude Code

    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

    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.

    Descargar Codex

    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.toml

    Cierra Codex del todo (⌘Q en Mac) y vuelve a abrirlo. Comprueba la conexión con una consulta de lectura: «¿Qué horario tengo asignado?».

    Importante

    La clave queda guardada en texto plano en ese archivo. No lo compartas. Si generas una clave nueva, cámbiala también aquí.

    Alternativa para la CLI: variable de entorno

    ~/.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.

    3. Comprueba que funciona

    Usa siempre una consulta de lectura como primera prueba, nunca una acción que escriba:

    • «¿Qué horario tengo asignado?»
    • «Enséñame mis fichajes de esta semana»
    • «¿Cuántas horas he trabajado este mes?»

    Si responden con tus datos reales, la conexión está bien.

    4. Qué puedes hacer

    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.

    Consultas

    Qué preguntasCapacidad
    Fichajes en un rango de fechas, con pausas y pendientes de validaciónget_users_checks
    Permisos y ausencias, por fechas y estadoget_users_permits
    Horas teóricas, trabajadas y extra, con desglose y acumulado anualget_users_worked_hours
    Saldos de vacaciones y de cada tipo de permiso con límiteget_users_permit_balances
    Horario asignado, turnos, pausas y flexibilidadget_users_timetable
    Tipos de permiso disponiblesget_permit_types
    Festivos del calendario de tu centro de trabajoget_public_holidays
    Tu departamento: responsable y tamañoget_department_info
    Personas que puedes ver o que gestionasget_users
    Detalle de un fichaje: historial de cambios y si se registró con geolocalizaciónget_check_detail
    Detalle de un permiso, con sus acciones y el hilo de mensajesget_permit_detail

    Acciones sobre tu jornada

    Qué hacesCapacidad
    Fichar entrada o salidacreate_check
    Iniciar o terminar una pausacreate_break
    Modificar un fichaje tuyo (según tu empresa, queda pendiente de validación)modify_check
    Solicitar un permisorequest_permit
    Cancelar un permiso tuyo pendientecancel_permit
    Editar un permiso: cambiar fechas, horas o tipo sin cancelarlo. Si no eres quien lo aprueba, vuelve a pendiente.edit_permit

    Acciones de gestión · Solo para responsables, administradores o quien aprueba las solicitudes, y solo sobre las personas que ya gestionas en INWOUT.

    Qué hacesCapacidad
    Validar una corrección de fichajevalidate_check_modification
    Rechazar una corrección de fichaje (vuelve al último valor validado)reject_check_modification
    Aprobar un permiso pendienteapprove_permit
    Rechazar un permiso pendientereject_permit
    Pedir el justificante de un permisorequest_justification
    Aprobar un justificanteapprove_justification
    Crear un fichaje manual para otra personacreate_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 .

    Permisos y validaciones

    • El agente actúa siempre como tú. Llega exactamente a lo que tu usuario puede ver y hacer en INWOUT: si solo gestionas tu jornada, a tus datos; si eres responsable, también a las personas que gestionas y a las solicitudes que te corresponde aprobar.
    • MCP expone una parte de INWOUT, no todo. En cada capacidad, INWOUT sigue aplicando sus reglas, permisos y validaciones: si algo no puedes hacerlo desde la aplicación, tampoco podrás hacerlo desde un agente.

    Solución de problemas

    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.

    Disponibilidad

    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?