Manisma
Iniciar teste grátis
Documentation menu
Docs/PT-BR

Conecte seu assistente de IA

O Manisma pode se conectar a um assistente de IA que você já usa, como Claude Desktop, Claude Code, o aplicativo de desktop do ChatGPT ou o Codex CLI. A conexão usa o protocolo aberto Model Context Protocol. Você pode então fazer perguntas e realizar o trabalho de planejamento na janela de conversa do seu assistente.

Seu assistente, sua IA

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

O botão Proposta da IA no Manisma é separado. Esse recurso usa a IA do Manisma e as ações de IA do seu plano.

O que seu assistente pode fazer

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, agendar uma ordem de serviço com um técnico e solicitar uma proposta de planejamento. Ele nunca pode excluir nada.

Criar uma chave

Abra Administração → Chaves de API, crie uma chave e copie-a imediatamente. A chave é exibida apenas uma vez. Leitura, escrita e planejamento são permissões separadas. Por isso, uma chave somente de leitura pode consultar informações, mas não pode alterá-las. Trate a chave como uma senha.

Instalar a conexão

Todas as rotas exigem Node.js 22 ou posterior. Verifique a versão instalada:

node --version

Obtenha a chave de API em Administração → Chaves de API. Ela é exibida uma única vez e tem o formato msk_ seguido de 40 caracteres hexadecimais. Leitura, escrita e planejamento são permissões separadas.

Rota 1: Claude Desktop

  1. Baixe https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra o arquivo baixado. O Claude Desktop mostra uma janela de instalação.
  3. Cole a chave de API quando solicitado. Ela é armazenada com segurança.

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

Rota 2: Claude Code

  1. Baixe https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra um terminal na pasta do download 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 conexão.

Rota 3: Codex CLI e o aplicativo de desktop do ChatGPT

  1. Baixe https://manisma.com/downloads/manisma-mcp-0.2.0.mcpb.
  2. Abra um terminal na pasta do download e extraia o arquivo:
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 deve ser absoluto, pois ~ não é expandido neste arquivo.
[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. Ele deve mostrar manisma como enabled.

No Windows, o arquivo .mcpb é um arquivo ZIP. Se o Windows não conseguir extraí-lo, renomeie a extensão para .zip e use Extrair Tudo.

O que esperar

Seu assistente pede confirmação antes de alterar qualquer coisa e lida com uma ordem de serviço por vez. Uma proposta de planejamento é exibida primeiro e não é aplicada até que você a confirme.

O assistente não consegue ver os horários de trabalho nem os dias de folga. Confira um horário proposto na agenda real. As propostas de planejamento são limitadas a algumas solicitações a cada dez minutos.

Limitações

A conexão funciona com os dados salvos no Manisma. Ela não substitui o quadro de planejamento e só está atualizada até o que foi salvo.

Still have questions about Manisma?

Contact us →