Manisma
Iniciar trial gratuito
Documentation menu
Docs/PT-PT

Ligar o seu assistente de IA

O Manisma pode ligar-se a um assistente de IA que já utiliza, como Claude Desktop, Claude Code, a aplicação de ambiente de trabalho do ChatGPT ou o Codex CLI. A ligação utiliza o protocolo aberto Model Context Protocol. Pode então colocar questões e fazer trabalho de planeamento na janela de conversa do seu assistente.

O seu assistente, a sua IA

É o seu próprio assistente que pensa. O Manisma fornece o planeamento e os dados, mas não executa a sua própria IA para esta ligação. A ligação também não consome as ações de IA incluídas no seu plano Manisma.

O botão Proposta de IA no Manisma é separado. Esta funcionalidade utiliza a IA do Manisma e as ações de IA do seu plano.

O que o seu assistente pode fazer

O seu assistente pode procurar ordens de serviço, clientes, técnicos, materiais, tipos de tarefa e dispositivos. Pode criar e atualizar ordens de serviço e clientes, planear uma ordem de serviço com um técnico e pedir uma proposta de planeamento. Nunca pode eliminar nada.

Criar uma chave

Abra Gestão → Chaves de API, crie uma chave e copie-a de imediato. A chave é mostrada apenas uma vez. Ler, escrever e planear são permissões separadas. Uma chave só de leitura pode, por isso, procurar informação, mas não a pode alterar. Trate a chave como uma palavra-passe.

Instalar a ligação

Todos os métodos requerem Node.js 22 ou posterior. Verifique a versão instalada:

node --version

Obtenha a chave de API em Gestão → Chaves de API. É mostrada uma única vez e tem o formato msk_ seguido de 40 carateres hexadecimais. Ler, escrever e planear são permissões separadas.

Método 1: Claude Desktop

  1. Transfira https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra o ficheiro transferido. O Claude Desktop mostra uma janela de instalação.
  3. Cole a chave de API quando esta for pedida. É guardada em segurança.

Não é necessário editar ficheiros nem usar um terminal.

Método 2: Claude Code

  1. Transfira https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra um terminal na pasta da transferência e execute:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
claude mcp add manisma -e MANISMA_API_KEY=msk_your_key_here -- node ~/manisma-mcp/dist/index.js
  1. Substitua msk_your_key_here pela chave de API.
  2. No Claude Code, use o comando /mcp para verificar a ligação.

Método 3: Codex CLI e a aplicação de ambiente de trabalho do ChatGPT

  1. Transfira https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra um terminal na pasta da transferência e extraia o ficheiro:
unzip manisma-mcp-0.2.0.mcpb -d ~/manisma-mcp
  1. Adicione este bloco a ~/.codex/config.toml, substituindo o caminho e a chave. O caminho tem de ser absoluto, pois ~ não é expandido neste ficheiro.
[mcp_servers.manisma]
command = "node"
args = ["/home/you/manisma-mcp/dist/index.js"]
env = { MANISMA_API_KEY = "msk_your_key_here" }
  1. Execute codex mcp list. Deverá mostrar manisma como enabled.

No Windows, o ficheiro .mcpb é um arquivo ZIP. Se o Windows não o extrair, mude a extensão para .zip e use Extrair Tudo.

O que esperar

O seu assistente pede confirmação antes de alterar algo e trata uma ordem de serviço de cada vez. Uma proposta de planeamento é mostrada primeiro e só é aplicada depois de a confirmar.

O assistente não consegue ver horários de trabalho nem dias de folga. Verifique uma hora proposta com a agenda real. As propostas de planeamento estão limitadas a alguns pedidos por cada dez minutos.

Limitações

A ligação funciona com os dados guardados no Manisma. Não substitui o quadro de planeamento e só está atualizada até ao que foi guardado.

Still have questions about Manisma?

Contact us →