Ligar um assistente

O URL do conector

O People expõe um servidor MCP (Model Context Protocol, o padrão aberto que os assistentes de IA usam para falar com sistemas externos) no URL da tua organização:

https://<a-tua-organizacao>.slxd.app/mcp/people

Se trabalhas num espaço pessoal em vez de numa organização partilhada:

https://people.slxd.app/mcp/people

Fala o transporte padrão Streamable HTTP, pelo que qualquer cliente compatível se pode ligar: Claude, ChatGPT, Claude Code, Cursor e mais.

Duas formas de te autenticares

Iniciar sessão com a tua conta (OAuth) — recomendado

É o caminho para Claude e ChatGPT. Adiciona o URL do conector como conector remoto no cliente; da primeira vez que te ligares, abre-se uma janela para iniciares sessão com a tua própria conta e aprovares o acesso. A partir daí o assistente atua como tu: vê o que a tua função te deixa ver, e só isso.

Não há nenhuma chave para copiar, guardar ou enviar por e-mail. Revogar a sessão ou desligar o assistente da tua conta corta o acesso de imediato.

Uma chave de API

Para clientes que pedem um token (Cursor, Claude Code, scripts): gera uma chave em Chaves de API, na tua conta, e envia-a num cabeçalho Authorization: Bearer. O valor é mostrado uma única vez — guarda-o com o mesmo cuidado que uma palavra-passe.

Uma chave pode estar ligada a uma organização específica ou ficar sem ligar; sem organização, nenhuma ferramenta que precise de dados da organização vai funcionar até a ligares a partir da tua conta.

O que o assistente pode fazer

Com qualquer um dos dois caminhos, o assistente pode:

  • Ler — procurar funcionários, obter a ficha ou o currículo de um, ausências e saldos de férias, registos de ponto, cargos, departamentos, locais, o organograma e os KPI do painel.
  • Agir, com a tua confirmação — pedir uma ausência, registar a tua própria entrada ou saída, e atualizar o título do currículo de um funcionário. Toda a ferramenta que altera dados pede confirmação explícita antes de executar de verdade: o assistente mostra primeiro o que vai fazer.

Toda a chamada fica limitada à tua organização e verifica a mesma permissão (e as mesmas regras "és tu" / "és o responsável dele") que terias na aplicação — se a tua função não pode ver os dados sensíveis de alguém, o assistente também não os pode ver em teu nome.

Sem cliente à mão? Usa o painel

O assistente integrado responde com as mesmas ferramentas sem nada a configurar — útil para verificar que uma ligação funciona antes de configurares um cliente externo.

Ligar um assistente