Servidor MCP
|
El servidor MCP de ITM Platform conecta asistentes y agentes de IA con su cartera de proyectos a través del Model Context Protocol. Su cliente de IA puede buscar proyectos, consultar presupuestos, resumir el estado de la cartera, crear tareas, registrar riesgos e incidencias y actualizar detalles de proyectos, siempre usando sus propios permisos de ITM Platform. |
Funciona con Claude, VS Code, Cursor, OpenAI Codex, Windsurf, JetBrains AI Assistant y cualquier otro cliente compatible con MCP.
La documentación técnica completa, que incluye la configuración para cada cliente y la referencia completa de herramientas, está disponible en la Documentación MCP de ITM Platform en el sitio para desarrolladores de ITM Platform.
Qué es MCP
El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse con sistemas externos de forma coherente. En lugar de copiar y pegar datos en un chat, conecta su cliente de IA con el servidor MCP de ITM Platform una sola vez, y el asistente podrá leer y actuar sobre los datos de su cartera en su nombre.
El servidor se autentica como usted, llama a las API de ITM Platform y devuelve únicamente los datos a los que su cuenta de ITM Platform tiene acceso.
Qué puede hacer un agente
Desde consultas sencillas hasta flujos de trabajo totalmente automatizados, MCP habilita casos de uso cada vez más potentes:
- Consultas rápidas -- Haga una pregunta y obtenga una respuesta, como "¿Qué riesgos están abiertos en mi cartera?"
- Análisis en varios pasos -- El agente encadena varias herramientas y sintetiza los resultados, por ejemplo revisando todos los proyectos que terminan este trimestre y señalando desviaciones de presupuesto, riesgos de alto impacto o tareas con poco avance.
- Acciones masivas automatizadas -- El agente lee, decide y escribe en varios proyectos, por ejemplo pasando a Ejecución los proyectos detenidos y creando una tarea de arranque para cada jefe de proyecto.
- Inteligencia programada -- Un agente se ejecuta de forma programada sin intervención humana, por ejemplo recopilando las tareas vencidas cada lunes y publicando un resumen agrupado por jefe de proyecto.
- Orquestación entre sistemas -- Combine el MCP de ITM Platform con otros servidores MCP (GitHub, Slack, calendario, correo) para que una acción en un sistema desencadene actualizaciones en ITM Platform.
A qué puede acceder
El servidor expone un conjunto de herramientas para leer y actualizar sus datos, además de recursos y prompts guiados para tareas de análisis habituales.
Lectura -- Buscar y obtener proyectos, servicios, tareas, presupuestos, compras, ingresos, riesgos, incidencias, usuarios y datos de referencia, y ejecutar consultas agregadas de cartera y del DataMart para análisis avanzados.
Escritura -- Crear tareas, riesgos e incidencias, y actualizar tareas y detalles de proyectos como estado, fechas, responsables y prioridad.
Prompts guiados -- Flujos de trabajo predefinidos para resúmenes de estado de proyecto, visión general de la cartera, revisión de la carga de trabajo del equipo y análisis de riesgos.
Para ver la lista completa de herramientas, recursos y prompts, consulte la Documentación MCP.
Cómo conectarse
Hay dos formas de conectar su cliente de IA. Ambas se explican paso a paso en la documentación para desarrolladores.
| Método | Valor de conexión | Ideal para |
|---|---|---|
| Alojado (OAuth) | https://api.itmplatform.com/v2/_/mcp/ |
La mayoría de usuarios y clientes de IA gestionados. No hay nada que instalar: solo inicie sesión con su cuenta de ITM Platform. |
| Local (clave de API) | npx @itm-platform/mcp-server |
Ejecución local, redes con cortafuegos o instancias autoalojadas de ITM Platform. |
Con la opción alojada, su cliente de IA nunca ve su contraseña ni su clave de API de ITM Platform: usted inicia sesión a través de ITM Platform y aprueba el acceso solicitado. Es la configuración recomendada para la mayoría de usuarios.
Con la opción local, el servidor se ejecuta en su equipo y se autentica con una clave de API personal. Para crear una, inicie sesión en ITM Platform, abra Mi perfil y genere una clave en la sección Clave de API.
Tras añadir cualquiera de las conexiones, abra el comando MCP o la lista de servidores de su cliente. En los clientes que admiten comandos de barra, escriba /mcp, seleccione itm-platform y autentíquese cuando se le solicite.
Quién puede acceder
El servidor MCP usa el mismo modelo de identidad y permisos que ITM Platform, por lo que un agente solo puede ver y modificar lo que usted mismo podría ver y modificar.
| Licencia | Acceso MCP |
|---|---|
| Administrador de empresa | Acceso total de lectura y escritura |
| Usuario completo | Acceso total de lectura y escritura |
| Jefe de proyecto | Todavía no disponible |
| Miembro de equipo | Bloqueado |
Al conectarse con OAuth, el acceso se controla además mediante ámbitos (scopes): mcp:read permite las herramientas de solo lectura, mientras que mcp:write añade las herramientas de creación y actualización.
Los datos de los proyectos se devuelven al cliente de IA que usted elija, por lo que la política de tratamiento de datos del proveedor de IA se aplica a cualquier dato que procese. Todas las respuestas generadas por IA deben revisarse antes de tomar decisiones.
Cómo empezar
La documentación técnica completa, que incluye la configuración por cliente, la referencia completa de herramientas y prompts, los detalles de autenticación y la resolución de problemas, está disponible en el sitio para desarrolladores de ITM Platform:
Documentación MCP de ITM Platform
Relacionado
- DataMart -- capa de datos GraphQL optimizada para lectura que utilizan algunas herramientas de análisis de MCP.
- API -- la API REST que el servidor MCP llama en su nombre.
- Bot para Microsoft Teams -- pregunte a PMPilot sobre sus datos de ITM Platform directamente en Teams.