INTEGRACIÓNGuide

Conectar un cliente de IA a Movitera MCP

Usa Movitera MCP para consultar tu workspace desde un cliente de IA externo, sin copiar credenciales ni conceder más acceso del que tu cuenta ya tiene.

Antes de comenzar

Una cuenta activa en Movitera® y acceso al equipo que quieres consultar.
Un cliente con soporte para servidores MCP remotos, como Claude, Cursor, ChatGPT u otro cliente compatible.
Una confirmación reciente de segundo factor. Movitera pide esta verificación antes de aprobar la conexión.
La URL de Movitera MCP. Termina en /mcp.

Conecta por URL

1
En el cliente de IA, agrega un servidor MCP remoto.
Cuando el cliente pida la URL del servidor, pega la URL de Movitera MCP.
2
Entra en Movitera cuando se abra el navegador.
La autorización sucede en el navegador. Entra con tu cuenta normalmente y completa la verificación de seguridad cuando se solicite.
3
Elige el equipo y aprueba la conexión.
La pantalla de autorización muestra qué cliente pide acceso. Revisa antes de aprobar. La conexión queda limitada al equipo que elijas; para consultar otro equipo, agrega otra conexión y apruébala para ese equipo.

Vuelve al cliente de IA.

resultado

El cliente pasa a consultar las áreas de Movitera que tu cuenta puede acceder.

Entiende la pantalla de autorización

La pantalla de autorización muestra quién pide acceso, qué podrá hacer la conexión y qué equipo verá. Revisa cada elemento antes de elegir Permitir o Recusar (Rechazar).

Elemento de la pantalla	Qué significa
`Destino`	La dirección que recibe el acceso cuando apruebas. Confirma que corresponde al cliente que estás conectando.
`Este aplicativo poderá` (Esta aplicación podrá)	Qué puede hacer la conexión. `Ler seus dados da Movitera` (Leer tus datos de Movitera) cubre lo que tu cuenta ya ve. `Fazer alterações, com sua confirmação a cada vez` (Hacer cambios, con tu confirmación cada vez) solo aparece cuando el workspace habilita escritura.
`Time` (Equipo)	El equipo cuyos datos ve la conexión. La lista muestra solo los equipos donde eres miembro activo. Para consultar otro equipo, crea otra conexión.
`Nome da conexão (opcional)` (Nombre de la conexión, opcional)	El nombre que identifica esta conexión en Tokens de acceso. Si lo dejas vacío, Movitera usa `MCP ·` seguido del nombre del cliente. Usa un nombre que identifique el dispositivo, como `Claude no meu notebook` (Claude en mi notebook).
`Esta solicitação expira em` (Esta solicitud expira en)	Contador de la ventana de aprobación, de cerca de 10 minutos. Al llegar a cero, la pantalla muestra `Esta solicitação expirou` (Esta solicitud expiró); inicia la conexión de nuevo desde el cliente.

Aplicación no identificada

Cuando el cliente no informa su propio nombre, la pantalla muestra Conectar um aplicativo à Movitera (Conectar una aplicación a Movitera) y el aviso Não foi possível confirmar o nome deste aplicativo. Continue apenas se você mesmo iniciou esta conexão. (No fue posible confirmar el nombre de esta aplicación. Continúa solo si tú mismo iniciaste esta conexión.) Aprueba solo si acabas de iniciar la conexión en ese cliente; ante la duda, elige Recusar (Rechazar).

Qué pedir al cliente

Pide un runbook o política del Wiki antes de responder con conocimiento general.
Pide que resuma tickets de Closure, issues de Forge, tareas de hoy, contratos de proveedores o activos asignados a ti.
Usa filtros de fecha, estado, responsable, proveedor o categoría cuando quieras una lista menor.
Si tu workspace habilita acciones de escritura, el cliente pide confirmación antes de cada cambio. Muchos workspaces ejecutan MCP solo lectura, sin herramientas para modificar datos.

Atajos

Algunos clientes MCP también muestran recursos para adjuntar tickets, páginas del Wiki o issues como contexto, y prompts como /triage-ticket, /draft-release-notes, /weekly-supplier-review y /onboard-asset.

Áreas que el cliente puede consultar

Área	Ejemplos de uso
Wiki	Encontrar páginas, runbooks, políticas y documentación del equipo.
Closure	Consultar tickets, conversaciones, categorías y solicitudes abiertas.
Forge	Consultar issues, iniciativas y trabajo de ingeniería.
Tasks	Listar tareas de hoy, actividades y categorías.
SRM	Consultar proveedores, contratos, facturas y vencimientos.
Inventory	Consultar activos, equipos asignados y garantías próximas al vencimiento.
Usuarios	Encontrar personas del workspace cuando la pregunta depende de responsable, solicitante o miembro del equipo.

Vault queda fuera de MCP

Credenciales, contraseñas, tokens y claves de Vault no se exponen por MCP. Para ver un secreto, abre la credencial en Vault.

Cómo escribir buenas preguntas

Di qué área debe consultar el cliente: Wiki, Closure, Forge, Tasks, SRM o Inventory.
Incluye filtros que usarías en Movitera, como período, estado, proveedor, responsable o categoría.
Pide que cite los registros usados cuando necesites verificar el origen de la respuesta.
Para procesos del equipo, pide primero que busque en Wiki y después resuma el resultado.

Cómo el acceso queda limitado

Cada herramienta revalida tu usuario y los permisos del módulo antes de devolver datos.
Sin acceso a Forge, por ejemplo, las herramientas de Forge no devuelven issues ni iniciativas.
Muchos workspaces ejecutan MCP solo lectura; en esos casos ninguna herramienta modifica datos.
Cuando las acciones de escritura están habilitadas, cada cambio pide confirmación explícita en el cliente.
Las consultas a Vault no revelan contraseñas, tokens ni claves.

Gestionar o revocar acceso

Al aprobar, Movitera crea un token de acceso para ese cliente y ese equipo, con el nombre que definiste en Nome da conexão (opcional) (Nombre de la conexión, opcional). Vale por cerca de 90 días.
Puedes ver y revocar ese token en Configurações (Configuración) → Tokens de acesso do cofre (Tokens de acceso del cofre). Consulta Tokens de acceso.
Revocar desconecta el cliente de inmediato. Para usarlo de nuevo, conecta y aprueba otra vez.

Si no funciona

La URL no es aceptada: confirma que pegaste la URL de Movitera MCP. Termina en /mcp.
No aparece ninguna herramienta: confirma que el cliente soporta servidores MCP remotos y reconecta la integración.
La herramienta no encuentra datos: confirma tu acceso al módulo en Movitera e intenta una búsqueda más específica.
No puedes aprobar: entra nuevamente en Movitera, completa la confirmación de segundo factor y selecciona un equipo activo.
Esta solicitação expirou (Esta solicitud expiró): la ventana de aprobación de cerca de 10 minutos terminó antes de que eligieras Permitir. Inicia la conexión de nuevo desde el cliente; la pantalla abre con un nuevo contador.
Esta solicitação já foi processada (Esta solicitud ya fue procesada): el enlace ya fue aprobado o rechazado, en general por una pestaña antigua. Si necesitas una nueva conexión, inicia de nuevo desde el cliente.
Link de autorização inválido (Enlace de autorización inválido): el enlace abierto está incompleto o ya no apunta a una solicitud válida. Inicia la conexión de nuevo desde el cliente para recibir un nuevo enlace.
Você não é membro ativo deste time. Selecione outro time e tente novamente. (No eres miembro activo de este equipo. Selecciona otro equipo e intenta de nuevo.): tu participación en el equipo elegido está inactiva. Elige otro equipo en el campo Time (Equipo) o pide al administrador del equipo que reactive tu acceso.
Autenticação de dois fatores cancelada. Tente novamente. (Autenticación de dos factores cancelada. Intenta de nuevo.): la confirmación de seguridad se cerró antes de concluir. Elige Permitir de nuevo y completa la verificación.