Conecte seu agente de IA favorito diretamente à sua conta do Clockify com segurança para ajudar você a registrar horas, gerar relatórios e auditar planilhas de horas.

Segurança e permissões

• O agente de IA herda exatamente as mesmas permissões do seu usuário do Clockify.
• O agente de IA só pode ler dados ou registrar horas nos projetos aos quais você já tem acesso.

Gerar chave de API #

Você conectará seu agente de IA ao Clockify usando sua chave de API.

Para gerar sua chave de API pessoal: 

1. Entre na sua conta Clockify
2. Clique na sua foto no canto superior direito
3. Selecione Preferências
4. Clique na aba Avançado
5. Clique em Gerenciar chaves de API
6. Selecione Gerar nova

Conectar o MCP do Clockify ao Claude CLI #

Se você estiver usando o Claude CLI, também pode conectá-lo ao servidor MCP do Clockify. Para isso, cole o código abaixo no seu arquivo `.mcp.json`:

{
  "mcpServers": {
    "clockify-mcp": {
      "type": "http",
      "url": "https://api.clockify.me/mcp-server/mcp",
      "headers": {
        "x-api-key": "API_KEY"
      }
    }
  }
}

Ou você pode usar o seguinte comando:

claude mcp add clockify-mcp https://api.clockify.me/mcp-server/mcp --transport http --header "x-api-key: API_KEY"

Substitua API_KEY pela chave de API gerada no seu espaço de trabalho.

Conectar o MCP do Clockify ao Codex CLI #

O servidor MCP do Clockify também pode se conectar ao Codex CLI. Para isso, basta colar o código abaixo no arquivo config.toml:

[mcp_servers.clockify-mcp]
transport = "http"
url = "https://api.clockify.me/mcp-server/mcp"
http_headers = { "x-api-key" = "API_KEY" }

Substitua API_KEY pela chave de API gerada no seu espaço de trabalho.

Conectar o MCP do Clockify ao Gemini CLI #

Após obter sua chave de API, você pode conectá-la ao seu Gemini CLI.

1. Localize o arquivo settings.json, que normalmente fica no diretório raiz do usuário, dentro da pasta oculta .gemini (cd ~/.gemini/).
   
   Observação: No macOS, você pode pressionar CMD+SHIFT+G e digitar esse caminho para abrir o diretório diretamente.
   
2. Abra o arquivo settings.json e adicione o seguinte código:

{
"mcpServers": {
  "posts-api-mcp": {
    "httpUrl": "https://api.clockify.me/mcp-server/mcp",
    "headers": {
      "x-api-key": "API_KEY"
    }
  }
}

3. Substitua API_KEY pela chave de API gerada no seu espaço de trabalho.

3. Substitua API_KEY pela chave de API gerada no seu espaço de trabalho.

Ou use o seguinte comando:

gemini mcp add --transport http --header "x-api-key: API_KEY" posts-api-mcp https://api.clockify.me/mcp-server/mcp

Substitua API_KEY pela chave de API gerada no seu espaço de trabalho.

claude mcp add clockify-mcp https://api.clockify.me/mcp-server/mcp --transport http --header "x-api-key: API_KEY" --header "region: EU"

O que você pode fazer #

As ferramentas e ações disponíveis dependem das suas permissões atuais de Controle de Acesso Baseado em Funções (RBAC) no Clockify. Estas são todas as ferramentas disponíveis que o servidor Clockify MCP permite utilizar:

As ferramentas são as ações principais que o agente de IA pode realizar por você no Clockify:

Prompts disponíveis (Fluxos de trabalho predefinidos) #

Prompts são rotinas inteligentes de várias etapas que o agente de IA pode executar para analisar seu trabalho, utilizando seu histórico de registros de tempo para gerar relatórios, auditar suas planilhas de horas e avaliar a produtividade. 

Por exemplo, você pode executar o prompt auditoria de padrões de produtividade para analisar cronologicamente suas entradas de tempo do último mês e identificar os períodos em que você mantém maior foco.

Recursos disponíveis #

O agente de IA consulta silenciosamente os seguintes recursos em segundo plano, para que nunca precise fazer as mesmas perguntas de configuração:

• Perfil do usuário: Fornece ao agente de IA sua identidade, as configurações do espaço de trabalho, o fuso horário local, o horário padrão de início do expediente, a capacidade diária e o dia de início da sua semana de trabalho. 
• Registros de tempo recentes: Fornece um histórico dos seus registros de tempo recentes para que o agente de IA compreenda seu contexto e hábitos atuais.

Glossário #

• Ações: As operações ou comandos específicos executados pelo agente de IA para gerenciar seus dados do Clockify, como registrar tempo, atualizar entradas ou obter relatórios.
• Agente de IA: Um sistema de inteligência artificial (acessado via Gemini, Claude ou Codex CLI) que se conecta de forma segura ao seu espaço de trabalho para registrar o tempo, analisar dados e executar tarefas por meio de conversas.

• Chave de API: Um token de segurança exclusivo gerado nas preferências da sua conta do Clockify, utilizado para autenticar e autorizar o acesso do agente de IA ao seu espaço de trabalho.
• CLI (Interface de linha de comando): O ambiente de terminal baseado em texto (por exemplo, Gemini CLI, Claude CLI, Codex CLI) onde você define as configurações para conectar o agente de IA ao servidor MCP.
• Campos personalizados: Categorizações adicionais no seu espaço de trabalho do Clockify (como quilometragem, despesas, localização ou departamento) que o agente de IA pode associar automaticamente aos seus registros de tempo.
• Servidor MCP (Model Context Protocol): A ponte de integração segura que permite que o agente de IA consulte o contexto e execute ações com segurança dentro da sua conta do Clockify.
• Prompts (Fluxos de trabalho predefinidos): Rotinas analíticas inteligentes de várias etapas que o agente de IA pode executar por você, como auditar planilhas de horas, gerar relatórios de reuniões diárias (stand-ups) ou analisar padrões de produtividade.
• RBAC (Controle de acesso baseado em função): A estrutura de segurança do Clockify que determina exatamente quais projetos e permissões o agente de IA herda ao interagir com o seu espaço de trabalho.
• Recursos: Dados em segundo plano, como seu perfil de usuário, fuso horário local, capacidade diária e registros de tempo recentes, que o agente de IA consulta silenciosamente para contextualizar suas solicitações, sem exigir configuração manual.
• Ferramentas: As funções principais integradas que o agente de IA utiliza para interagir com o Clockify, variando desde iniciar e parar cronômetros até gerar relatórios detalhados de faturamento e presença.