Ligar um assistente

O URL de conector

O Projects 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/projects

Se trabalhas num espaço pessoal e não numa organização partilhada:

https://projects.slxd.app/mcp/projects

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

Duas formas de te autenticares

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

É a via para o Claude e o ChatGPT. Adiciona o URL do conector como conector remoto no cliente; da primeira vez que ligares abrir-se-á uma janela para iniciares sessão com a tua própria conta e aprovares o acesso. A partir daí o assistente age como tu: vê o que o teu papel te deixa ver — e, nos projetos que não geres por papel, só os que diriges ou onde estás na equipa — e só o que o teu papel te deixa ver.

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

Uma chave de API

Para clientes que aceitam um token (Cursor, Claude Code, scripts): gera uma chave em Chaves de API, dentro da tua conta, e envia-a num cabeçalho Authorization: Bearer. O valor mostra-se uma única vez — guarda-o como farias com qualquer palavra-passe.

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

O que o assistente pode fazer

Por qualquer das duas vias, o assistente pode:

  • Consultar — projetos, tarefas, o planeamento de uma pessoa, alertas de planeamento, margens por projeto, tickets e bolsas de horas.
  • Atuar, com a tua confirmação — criar uma tarefa, mudar o seu estado, registar dedicação, abrir um ticket e comentá-lo. Estas cinco pedem confirmação explícita antes de se executarem de verdade: o assistente mostra-te primeiro o que vai fazer.

Cada chamada fica limitada à tua organização e verifica a mesma permissão — e a mesma relação (dirigir o projeto, ser o seu atribuído) — que terias na aplicação: se não podes ver ou tocar em algo no ecrã, o assistente também não pode em teu nome.

Sem cliente? Usa o painel

O assistente integrado responde às mesmas perguntas de leitura sem nada para configurar — útil para experimentar antes de ligar um cliente externo.

Ligar um assistente