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