Roster

Roster expone un servidor MCP en:

/mcp

MCP es la superficie de integración principal nativa para agentes. Admite enrutamiento empresarial de propósito abierto a través de resolve y herramientas exactas para flujos de trabajo de proyecto, participante, etiqueta, delegación, directorio e historial de resolución.

Roster autentica las solicitudes MCP remotas antes de leer su cuerpo JSON-RPC. Los cuerpos de solicitud están limitados a 1 MiB; las solicitudes más grandes devuelven HTTP 413.

Usar MCP Para

• preguntas de enrutamiento en lenguaje natural
• gestión de proyectos y participantes nativa para agentes
• comprobaciones exactas de membresía
• gestión de delegaciones
• historial de solicitudes de resolución

Configuración del Cliente

Usa las guías de configuración dedicadas para los detalles de conexión específicos del cliente:

• Claude
• Codex
• ChatGPT

Enrutamiento de Herramientas

Usa resolve para preguntas empresariales de propósito abierto, como quién debería encargarse de una tarea, a quién contactar, quién es responsable o quién puede actuar mediante una delegación activa.

Usa herramientas exactas para comprobaciones exactas de datos. Por ejemplo, para verificar si un usuario o grupo pertenece a un proyecto, lista proyectos, lista participantes y luego lista los miembros del participante.

Entorno de Ejecución de Resolve

La herramienta resolve acepta un query en lenguaje natural. Las referencias a proyectos, etiquetas, roles de participantes y otras restricciones son extraídas por el resolvedor. El entorno de ejecución luego selecciona participantes coincidentes y resuelve los usuarios asociados, incluidos los usuarios directamente asociados, los miembros activos de grupos asociados y las delegaciones activas.

Cuando una consulta incluye un umbral como un monto, región, nivel o alcance y los participantes candidatos exponen límites coincidentes, Resolve debe elegir el participante más restringido que satisfaga el umbral. No debe agregar participantes senior, de respaldo o de escalamiento a menos que el umbral supere el límite inferior o el usuario solicite explícitamente un escalamiento.

Cuando una consulta solicita múltiples responsabilidades, Resolve trata cada responsabilidad por separado y selecciona participantes solo cuando los datos del roster proporcionados muestran que manejan esa responsabilidad.

La respuesta MCP de nivel superior status es una de:

• ok
• configuration_error
• agent_error
• server_error

Cuando status es ok, result.resolution_status es una de:

• success
• out_of_scope
• not_found