{"id":33450,"date":"2026-08-07T11:46:31","date_gmt":"2026-08-07T11:46:31","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=33450"},"modified":"2026-10-02T16:09:52","modified_gmt":"2026-10-02T16:09:52","slug":"use-clockify-mcp-server-to-connect-to-ai-agent","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/es\/integrations-and-add-ons\/use-clockify-mcp-server-to-connect-to-ai-agent","title":{"rendered":"Utiliza el servidor MCP de Clockify para conectarte a un agente de IA"},"content":{"rendered":"<div class=\"wp-block-custom-coming-soon coming-soon color-clockify\"><span class=\"box-label\">PR\u00d3XIMAMENTE<\/span><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Conecta de forma segura tu agente de IA favorito directamente a tu cuenta de Clockify para controlar el tiempo, generar informes y auditar planillas de horarios.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Seguridad y permisos<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>El agente de IA hereda tus permisos de usuario exactos de Clockify<\/li>\n\n\n\n<li>El agente de IA solo puede leer datos o registrar tiempo en proyectos a los que ya tienes acceso<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Generar clave API<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Conectar\u00e1s tu agente de IA a Clockify utilizando tu clave API.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para generar tu clave API personal:&nbsp;<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Inicia sesi\u00f3n en tu cuenta Clockify<\/li>\n\n\n\n<li>Haz clic en tu foto en la esquina superior derecha<\/li>\n\n\n\n<li class=\"translation-block\">Selecciona <strong>Preferencias<\/strong><\/li>\n\n\n\n<li class=\"translation-block\">Haz clic en la pesta\u00f1a <strong>Avanzado<\/strong><\/li>\n\n\n\n<li class=\"translation-block\">Haz clic en <strong>Gestionar claves API\n<\/strong><\/li>\n\n\n\n<li class=\"translation-block\">Selecciona <strong>Generar nueva\n<\/strong><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"439\" src=\"https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1024x439.webp\" alt=\"\" class=\"wp-image-33472\" srcset=\"https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1024x439.webp 1024w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-300x128.webp 300w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-768x329.webp 768w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1536x658.webp 1536w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-18x8.webp 18w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api.webp 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Conectar Clockify MCP con Claude CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Si utilizas Claude CLI, tambi\u00e9n puedes conectarlo al servidor MCP de Clockify. Para eso, pega el siguiente c\u00f3digo en tu archivo .mcp.json:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"mcpServers\": {\n    \"clockify-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https:\/\/api.clockify.me\/mcp-server\/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"API_KEY\"\n      }\n    }\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">O bien, puedes utilizar el siguiente comando:<br><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude mcp add clockify-mcp https:\/\/api.clockify.me\/mcp-server\/mcp --transport http --header \"x-api-key: API_KEY\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Reemplaza API_KEY con la clave de API generada en tu espacio de trabajo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conectar Clockify MCP a Codex CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">El servidor Clockify MCP tambi\u00e9n puede conectarse a Codex CLI. Para ello, simplemente pega el siguiente c\u00f3digo en tu archivo config.toml:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;mcp_servers.clockify-mcp]\ntransport = \"http\"\nurl = \"https:\/\/api.clockify.me\/mcp-server\/mcp\"\nhttp_headers = { \"x-api-key\" = \"API_KEY\" }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Reemplaza API_KEY con la clave de API generada en tu espacio de trabajo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conectar Clockify MCP a Gemini CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Una vez que hayas obtenido tu clave de API, puedes conectarla a Gemini CLI.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Localiza el archivo settings.json; normalmente se encuentra en el directorio ra\u00edz de tu usuario, dentro de la carpeta hidden .gemini (cd ~\/.gemini\/).<br><br><strong>Nota:<\/strong> En macOS, puedes presionar CMD+SHIFT+G y escribir esta ruta para abrir el directorio directamente.<br><\/li>\n\n\n\n<li>Abre el archivo settings.json y a\u00f1ade el siguiente c\u00f3digo:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n\"mcpServers\": {\n  \"posts-api-mcp\": {\n    \"httpUrl\": \"https:\/\/api.clockify.me\/mcp-server\/mcp\",\n    \"headers\": {\n      \"x-api-key\": \"API_KEY\"\n    }\n  }\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">3. Reemplaza API_KEY con la clave de API generada en tu espacio de trabajo.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Reinicia Gemini para empezar a utilizar el servidor MCP de Clockify.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>O bien, puedes utilizar el siguiente comando:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>gemini mcp add --transport http --header \"x-api-key: API_KEY\" posts-api-mcp https:\/\/api.clockify.me\/mcp-server\/mcp<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Reemplaza API_KEY con la clave de API generada en tu espacio de trabajo.<\/p>\n\n\n\n<div class=\"wp-block-custom-highlight-box custom-box color-blue\"><div class=\"box-header\"><svg width=\"20\" height=\"20\" viewbox=\"0 0 24 24\" fill=\"none\"><mask id=\"mask0_1_85240\" style=\"mask-type:alpha\" maskunits=\"userSpaceOnUse\" x=\"0\" y=\"0\" width=\"24\" height=\"24\"><rect width=\"24\" height=\"24\" fill=\"#D9D9D9\"><\/rect><\/mask><g mask=\"url(#mask0_1_85240)\"><path d=\"M8.275 7.72461L5.275 4.72461L6.7 3.29961L9.7 6.29961L8.275 7.72461ZM12 5.34961V1.09961H14V5.34961H12ZM19.275 18.7246L16.275 15.7246L17.7 14.2996L20.7 17.2996L19.275 18.7246ZM17.7 7.72461L16.275 6.29961L19.275 3.29961L20.7 4.72461L17.7 7.72461ZM18.65 11.9996V9.99961H22.9V11.9996H18.65ZM5.125 21.6996L2.3 18.8746C2.1 18.6746 2 18.4413 2 18.1746C2 17.9079 2.1 17.6746 2.3 17.4746L11.375 8.37461C11.9583 7.79128 12.6667 7.49961 13.5 7.49961C14.3333 7.49961 15.0417 7.79128 15.625 8.37461C16.2083 8.95794 16.5 9.66628 16.5 10.4996C16.5 11.3329 16.2083 12.0413 15.625 12.6246L6.525 21.6996C6.325 21.8996 6.09167 21.9996 5.825 21.9996C5.55833 21.9996 5.325 21.8996 5.125 21.6996ZM5.825 19.5996L12.1 13.3246L10.675 11.9246L4.425 18.1746L5.825 19.5996Z\" fill=\"#03A9F4\"><\/path><\/g><\/svg><span class=\"box-label\">Consejo<\/span><\/div><div class=\"box-content\">\n<p class=\"wp-block-paragraph\">Si tu espacio de trabajo est\u00e1 alojado en una regi\u00f3n de datos espec\u00edfica (como la UE), el servidor MCP de Clockify admite el alojamiento regional. Puedes especificar tu regi\u00f3n de datos a\u00f1adiendo el encabezado de regi\u00f3n a tu configuraci\u00f3n o comando.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><br>Por ejemplo, si utilizas Claude CLI y necesitas conectarte a la regi\u00f3n de datos de la UE, utiliza el siguiente comando:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude mcp add clockify-mcp <a href=\"https:\/\/api.clockify.me\/mcp-server\/mcp\" target=\"_blank\" rel=\"noopener\">https:\/\/api.clockify.me\/mcp-server\/mcp<\/a> --transport http --header \"x-api-key: API_KEY\" --header \"region: EU\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Reemplaza API_KEY con la clave de API generada en tu espacio de trabajo.<\/p>\n<\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Qu\u00e9 puedes hacer<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Las herramientas y acciones disponibles dependen de sus permisos existentes de control de acceso basado en roles (RBAC) de Clockify. Estas son todas las herramientas disponibles que el servidor Clockify MCP te permite utilizar:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Las herramientas son las acciones principales que el agente de IA puede realizar por ti en Clockify:<\/p>\n\n\n\n<figure class=\"wp-block-table translation-block\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Herramienta<\/strong><\/td><td><strong>Descripci\u00f3n<\/strong><\/td><\/tr><tr><td><strong>start timer<\/strong><\/td><td>Inicia el temporizador de forma natural. Tambi\u00e9n puedes retroceder los temporizadores, registrar \"Descansos\" (si est\u00e1n habilitados en tu espacio de trabajo) o pedirle al agente de IA que adjunte campos personalizados disponibles en tu espacio de trabajo, como kilometraje, gastos, ubicaci\u00f3n o departamento.<\/td><\/tr><tr><td><strong>stop timer<\/strong><\/td><td>Det\u00e9n el temporizador actual. Tambi\u00e9n puedes pedirle al agente de IA que a\u00f1ada los detalles que faltan cuando lo detienes.<\/td><\/tr><tr><td><strong>log past time<\/strong><\/td><td>Registra el tiempo hist\u00f3rico. Puedes darle al agente de IA una duraci\u00f3n simple, pedirle que divida el tiempo a lo largo de un d\u00eda completo o darle una secuencia de tareas para que se apilen consecutivamente a partir de tu registro de entrada por la ma\u00f1ana.<\/td><\/tr><tr><td><strong>update time entry<\/strong><\/td><td>Corrige errores en tus registros anteriores. Simplemente dile al agente de IA qu\u00e9 necesita cambiar y encontrar\u00e1 la entrada y actualizar\u00e1 el proyecto, tarea, etiqueta o descripci\u00f3n.<\/td><\/tr><tr><td><strong>bulk update time entries<\/strong><\/td><td>Realiza cambios masivos al instante sin disminuir la velocidad. Puedes decir: <em>\"Marca todas mis entradas de ayer como facturables\"<\/em> y el agente de IA las actualizar\u00e1 todas a la vez.\n<\/td><\/tr><tr><td><strong>list time entries<\/strong><\/td><td>El agente de IA usa esto para comprender referencias conversacionales como <em>\"la entrada de ayer por la ma\u00f1ana\"<\/em> para que no tengas que buscar fechas exactas o identificaciones.\n<\/td><\/tr><tr><td><strong>create client \/ project \/ task \/ tag<\/strong><\/td><td>Crea nuevos elementos del espacio de trabajo sobre la marcha simplemente pidi\u00e9ndole al agente de IA que los configure.<\/td><\/tr><tr><td><strong>get current timer<\/strong><\/td><td>Preg\u00fantale al agente de IA en qu\u00e9 est\u00e1s trabajando actualmente para obtener una actualizaci\u00f3n de estado r\u00e1pida.\n<\/td><\/tr><tr><td><strong>list custom fields<\/strong><\/td><td>El agente de IA usa esto para verificar qu\u00e9 campos personalizados (como gastos o men\u00fas desplegables) est\u00e1n disponibles en tu espacio de trabajo para que los aplique con precisi\u00f3n.\n<\/td><\/tr><tr><td><strong>list clients \/ projects \/ tasks \/ tags<\/strong><\/td><td>El agente de IA busca en estas listas para reconocer instant\u00e1neamente los nombres de las cosas en las que est\u00e1 trabajando.\n\n<\/td><\/tr><tr><td><strong>get summary report<\/strong><\/td><td>Haz preguntas conversacionales sobre tu tiempo (<em>\u201cMu\u00e9strame las horas facturables de los \u00faltimos 6 meses\u201d<\/em> o <em>\u201c\u00bfCu\u00e1nto tiempo se dedic\u00f3 al proyecto Apollo en el tercer trimestre?\u201d<\/em>), y el agente de IA calcular\u00e1 las fechas y obtendr\u00e1 los totales exactos.\n<\/td><\/tr><tr><td><strong>get detailed report<\/strong><\/td><td>Obt\u00e9n una lista granular de entradas de tiempo individuales para auditar tareas hist\u00f3ricas espec\u00edficas.\n<\/td><\/tr><tr><td><strong>generate attendance report<\/strong><\/td><td>Verifica tu capacidad diaria, semanal o mensual exacta, incluidos c\u00e1lculos precisos de horas extras y horas faltantes (<strong>requiere el plan Pro<\/strong>).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Prompts disponibles (flujos de trabajo predeterminados)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Los prompts son rutinas inteligentes de varios pasos que el agente de IA puede ejecutar para analizar tu trabajo utilizando tus entradas de tiempo hist\u00f3ricas para generar informes, auditar tus planillas de horarios y evaluar la productividad.&nbsp;<\/p>\n\n\n\n<p class=\"translation-block wp-block-paragraph\">Por ejemplo, puedes ejecutar el prompt de <strong>auditor\u00eda de patrones de productividad<\/strong> para analizar tus entradas de tiempo cronol\u00f3gico del \u00faltimo mes y ver cu\u00e1ndo est\u00e1s m\u00e1s concentrado.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Prompt<\/strong><\/td><td><strong>Descripci\u00f3n<\/strong><\/td><\/tr><tr><td><strong>generate daily standup<\/strong><\/td><td>Formatea un resumen profesional que se pueda copiar y pegar de las horas registradas del d\u00eda laboral anterior para los chats de tu equipo.<\/td><\/tr><tr><td><strong>audit timesheet<\/strong><\/td><td>Escanea registros recientes para encontrar anomal\u00edas comunes como metadatos faltantes (proyectos, clientes, etiquetas y descripci\u00f3n), d\u00edas no registrados o temporizadores que se dejan encendidos accidentalmente.<\/td><\/tr><tr><td><strong>client billing summary<\/strong><\/td><td>Genera un desglose pulido de las horas distribuidas en los proyectos de un cliente.<\/td><\/tr><tr><td><strong>project burn rate analyzer<\/strong><\/td><td>Compara el tiempo real registrado con la estimaci\u00f3n original de un proyecto para ver si vas por buen camino o superas el presupuesto.<\/td><\/tr><tr><td><strong>team utilization audit<\/strong><\/td><td>Revisa las tasas de utilizaci\u00f3n de un equipo, calcula la eficiencia facturable de cada miembro y la compara con el objetivo esperado.<\/td><\/tr><tr><td><strong>productivity pattern audit<\/strong><\/td><td>Analiza entradas de tiempo cronol\u00f3gicamente para medir el cambio de contexto, los intervalos de trabajo profundos y el ritmo diario general.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Recursos disponibles<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">El agente de IA lee silenciosamente los siguientes recursos en segundo plano para no tener que preguntarte nunca las mismas cuestiones de configuraci\u00f3n:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>user profile<\/strong>: Proporciona al agente de IA tu identidad, la configuraci\u00f3n del espacio de trabajo, la zona horaria local, la hora de inicio de la jornada laboral predeterminada, la capacidad diaria y el d\u00eda en que comienza tu semana laboral.&nbsp;<\/li>\n\n\n\n<li><strong>recent time entries<\/strong>: Aporta un historial de tus entradas de tiempo recientes para que el agente de IA comprenda tu contexto y h\u00e1bitos actuales.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">Glosario<\/h1>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"translation-block\"><strong>Actions:<\/strong> The specific operations or commands executed by the AI agent to manage your Clockify data, such as logging time, updating entries, or fetching reports.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>AI agent:<\/strong> An artificial intelligence system (accessed via Gemini, Claude, or Codex CLI) that securely connects to your workspace to track time, analyze data, and execute tasks conversationally.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"translation-block\"><strong>API Key:<\/strong> A unique security token generated within your Clockify account preferences, used to authenticate and authorize the AI agent&#8217;s access to your workspace.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>CLI (Command Line Interface):<\/strong> The text-based terminal environment (e.g., Gemini CLI, Claude CLI, Codex CLI) where you configure the settings to connect your AI agent to the MCP server.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>Custom Fields:<\/strong> Additional categorizations within your Clockify workspace (such as mileage, expenses, location, or department) that the AI agent can automatically attach to your time entries.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>MCP (Model Context Protocol) Server:<\/strong> The secure integration bridge that enables your AI agent to read context and safely execute actions within your Clockify account.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>Prompts (Pre-built Workflows):<\/strong> Smart, multi-step analytical routines the AI agent can run on your behalf, such as auditing timesheets, generating standup reports, or analyzing productivity patterns.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>RBAC (Role-Based Access Control):<\/strong> The security framework in Clockify that determines exactly which projects and permissions your AI agent inherits when interacting with your workspace.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>Resources:<\/strong> Background data such as your user profile, local timezone, daily capacity, and recent time entries that the AI agent silently reads to contextualize your requests without requiring manual setup.<br><\/li>\n\n\n\n<li class=\"translation-block\"><strong>Tools:<\/strong> The core, built-in functions the AI agent uses to interact with Clockify, ranging from starting and stopping timers to generating detailed billing and attendance reports.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"Securely connect your favorite AI agent directly to your Clockify account to hel&#8230;","protected":false},"author":65,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[69],"tags":[],"class_list":["post-33450","post","type-post","status-publish","format-standard","hentry","category-integrations"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"karla.barloso@cake.com","author_link":"https:\/\/clockify.me\/help\/es\/author\/karla-barlosocake-com"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/posts\/33450","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/comments?post=33450"}],"version-history":[{"count":21,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/posts\/33450\/revisions"}],"predecessor-version":[{"id":34975,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/posts\/33450\/revisions\/34975"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/media?parent=33450"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/categories?post=33450"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/es\/wp-json\/wp\/v2\/tags?post=33450"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}