INTEGRAÇÃOGuide

Conectar um cliente de IA ao Movitera MCP

Use o Movitera MCP para consultar dados do seu workspace a partir de um cliente de IA externo, sem copiar credenciais ou dar acesso além do que sua conta já permite.

Antes de começar

Uma conta ativa no Movitera® e acesso ao time que você quer consultar.
Um cliente com suporte a servidor MCP remoto, como Claude, Cursor, ChatGPT ou outro cliente compatível.
Uma confirmação recente de segundo fator. O Movitera pede essa verificação antes de aprovar a conexão.
A URL do Movitera MCP. Ela termina em /mcp.

Conecte por URL

1
No cliente de IA, adicione um servidor MCP remoto.
Quando o cliente pedir a URL do servidor, cole a URL do Movitera MCP.
2
Entre no Movitera quando o navegador abrir.
A autorização acontece no navegador. Entre com sua conta normalmente e conclua a verificação de segurança quando solicitado.
3
Escolha o time e aprove a conexão.
A tela de autorização mostra qual cliente está pedindo acesso. Revise antes de aprovar. A conexão fica limitada ao time que você escolher; para consultar outro time, adicione outra conexão e aprove para esse time.

Volte para o cliente de IA.

resultado

O cliente passa a consultar as áreas do Movitera que sua conta pode acessar.

Entenda a tela de autorização

A tela de autorização mostra quem está pedindo acesso, o que a conexão poderá fazer e qual time ela vai enxergar. Confira cada item antes de escolher Permitir ou Recusar.

Item da tela	O que significa
`Destino`	O endereço que recebe o acesso quando você aprova. Confirme que corresponde ao cliente que você está conectando.
`Este aplicativo poderá`	O que a conexão pode fazer. `Ler seus dados da Movitera` cobre o que sua conta já enxerga. `Fazer alterações, com sua confirmação a cada vez` só aparece quando o workspace habilita escrita.
`Time`	O time cujos dados a conexão enxerga. A lista mostra apenas os times em que você é membro ativo. Para consultar outro time, crie outra conexão.
`Nome da conexão (opcional)`	O nome que identifica essa conexão em Tokens de acesso. Se você não preencher, o Movitera usa `MCP ·` seguido do nome do cliente. Use um nome que identifique o dispositivo, como `Claude no meu notebook`.
`Esta solicitação expira em`	Contador da janela de aprovação, de cerca de 10 minutos. Ao chegar a zero, a tela mostra `Esta solicitação expirou`; inicie a conexão novamente a partir do cliente.

Aplicativo não identificado

Quando o cliente não informa o próprio nome, a tela mostra Conectar um aplicativo à Movitera e o aviso Não foi possível confirmar o nome deste aplicativo. Continue apenas se você mesmo iniciou esta conexão. Aprove somente se você acabou de iniciar a conexão nesse cliente; em dúvida, escolha Recusar.

O que pedir ao cliente

Pergunte por um runbook ou política do Wiki antes de responder com conhecimento geral.
Peça para resumir tickets do Closure, issues do Forge, tarefas do dia, contratos de fornecedores ou ativos atribuídos a você.
Use filtros de data, status, responsável, fornecedor ou categoria quando quiser uma lista menor.
Se seu workspace habilita ações de escrita, o cliente pede confirmação antes de cada mudança. Muitos workspaces rodam MCP somente leitura, sem ferramentas para modificar dados.

Atalhos

Alguns clientes MCP também mostram recursos para anexar tickets, páginas do Wiki ou issues como contexto, e prompts como /triage-ticket, /draft-release-notes, /weekly-supplier-review e /onboard-asset.

Áreas que o cliente pode consultar

Área	Exemplos de uso
Wiki	Encontrar páginas, runbooks, políticas e documentação do time.
Closure	Consultar tickets, conversas, categorias e chamados abertos.
Forge	Consultar issues, iniciativas e trabalho de engenharia.
Tasks	Listar tarefas do dia, atividades e categorias.
SRM	Consultar fornecedores, contratos, faturas e vencimentos.
Inventory	Consultar ativos, equipamentos atribuídos e garantias próximas do vencimento.
Usuários	Encontrar pessoas do workspace quando a pergunta depende de responsável, solicitante ou membro do time.

Vault fica fora do MCP

Credenciais, senhas, tokens e chaves do Vault não são expostos ao MCP. Para consultar um segredo, abra a credencial no Vault.

Como escrever boas perguntas

Diga qual área o cliente deve consultar: Wiki, Closure, Forge, Tasks, SRM ou Inventory.
Inclua filtros que você usaria no Movitera, como período, status, fornecedor, responsável ou categoria.
Peça para citar os registros usados quando você precisar conferir a origem da resposta.
Para processos do time, peça primeiro para procurar no Wiki e depois resumir o resultado.

Como o acesso fica limitado

Cada ferramenta revalida seu usuário e as permissões do módulo antes de retornar dados.
Sem acesso ao Forge, por exemplo, ferramentas do Forge não retornam issues nem iniciativas.
Muitos workspaces rodam MCP somente leitura; nesses casos nenhuma ferramenta modifica dados.
Quando ações de escrita estão habilitadas, cada mudança pede confirmação explícita no cliente.
Consultas ao Vault não revelam senhas, tokens ou chaves.

Gerencie ou revogue acesso

Ao aprovar, o Movitera cria um token de acesso para esse cliente e esse time, com o nome que você definiu em Nome da conexão (opcional). Ele vale por cerca de 90 dias.
Você pode ver e revogar esse token em Configurações → Tokens de acesso do cofre. Veja Tokens de acesso.
Revogar desconecta o cliente imediatamente. Para usar de novo, conecte e aprove novamente.

Se não funcionar

A URL não é aceita: confirme se você colou a URL do Movitera MCP. Ela termina em /mcp.
Nenhuma ferramenta aparece: confirme se o cliente suporta servidores MCP remotos e reconecte a integração.
A ferramenta não encontra dados: confirme seu acesso ao módulo no Movitera e tente uma busca mais específica.
Você não consegue aprovar: entre novamente no Movitera, conclua a confirmação de segundo fator e selecione um time ativo.
Esta solicitação expirou: a janela de aprovação de cerca de 10 minutos terminou antes de você escolher Permitir. Inicie a conexão novamente a partir do cliente; a tela abre com um novo contador.
Esta solicitação já foi processada: o link já foi aprovado ou recusado, em geral por uma aba antiga. Se precisar de uma nova conexão, inicie de novo a partir do cliente.
Link de autorização inválido: o link aberto está incompleto ou não aponta mais para uma solicitação válida. Inicie a conexão novamente a partir do cliente para receber um novo link.
Você não é membro ativo deste time. Selecione outro time e tente novamente.: sua participação no time escolhido está inativa. Escolha outro time no campo Time ou peça ao administrador do time para reativar seu acesso.
Autenticação de dois fatores cancelada. Tente novamente.: a confirmação de segurança foi fechada antes de concluir. Escolha Permitir de novo e conclua a verificação.