Servidor MCP de Harvest

Este servidor MCP (Protocolo de Contexto de Modelo) se integra con la API de seguimiento de tiempo y gestión de proyectos de Harvest. Permite que Claude y otros asistentes de IA compatibles con MCP interactúen con su cuenta de Harvest, ayudándole a gestionar las entradas de tiempo, proyectos, clientes y más.

Características

El servidor proporciona la siguiente funcionalidad:

Usuarios

• Lista de usuarios
• Obtener detalles del usuario

Entradas de tiempo

• Lista de entradas de tiempo con opciones de filtrado
• Crear nuevas entradas de tiempo
• Temporizadores de inicio y parada
• Detalles de entrada de tiempo de consulta

Proyectos

• Lista de proyectos con opciones de filtrado
• Recuperar información detallada del proyecto

Clientela

• Lista de clientes con opciones de filtrado
• Recuperar información detallada del cliente

Tareas

• Lista de tareas disponibles con opciones de filtrado

Instrucciones de configuración

Prerrequisitos

• Python 3.10 o superior
• Cuenta Harvest con acceso a la API
• Clave API de Harvest e ID de cuenta

Integración con Claude Desktop

1. Cree o edite su archivo de configuración de Claude Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
2. Agregue la configuración del servidor Harvest MCP:
   { "mcpServers": { "harvest": { "command": "uv", "args": [ "run", "--directory", "change_directory", "harvest-mcp-server.py" ], "env": { "HARVEST_ACCOUNT_ID": "account_id", "HARVEST_API_KEY": "api_key" } } } }
3. Reinicie Claude Desktop.
4. Verifique la integración buscando el ícono del martillo en la interfaz de Claude.

Consultas de ejemplo

Una vez conectado, puedes preguntarle a Claude sobre tus datos de Harvest con consultas como:

• "Muéstrame mis entradas de tiempo de la semana pasada"
• "Enumerar todos mis proyectos activos"
• "Iniciar un temporizador para el proyecto [project_id] y la tarea [task_id]"
• "Muéstrame todos los clientes activos"
• "Enumerar todas las tareas disponibles"

Personalización

Puedes modificar el código del servidor para añadir más funciones o personalizar las herramientas existentes para que se adapten mejor a tu flujo de trabajo. El servidor utiliza FastMCP, lo que facilita la incorporación de nuevas herramientas simplemente añadiendo nuevas funciones con el decorador @mcp.tool() .

Solución de problemas

• Errores de API : asegúrese de que su clave de API de Harvest y su ID de cuenta sean correctas y tengan los permisos necesarios.
• Problemas de conexión : verifique que la configuración de Claude Desktop tenga la ruta correcta al script del servidor.
• Dependencias faltantes : asegúrese de haber instalado todos los paquetes necesarios en su entorno de Python.

Notas de seguridad

Este servidor requiere tus credenciales de Harvest API para funcionar. Asegúrate de:

• Mantenga su clave API segura
• No comparta su archivo claude_desktop_config.json
• Considere usar una clave API dedicada con permisos limitados para esta integración