mttrly

Servidor MCP mttrly

Acesso MCP remoto ao mttrly, um agente de SRE com IA para saúde de servidores, diagnósticos, playbooks, aprovações e histórico de auditoria.

Escopo

O mttrly MCP é um conector remoto Streamable HTTP. Cada chamada de ferramenta chega primeiro à API Central do mttrly; a Central então conversa com os agentes conectados pelo canal seguro de agente existente. Um agente autônomo não expõe uma superfície MCP local.

A Variante A é intencionalmente remota-primeiro: catálogos públicos apontam para o endpoint hospedado, OAuth lida com a autorização do usuário, e nenhum pacote npm é necessário para a configuração normal do cliente.

Conectar

Claude.ai e Claude Desktop

Use a interface do conector:

1. Abra Configurações -> Conectores.
2. Escolha Adicionar conector personalizado.
3. Insira https://api.mttrly.com/mcp.
4. Complete o fluxo de login OAuth.

Não coloque a URL remota em claude_desktop_config.json; esse arquivo é para servidores MCP stdio locais.

Claude Code

claude mcp add --transport http mttrly https://api.mttrly.com/mcp

OpenAI Codex

Adicione isso a ~/.codex/config.toml:

[mcp_servers.mttrly]
url = "https://api.mttrly.com/mcp"

Em seguida, complete o login OAuth:

codex mcp login mttrly

Cursor

Adicione https://api.mttrly.com/mcp como uma URL de servidor MCP remoto. O Cursor deve descobrir os metadados do recurso protegido a partir do desafio do servidor e iniciar o OAuth.

Autenticação

• O transporte remoto usa OAuth 2.1 com PKCE S256 contra https://app.mttrly.com.
• A URL de metadados do recurso protegido é https://api.mttrly.com/.well-known/oauth-protected-resource/mcp.
• Clientes MCP de origem de navegador devem ser explicitamente permitidos com MCP_ALLOWED_ORIGINS.
• Requisições sem um cabeçalho Origin recebem o desafio OAuth 401 normal.
• Requisições com um cabeçalho Origin não confiável são rejeitadas com 403 por design.

Ferramentas

40 ferramentas estão disponíveis: 21 ferramentas de leitura e 19 ferramentas de execução. Sempre chame mttrly_get_capabilities primeiro para descobrir o plano atual e quaisquer restrições.

Ferramentas de leitura (21)

ID da ferramenta	Título	Plano	Descrição
mttrly_get_capabilities	Obter Capacidades do Plano	watchdog	Obter plano atual, ferramentas disponíveis, ferramentas restritas e limites do plano. Chame isso primeiro antes de usar qualquer outra ferramenta.
mttrly_list_servers	Listar Servidores	watchdog	Listar todos os servidores conectados com status online/offline, IDs de servidor, nomes, última vez visto e versão do agente. Use mttrly_get_server_status para CPU, RAM, disco e contagens de alertas ativos por servidor.
mttrly_get_server_status	Obter Status do Servidor	watchdog	Obter saúde detalhada do servidor, incluindo CPU, RAM, uso de disco e contagem de alertas ativos.
mttrly_get_alerts	Obter Alertas do Servidor	watchdog	Obter alertas de um servidor com filtragem por severidade e status. Limites de retenção baseados no plano se aplicam.
mttrly_quick_triage	Triagem Rápida do Servidor	watchdog	Obter um resumo diagnóstico somente leitura superficial a partir de dados seguros do Watchdog: status, alertas ativos e percentuais de recursos.
mttrly_run_diagnostic	Executar Diagnóstico do Servidor	deployment_bro	Executar um diagnóstico não destrutivo em um servidor. Descreva o problema e o sistema investigará. Cooldown de 30 segundos por servidor. Somente Deployment Bro+ — o Watchdog tem ferramentas de inspeção somente leitura (status, alertas, list_playbooks).
mttrly_list_playbooks	Listar Playbooks	watchdog	Listar playbooks de remediação disponíveis. Retorna id, nome, descrição, categoria, flag requires_approval e array de parâmetros opcionais. Filtre por server_id ou categoria.
mttrly_get_service_reality	Obter Realidade do Serviço	deployment_bro	Obter o snapshot mais recente da realidade do serviço em cache ou com atualização ao vivo para um servidor, incluindo descobertas, serviços, runtimes e contexto de saúde atual.
mttrly_refresh_reality	Atualizar Realidade	deployment_bro	Executar uma atualização ao vivo da realidade do serviço para um servidor e aguardar o snapshot atualizado, com uma janela de cooldown rígida por servidor.
mttrly_get_server_timeline	Obter Linha do Tempo do Servidor	deployment_bro	Obter uma linha do tempo unificada recente para um servidor que mescla incidentes, deploys e eventos de auditoria em um único fluxo ordenado.
mttrly_run_deploy_verifier	Executar Verificador de Deploy	deployment_bro	Executar o verificador de deploy genérico para um servidor. Retorna resultado do healthcheck, contexto de incidente ativo e status do último deploy.
mttrly_read_file	Ler Arquivo	deployment_bro	Ler logs permitidos, logs do Docker, imagens do Docker ou arquivos de ambiente gerenciados de um servidor com redação compartilhada.
mttrly_read_privileged_file	Ler Arquivo Privilegiado	deployment_bro	Ler um arquivo privilegiado de lista de permissões estendida, como overrides do sudoers ou authorized_keys de root, com redação compartilhada.
mttrly_search_files	Pesquisar Arquivos	deployment_bro	Pesquisar arquivos permitidos em um servidor por uma string de consulta literal, com filtragem opcional por glob e redação compartilhada.
mttrly_diff_file	Diferenciar Arquivos	deployment_bro	Diferenciar dois arquivos permitidos em um servidor e retornar um diff unificado com redação compartilhada.
mttrly_compare_source_to_dist	Comparar Fonte com Dist	deployment_bro	Comparar uma árvore de origem com a saída dist em um servidor através da capacidade canônica de comparação somente leitura.
mttrly_get_install_health	Obter Saúde da Instalação	deployment_bro	Ler o estado de saúde de propriedade do instalador, drift e planejamento de reparo para um servidor através do caminho canônico do backend de recuperação.
mttrly_search_knowledge	Pesquisar Conhecimento	deployment_bro	Pesquisar postmortems, receitas e notas salvas usando pesquisa de texto completo. Opcionalmente, filtre para um servidor.
mttrly_get_morning_brief	Obter Resumo Matinal	deployment_bro	Obter o resumo proativo atual para o usuário, incluindo anomalias recém-detectadas e artefatos de conhecimento recentes.
mttrly_get_investigation_bypass	Obter Bypass de Investigação	deployment_bro	Ler o estado atual de bypass de uma investigação. Use entre chamadas de execução para verificar se o bypass ainda está ativo sem consumir um slot de ação.
mttrly_acknowledge_proactive_event	Reconhecer Evento Proativo	deployment_bro	Marcar um evento proativo como aceito ou como falso positivo em nome do usuário. Alimenta o orçamento de falsos positivos que silencia detectores ruidosos.

Ferramentas de execução (19)

ID da ferramenta	Título	Plano	Descrição
mttrly_run_playbook	Executar Playbook	deployment_bro	Executar um playbook em um servidor. Playbooks somente leitura são executados imediatamente; playbooks que exigem aprovação retornam pending_approval.
mttrly_execute_command	Executar Comando Shell	deployment_bro	Solicitar a execução de um comando shell arbitrário em um servidor. Comandos somente leitura e bypasses de investigação ativos podem ser executados imediatamente; caso contrário, retorna pending_approval.
mttrly_get_pending_actions	Obter Ações Pendentes	deployment_bro	Listar ações aguardando aprovação, criadas por mttrly_run_playbook ou mttrly_execute_command. Retorna action_id, servidor, tipo, descrição e expiração. As ações expiram após 30 minutos. Use mttrly_approve_action para aprovar ou mttrly_cancel_action para rejeitar.
mttrly_get_action_result	Obter Resultado da Ação	deployment_bro	Recuperar o resultado atual ou terminal de uma ação criada por mttrly_run_playbook ou mttrly_execute_command.
mttrly_approve_action	Aprovar ou Rejeitar Ação	deployment_bro	Aprovar ou rejeitar uma ação pendente. Chame somente após confirmação explícita do usuário; bloqueia até que a execução seja concluída.
mttrly_cancel_action	Cancelar Ação	deployment_bro	Cancelar uma ação pendente rejeitando-a. Chame somente após confirmação explícita do usuário.
mttrly_get_audit_log	Obter Log de Auditoria	deployment_bro	Obter a trilha de auditoria cronológica de um servidor. Inclui execuções de comandos, execuções de playbooks, disparos de alertas e correções do agente com atribuição de origem (mcp/telegram/dashboard/api) e resultado.
mttrly_write_file	Escrever Arquivo	deployment_bro	Escrever conteúdo codificado em base64 em um arquivo de servidor gerenciado. Sempre retorna uma ação de aprovação pendente.
mttrly_cleanup_file	Limpar Arquivo	deployment_bro	Excluir um arquivo de servidor gerenciado permitido. Sempre retorna uma ação de aprovação pendente.
mttrly_execute_script	Executar Script	deployment_bro	Executar um script gerenciado permitido ou um script batch inline em um servidor através da capacidade canônica de script. Bypasses de investigação ativos podem ser executados imediatamente; caso contrário, retorna pending_approval.
mttrly_bootstrap_recover	Bootstrap de Recuperação	deployment_bro	Gerar o one-liner canônico de recuperação de bootstrap para um servidor e token de instalação.
mttrly_repair_install	Reparar Instalação	deployment_bro	Executar estratégias canônicas de recuperação de instalação, como reparo orientado por problema, convergência completa do estado de instalação, reprovisionamento de wrapper ou desinstalação do agente. Sempre retorna uma ação de aprovação pendente.
mttrly_regenerate_install_token	Regenerar Token de Instalação	watchdog	Gerar um novo comando de reinstalação para um servidor offline existente. Exige aprovação, rotaciona credenciais do agente, preserva o histórico do servidor e não limpa o host.
mttrly_decommission_server	Excluir Servidor Offline	watchdog	Remover um servidor offline/morto do registro Central apenas. Exige aprovação e não limpa arquivos, usuários ou systemd no host.
mttrly_update_agent	Atualizar Agente	deployment_bro	Atualizar o agente mttrly em um servidor através da capacidade canônica de atualização do núcleo. Sempre retorna uma ação de aprovação pendente.
mttrly_start_investigation	Iniciar Investigação	deployment_bro	Iniciar ou retomar uma investigação de servidor vinculada à sessão MCP atual. Exige uma sessão MCP de curta duração.
mttrly_generate_retrospective	Gerar Retrospectiva	deployment_bro	Gerar uma retrospectiva determinística a partir da linha do tempo atual do servidor, estado do verificador e conhecimento armazenado. Persiste uma entrada de postmortem.
mttrly_acquire_investigation_bypass	Adquirir Bypass de Investigação	deployment_bro	Adquirir um bypass de aprovação em toda a sessão em uma investigação aberta. Exige 2FA. Chamadas subsequentes de execute_command/execute_script no servidor de investigação pulam a aprovação por comando até a expiração, máximo de ações ou revogação.
mttrly_revoke_investigation_bypass	Revogar Bypass de Investigação	deployment_bro	Revogar imediatamente um bypass de investigação ativo. Chamadas subsequentes de execução retornam à aprovação por comando. Idempotente: revogar um bypass já revogado retorna o estado atual em vez de erro.

Erros

Código	Descrição	Ação sugerida
ACTION_EXPIRED	A ação pendente excedeu o TTL de 30 minutos e foi cancelada automaticamente.	Execute novamente o comando ou playbook original para criar uma nova ação pendente.
ACTION_NOT_FOUND	A ação pendente não foi encontrada.	Liste as ações pendentes novamente e use um action_id novo.
AUTH_FAILED	A autenticação falhou ou as credenciais fornecidas são inválidas.	Atualize a autenticação e tente novamente com uma chave de API ou token OAuth válido.
CONNECTION_ERROR	O servidor MCP não conseguiu alcançar a API de backend.	Tente novamente a solicitação após a conectividade ser restaurada.
CONTRACT_VERSION_UNSUPPORTED	O cliente solicitou uma versão principal de contrato MCP não suportada.	Atualize o cliente MCP ou use uma versão principal de contrato atualmente suportada.
DIAGNOSTIC_COOLDOWN	O período de espera de diagnóstico por servidor ainda não expirou.	Aguarde o período de espera expirar antes de tentar novamente.
DOCKER_NOT_AVAILABLE	O Docker não está instalado no servidor de destino, portanto os playbooks do Docker não estão disponíveis.	Pule os playbooks do Docker ou instale o Docker no servidor primeiro.
FORBIDDEN	O recurso MCP solicitado pertence a um contexto de usuário ou plano diferente.	Busque novamente os IDs mais recentes de servidor, playbook ou ação para a conta atual.
INTERNAL_ERROR	O backend encontrou um erro interno inesperado.	Tente novamente uma vez. Se continuar falhando, inspecione os logs do backend ou entre em contato com o suporte.
NOT_FOUND	O recurso MCP solicitado não foi encontrado.	Atualize o endpoint de lista relevante e tente novamente com um identificador válido.
PLAN_REQUIRED	A ferramenta solicitada requer um plano de assinatura superior.	Informe o usuário sobre a limitação do plano e mostre a URL de upgrade.
POLICY_DENIED	A solicitação foi rejeitada por uma política de segurança conhecida do lado Central antes da execução.	Escolha um caminho ou operação de destino permitido e tente novamente.
PLAYBOOK_NOT_AVAILABLE	O playbook selecionado não está disponível atualmente no servidor de destino.	Atualize a lista de playbooks para esse servidor e escolha um dos playbooks anunciados.
PLAYBOOK_NOT_FOUND	O ID do playbook especificado não existe.	Chame mttrly_list_playbooks e escolha um playbook_id válido.
RATE_LIMITED	A solicitação excedeu a janela atual de limite de taxa do MCP.	Aguarde a janela de limite de taxa ser redefinida e tente novamente.
SERVER_NOT_FOUND	O ID do servidor especificado não existe ou não pertence ao usuário atual.	Chame mttrly_list_servers para ver os IDs de servidor disponíveis.
SERVER_OFFLINE	O agente do servidor de destino não está conectado no momento.	Verifique se o agente mttrly está em execução no servidor.
SERVER_ONLINE	O servidor de destino está online, portanto a exclusão apenas do registro é bloqueada.	Use Delete para desinstalar o agente primeiro, ou aguarde até o servidor ficar offline antes de excluir o registro.
TIMEOUT	A solicitação excedeu o tempo limite configurado.	Tente novamente a solicitação, ou reduza o escopo se a operação for cara.
UNKNOWN_ERROR	Ocorreu um erro desconhecido no servidor MCP.	Tente novamente a solicitação e inspecione os detalhes brutos do erro se persistir.
VALIDATION_ERROR	A solicitação falhou na validação de esquema ou parâmetros.	Verifique os parâmetros da solicitação em relação ao esquema da ferramenta anunciado.
APPROVAL_NOTIFICATION_FAILED	Uma ação pendente foi criada, mas o prompt de aprovação não pôde ser entregue ao usuário; a ação foi encerrada com falha.	Inspecione o action_id nos detalhes do erro para confirmar que a ação não está mais pendente e, em seguida, tente novamente a solicitação original para criar uma nova ação.
INVESTIGATION_CLOSED	A investigação já está encerrada e não pode adquirir um bypass.	Abra uma nova investigação com mttrly_start_investigation antes de solicitar o bypass.
BYPASS_ALREADY_ACTIVE	Esta investigação já possui um bypass ativo e não revogado.	Use o bypass atual; ou chame mttrly_revoke_investigation_bypass e re-adquira se precisar de limites diferentes.
BYPASS_ACQUIRE_FAILED	Não foi possível adquirir o bypass da investigação — o estado da investigação mudou entre a verificação e a atualização.	Releia o status da investigação e tente novamente; se a investigação foi encerrada, inicie uma nova.

Planos

Limites

Plano	Servidores	Linhas de log	Retenção de log (dias)	Verificações agendadas
watchdog	1	50	7	0
deployment_bro	3	500	30	5
deployment_crew	9	500	30	Ilimitadas

Matriz de acesso

Ferramenta	Watchdog	Deployment Bro	Deployment Crew
mttrly_get_capabilities	✓	✓	✓
mttrly_list_servers	✓	✓	✓
mttrly_get_server_status	✓	✓	✓
mttrly_get_alerts	✓	✓	✓
mttrly_quick_triage	✓	✓	✓
mttrly_run_diagnostic	—	✓	✓
mttrly_list_playbooks	✓	✓	✓
mttrly_run_playbook	—	✓	✓
mttrly_execute_command	—	✓	✓
mttrly_get_pending_actions	—	✓	✓
mttrly_get_action_result	—	✓	✓
mttrly_approve_action	—	✓	✓
mttrly_cancel_action	—	✓	✓
mttrly_get_audit_log	—	✓	✓
mttrly_get_service_reality	—	✓	✓
mttrly_refresh_reality	—	✓	✓
mttrly_get_server_timeline	—	✓	✓
mttrly_run_deploy_verifier	—	✓	✓
mttrly_read_file	—	✓	✓
mttrly_read_privileged_file	—	✓	✓
mttrly_search_files	—	✓	✓
mttrly_diff_file	—	✓	✓
mttrly_compare_source_to_dist	—	✓	✓
mttrly_get_install_health	—	✓	✓
mttrly_write_file	—	✓	✓
mttrly_cleanup_file	—	✓	✓
mttrly_execute_script	—	✓	✓
mttrly_bootstrap_recover	—	✓	✓
mttrly_repair_install	—	✓	✓
mttrly_regenerate_install_token	✓	✓	✓
mttrly_decommission_server	✓	✓	✓
mttrly_update_agent	—	✓	✓
mttrly_start_investigation	—	✓	✓
mttrly_generate_retrospective	—	✓	✓
mttrly_search_knowledge	—	✓	✓
mttrly_get_morning_brief	—	✓	✓
mttrly_get_investigation_bypass	—	✓	✓
mttrly_acquire_investigation_bypass	—	✓	✓
mttrly_revoke_investigation_bypass	—	✓	✓
mttrly_acknowledge_proactive_event	—	✓	✓

Suporte

• E-mail de suporte: mttrly@mttrly.com
• Problemas: github.com/mttrly-hq/mttrly-mcp/issues
• Página de marketing: mttrly.com/mcp
• Documentação: mttrly.com/docs#mcp