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.