Roster

Roster expõe um servidor MCP em:

/mcp

MCP é a principal superfície de integração nativa para agentes. Ele suporta roteamento de negócios aberto por meio de resolve e ferramentas exatas para fluxos de trabalho de projeto, participante, rótulo, delegação, diretório e histórico de resolução.

Roster autentica solicitações MCP remotas antes de ler o corpo JSON-RPC. Os corpos das solicitações são limitados a 1 MiB; solicitações maiores retornam HTTP 413.

Use MCP Para

• perguntas de roteamento em linguagem natural
• gerenciamento de projetos e participantes nativo para agentes
• verificações exatas de associação
• gerenciamento de delegações
• histórico de solicitações de resolução

Configuração do Cliente

Use os guias de configuração dedicados para detalhes de conexão específicos do cliente:

• Claude
• Codex
• ChatGPT

Roteamento de Ferramentas

Use resolve para perguntas de negócios abertas, como quem deve lidar com uma tarefa, com quem entrar em contato, quem é responsável ou quem pode agir por meio de uma delegação ativa.

Use ferramentas exatas para verificações exatas de dados. Por exemplo, para verificar se um usuário ou grupo pertence a um projeto, liste projetos, liste participantes e depois liste os membros do participante.

Runtime de Resolução

A ferramenta resolve aceita um query em linguagem natural. Referências a projetos, rótulos, papéis de participantes e outras restrições são extraídas pelo resolvedor. O runtime então seleciona participantes correspondentes e resolve usuários associados, incluindo usuários diretamente associados, membros ativos de grupos associados e delegações ativas.

Quando uma consulta inclui um limite, como valor, região, nível ou escopo, e os participantes candidatos expõem limites correspondentes, Resolve deve escolher o participante mais restrito que atenda ao limite. Não deve adicionar participantes seniores, de backup ou de escalonamento, a menos que o limite exceda o limite inferior ou o usuário peça explicitamente escalonamento.

Quando uma consulta pede múltiplas responsabilidades, Resolve trata cada responsabilidade separadamente e seleciona participantes somente quando os dados do roster fornecidos mostram que eles lidam com essa responsabilidade.

O status da resposta MCP de nível superior é um dos:

• ok
• configuration_error
• agent_error
• server_error

Quando status é ok, result.resolution_status é um dos:

• success
• out_of_scope
• not_found