Lattice HQ

Interactúa con la plataforma de gestión de desempeño de Lattice.

GitHub
6

Documentación

Servidor MCP de Lattice HQ

Un servidor de Protocolo de Contexto de Modelo (MCP) para Lattice HQ que permite a los modelos de IA interactuar con tu plataforma de gestión de rendimiento de Lattice.

Características

Este servidor MCP proporciona acceso a las siguientes capacidades de Lattice HQ:

Gestión de Usuarios

  • Obtener todos los usuarios de la organización
  • Obtener detalles de un usuario específico
  • Obtener reportes directos de cualquier usuario
  • Obtener información del usuario actual

Gestión de Objetivos

  • Obtener todos los objetivos de la organización
  • Obtener detalles de un objetivo específico
  • Obtener objetivos de un usuario específico

Ciclos de Revisión

  • Obtener todos los ciclos de revisión
  • Obtener detalles de un ciclo de revisión específico
  • Obtener evaluados de un ciclo de revisión

Retroalimentación

  • Obtener toda la retroalimentación
  • Obtener detalles de retroalimentación específica

Departamentos

  • Obtener todos los departamentos
  • Obtener detalles de un departamento específico

Actualizaciones

  • Obtener todas las actualizaciones
  • Obtener detalles de una actualización específica

Requisitos Previos

  • Node.js 18 o superior
  • Cuenta de Lattice HQ con acceso a API
  • Token de API de Lattice

Instalación

Método 1: Usando NPX (Recomendado)

¡No se requiere instalación! Solo usa npx para ejecutar la última versión:

LATTICE_API_URL=https://your-company.latticehq.com npx lattice-hq-mcp-server --api-key=YOUR-TOKEN --stdio

Método 2: Instalación Global

# Install globally
npm install -g lattice-hq-mcp-server

# Run the server
LATTICE_API_URL=https://your-company.latticehq.com lattice-hq-mcp-server --api-key=YOUR-TOKEN --stdio

Método 3: Desarrollo Local

# Clone the repository
git clone https://github.com/cyrilnoah1/lattice-hq-mcp.git
cd lattice-hq-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm run dev

Cómo Obtener tu Token de API de Lattice

Método 1: A través de la Configuración de Lattice

  1. Inicia sesión en tu cuenta de Lattice HQ
  2. Ve a Configuración → Integraciones → API (si está disponible)
  3. Genera un nuevo token de API
  4. Copia el token y agrégalo a tu configuración

Método 2: Contacta al Soporte de Lattice

Si no ves "Integraciones" en Configuración, esto generalmente significa:

  • Tu plan no incluye acceso a API (típicamente solo Enterprise)
  • No tienes permisos de administrador
  • El acceso a API debe habilitarse para tu cuenta

Contacta al Soporte de Lattice:

Uso

Ejecutando el Servidor

Con Token de API:

export LATTICE_API_TOKEN=your_token_here
export LATTICE_API_URL=https://your-company.latticehq.com
lattice-hq-mcp-server --stdio

O en línea:

LATTICE_API_URL=https://your-company.latticehq.com lattice-hq-mcp-server --api-key=your_token_here --stdio

Uso con Claude Desktop

Agrega lo siguiente a tu archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Configuración:

{
  "mcpServers": {
    "lattice-hq": {
      "command": "npx",
      "args": ["-y", "lattice-hq-mcp-server", "--api-key=YOUR-TOKEN", "--stdio"],
      "env": {
        "LATTICE_API_URL": "https://your-company.latticehq.com"
      }
    }
  }
}

Configuración:

{
  "mcpServers": {
    "lattice-hq": {
      "command": "node",
      "args": ["/path/to/lattice-hq-mcp/dist/index.js"],
      "env": {
        "LATTICE_API_URL": "https://your-company.latticehq.com",
        "LATTICE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Uso con Otros Clientes MCP

Este servidor sigue el protocolo MCP estándar y puede usarse con cualquier cliente compatible con MCP.

Herramientas Disponibles

Herramientas de Usuario

  • lattice_get_users - Obtener todos los usuarios
  • lattice_get_user - Obtener usuario por ID
  • lattice_get_user_direct_reports - Obtener reportes directos del usuario
  • lattice_get_me - Obtener usuario actual

Herramientas de Objetivos

  • lattice_get_goals - Obtener todos los objetivos
  • lattice_get_goal - Obtener objetivo por ID
  • lattice_get_user_goals - Obtener objetivos de un usuario

Herramientas de Ciclos de Revisión

  • lattice_get_review_cycles - Obtener todos los ciclos de revisión
  • lattice_get_review_cycle - Obtener ciclo de revisión por ID
  • lattice_get_review_cycle_reviewees - Obtener evaluados de un ciclo

Herramientas de Retroalimentación

  • lattice_get_feedbacks - Obtener toda la retroalimentación
  • lattice_get_feedback - Obtener retroalimentación por ID

Herramientas de Departamentos

  • lattice_get_departments - Obtener todos los departamentos
  • lattice_get_department - Obtener departamento por ID

Herramientas de Actualizaciones

  • lattice_get_updates - Obtener todas las actualizaciones
  • lattice_get_update - Obtener actualización por ID

Configuración

Puedes configurar el servidor usando variables de entorno:

  • LATTICE_API_TOKEN: Tu token de API de Lattice (requerido)
  • LATTICE_API_URL: URL base de la API de Lattice (requerido)

Desarrollo

# Install dependencies
npm install

# Build in watch mode
npm run watch

# Run development server
npm run dev

# Build for production
npm run build

Contribuciones

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Haz commit de tus cambios (git commit -m 'Add some amazing feature')
  4. Haz push a la rama (git push origin feature/amazing-feature)
  5. Abre una Solicitud de Extracción

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Soporte

Si encuentras algún problema:

  1. Consulta los Problemas de GitHub
  2. Crea un nuevo problema con detalles sobre tu inconveniente
  3. Incluye tu versión de Node.js, sistema operativo y cualquier mensaje de error