Lattice HQ

Interaja com a plataforma de gestão de desempenho Lattice.

GitHub
6

Documentação

Servidor MCP Lattice HQ

Um servidor Model Context Protocol (MCP) para Lattice HQ que permite que modelos de IA interajam com sua plataforma de gestão de desempenho Lattice.

Recursos

Este servidor MCP fornece acesso às seguintes capacidades do Lattice HQ:

Gestão de Usuários

  • Obter todos os usuários da organização
  • Obter detalhes de um usuário específico
  • Obter subordinados diretos de qualquer usuário
  • Obter informações do usuário atual

Gestão de Metas

  • Obter todas as metas da organização
  • Obter detalhes de uma meta específica
  • Obter metas de um usuário específico

Ciclos de Avaliação

  • Obter todos os ciclos de avaliação
  • Obter detalhes de um ciclo de avaliação específico
  • Obter avaliados de um ciclo de avaliação

Feedback

  • Obter todos os feedbacks
  • Obter detalhes de um feedback específico

Departamentos

  • Obter todos os departamentos
  • Obter detalhes de um departamento específico

Atualizações

  • Obter todas as atualizações
  • Obter detalhes de uma atualização específica

Pré-requisitos

  • Node.js 18 ou superior
  • Conta Lattice HQ com acesso à API
  • Token da API Lattice

Instalação

Método 1: Usando NPX (Recomendado)

Nenhuma instalação necessária! Basta usar npx para executar a versão mais recente:

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

Método 2: Instalação 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: Desenvolvimento 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

Obtendo Seu Token da API Lattice

Método 1: Através das Configurações do Lattice

  1. Faça login na sua conta Lattice HQ
  2. Vá para Configurações → Integrações → API (se disponível)
  3. Gere um novo token de API
  4. Copie o token e adicione-o à sua configuração

Método 2: Contate o Suporte Lattice

Se você não vir "Integrações" em Configurações, isso geralmente significa:

  • Seu plano não inclui acesso à API (geralmente apenas Enterprise)
  • Você não tem permissões de administrador
  • O acesso à API precisa ser habilitado para sua conta

Contate o Suporte Lattice:

Uso

Executando o Servidor

Com Token de API:

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

Ou inline:

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

Usando com Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do 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

Configuração:

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

Configuração:

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

Usando com Outros Clientes MCP

Este servidor segue o protocolo MCP padrão e pode ser usado com qualquer cliente compatível com MCP.

Ferramentas Disponíveis

Ferramentas de Usuário

  • lattice_get_users - Obter todos os usuários
  • lattice_get_user - Obter usuário por ID
  • lattice_get_user_direct_reports - Obter subordinados diretos do usuário
  • lattice_get_me - Obter usuário atual

Ferramentas de Metas

  • lattice_get_goals - Obter todas as metas
  • lattice_get_goal - Obter meta por ID
  • lattice_get_user_goals - Obter metas de um usuário

Ferramentas de Ciclo de Avaliação

  • lattice_get_review_cycles - Obter todos os ciclos de avaliação
  • lattice_get_review_cycle - Obter ciclo de avaliação por ID
  • lattice_get_review_cycle_reviewees - Obter avaliados de um ciclo

Ferramentas de Feedback

  • lattice_get_feedbacks - Obter todos os feedbacks
  • lattice_get_feedback - Obter feedback por ID

Ferramentas de Departamento

  • lattice_get_departments - Obter todos os departamentos
  • lattice_get_department - Obter departamento por ID

Ferramentas de Atualização

  • lattice_get_updates - Obter todas as atualizações
  • lattice_get_update - Obter atualização por ID

Configuração

Você pode configurar o servidor usando variáveis de ambiente:

  • LATTICE_API_TOKEN: Seu token da API Lattice (obrigatório)
  • LATTICE_API_URL: URL base da API Lattice (obrigatório)

Desenvolvimento

# Install dependencies
npm install

# Build in watch mode
npm run watch

# Run development server
npm run dev

# Build for production
npm run build

Contribuindo

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

Suporte

Se você encontrar algum problema:

  1. Verifique as Issues do GitHub
  2. Crie uma nova issue com detalhes sobre o seu problema
  3. Inclua sua versão do Node.js, sistema operacional e quaisquer mensagens de erro