Stubble AI

O Stubble aprende como você trabalha e organiza seu dia automaticamente. Exporte planilhas de horas, descubra insights e potencialize suas ferramentas de IA.

Documentação

Conecte agentes de IA aos seus dados de atividade por meio do Model Context Protocol. O Stubble executa um servidor MCP local que permite que Claude Code, OpenClaw e outras ferramentas compatíveis consultem sua linha do tempo, projetos e padrões de trabalho — de forma segura e privada.

Execute este comando para exibir sua chave de autenticação MCP:

/Applications/Stubble.app/Contents/MacOS/stubble-mcp --show-key

Adicione o Stubble à sua configuração MCP.

{
  "mcpServers": {
    "stubble": {
      "command": "/Applications/Stubble.app/Contents/MacOS/stubble-mcp",
      "env": {
        "STUBBLE_MCP_KEY": "sk-stubble-your-key-here"
      }
    }
  }
}
{
  "stubble": {
    "command": "/Applications/Stubble.app/Contents/MacOS/stubble-mcp",
    "env": {
      "STUBBLE_MCP_KEY": "sk-stubble-your-key-here"
    }
  }
}

Pergunte ao seu agente de IA sobre o seu trabalho:

"No que trabalhei hoje?" "Quanto tempo passei no Terminal esta semana?" "Mostre-me o detalhamento do meu projeto" "O que eu estava fazendo às 14h ontem?"

query_tasks

Resumos de tarefas gerados por IA com duração, aplicativos usados e contexto.

get_activity_log

Registros brutos de atividade, incluindo trocas de aplicativos e títulos de janelas.

search_activities

Pesquisa de texto completo em todo o seu histórico de atividades.

get_projects

Resumos de projetos com tempo total, atividade recente e status.

get_timeline

Visão diária com blocos de tarefas e períodos ociosos.

get_day_summary

Resumo diário gerado por IA com métricas de foco e destaques.

get_user_profile

Seu papel, projetos ativos e stack de tecnologia para contexto.

get_ocr_digest

URLs extraídas, caminhos de arquivos e texto de capturas de tela.

{
  "tasks": [
    {
      "title": "Working on authentication flow",
      "description": "Implementing OAuth2 login with Google provider",
      "start": "2024-01-15T09:30:00Z",
      "end": "2024-01-15T11:45:00Z",
      "duration_minutes": 135,
      "apps": ["VS Code", "Terminal", "Chrome"],
      "websites": ["github.com", "developers.google.com"],
      "project": "stubble-app"
    }
  ]
}

Autenticação

Todas as solicitações exigem um STUBBLE_MCP_KEY válido no ambiente. As chaves são armazenadas localmente e nunca são transmitidas.

Limitação de Taxa

60 solicitações por minuto por cliente. Ajuda a evitar que agentes descontrolados sobrecarreguem o sistema.

Sanitização de Dados

Redação automática de padrões sensíveis: tokens JWT, chaves de API, senhas e endereços de e-mail.

O Que Nunca É Exposto

Capturas de tela, notas de reuniões, caminhos completos de arquivos, URLs completas com parâmetros de consulta.

Registro de Auditoria

Todas as solicitações MCP são registradas em ~/.stubble/mcp-audit.log para revisão.

Rotação de Chave

Gire sua chave a qualquer momento com stubble-mcp --rotate-key

Erro "Falha na autorização"

Verifique se sua chave está correta executando stubble-mcp --show-key e comparando-a com sua configuração.

Erro "Limite de taxa excedido"

Aguarde 60 segundos antes de tentar novamente. Considere agrupar consultas ou reduzir a frequência de polling.

Resultados vazios

Certifique-se de que o Stubble esteja em execução e tenha registrado atividade. Verifique se o intervalo de tempo na sua consulta corresponde ao período em que você estava ativo.

Conexão recusada

Verifique se o servidor MCP está em execução: pgrep -f stubble-mcp. Reinicie o Stubble se necessário.