Conectar un cliente de IA a Movitera MCP

• 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: https://api.movitera.com/mcp.
• Si usas Cursor, sigue la sección **Conecta Cursor** abajo en lugar de pegar solo la URL.

1. 1

   En el cliente de IA, agrega un servidor MCP remoto.

   Cuando el cliente pida la URL del servidor, pega https://api.movitera.com/mcp.

2. 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. 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.

4. 4

   Vuelve al cliente de IA.

   resultado

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

El flujo remoto nativo de Cursor suele abrir una página en blanco en el navegador (about:blank) o un aviso para abrir Cursor antes de que aparezca la pantalla de autorización de Movitera. Usa la configuración de abajo para que la autorización pase por un proxy local que Cursor maneja de forma confiable.

1. 1

   Abre **Configuración de Cursor → Tools & MCP** (o edita `~/.cursor/mcp.json`).

2. 2

   Agrega este servidor:

   json

   {
     "mcpServers": {
       "movitera": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://api.movitera.com/mcp"]
       }
     }
   }

3. 3

   Guarda y recarga los servidores MCP si Cursor no aplica el cambio.

4. 4

   Haz clic en **Connect** en el servidor `movitera`.

5. 5

   Cuando el navegador abra la página de autorización de Movitera, entra, completa la verificación de seguridad, elige el equipo y selecciona **Permitir**.

   resultado

   Cursor pasa a listar las herramientas de Movitera, y el agente puede consultar las áreas que tu cuenta accede en ese equipo.

**Requisitos:** Node.js disponible en el PATH para que npx funcione. En la primera conexión, el paquete mcp-remote puede descargarse.

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).

• 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.

• 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.

• 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 aparecen en tu cliente — el catálogo que el cliente ve refleja tus permisos.
• 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.

• 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.

• Cursor abre about:blank o pide abrir Cursor.app sin mostrar la página de autorización de Movitera: no apruebes ese aviso como conexión. Usa **Conecta Cursor** con mcp-remote en lugar de pegar solo https://api.movitera.com/mcp como URL remota.
• La URL no es aceptada: confirma que pegaste https://api.movitera.com/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.