Stubble AI

Conecta agentes de IA a tus datos de actividad mediante el Protocolo de Contexto de Modelo. Stubble ejecuta un servidor MCP local que permite a Claude Code, OpenClaw y otras herramientas compatibles consultar tu línea de tiempo, proyectos y patrones de trabajo, de forma segura y privada.

Ejecuta este comando para mostrar tu clave de autenticación MCP:

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

Añade Stubble a tu configuración de 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"
    }
  }
}

Pregunta a tu agente de IA sobre tu trabajo:

"¿En qué trabajé hoy?" "¿Cuánto tiempo pasé en Terminal esta semana?" "Muéstrame el desglose de mi proyecto" "¿Qué estaba haciendo a las 2 p.m. ayer?"

query_tasks

Resúmenes de tareas generados por IA con duración, aplicaciones utilizadas y contexto.

get_activity_log

Registros de actividad sin procesar, incluidos cambios de aplicación y títulos de ventanas.

search_activities

Búsqueda de texto completo en tu historial de actividad.

get_projects

Resúmenes de proyectos con tiempo total, actividad reciente y estado.

get_timeline

Vista diaria con bloques de tareas y períodos de inactividad.

get_day_summary

Resumen diario generado por IA con métricas de enfoque y aspectos destacados.

get_user_profile

Tu rol, proyectos activos y pila tecnológica para contexto.

get_ocr_digest

URLs extraídas, rutas de archivos y texto de capturas de pantalla.

{
  "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"
    }
  ]
}

Autenticación

Todas las solicitudes requieren un STUBBLE_MCP_KEY válido en el entorno. Las claves se almacenan localmente y nunca se transmiten.

Limitación de velocidad

60 solicitudes por minuto por cliente. Ayuda a evitar que agentes descontrolados abrumen el sistema.

Saneamiento de datos

Redacción automática de patrones sensibles: tokens JWT, claves API, contraseñas y direcciones de correo electrónico.

Lo que nunca se expone

Capturas de pantalla, notas de reuniones, rutas de archivo completas, URLs completas con parámetros de consulta.

Registro de auditoría

Todas las solicitudes MCP se registran en ~/.stubble/mcp-audit.log para su revisión.

Rotación de claves

Rota tu clave en cualquier momento con stubble-mcp --rotate-key

Error de "Autorización fallida"

Verifica que tu clave sea correcta ejecutando stubble-mcp --show-key y comparándola con tu configuración.

Error de "Límite de velocidad excedido"

Espera 60 segundos antes de reintentar. Considera agrupar consultas o reducir la frecuencia de sondeo.

Resultados vacíos

Asegúrate de que Stubble esté ejecutándose y haya registrado actividad. Verifica que el rango de tiempo en tu consulta coincida con cuando estuviste activo.

Conexión rechazada

Verifica que el servidor MCP esté ejecutándose: pgrep -f stubble-mcp. Reinicia Stubble si es necesario.