Ferramentas e exemplos
O que você pode acessar
Depois do OAuth, o cliente pode consultar, conforme os acessos aprovados:
- contexto da conta e da organização conectada;
- lista de projetos autorizados, com filtros por tipo e status;
- detalhes de um projeto autorizado;
- métricas atuais do projeto, quando disponíveis;
- builds, deploys e logs autorizados do projeto;
- saúde, instâncias, rede e auto-scaling das aplicações;
- status dos projetos Valkey;
- Armazém da organização, seus buckets e as pastas e arquivos de cada bucket, sem conteúdo dos arquivos nem chaves de acesso;
- informações dos modelos e chaves de IA autorizados, sem credenciais;
- consumo de IA em um período móvel;
- informações de medição e cobrança dos projetos;
- transações da organização quando o acesso financeiro for autorizado separadamente;
- resumos prontos em uma única consulta: o último build com falha, a busca de um texto nos logs, os incidentes de uma janela recente e a visão geral dos projetos da organização.
O servidor MCP publica nomes de tools concisos:
| Tool | Finalidade |
|---|---|
get_context | Consultar o contexto da conta e organização conectadas. |
list_projects | Listar projetos autorizados. |
get_project | Consultar um projeto autorizado. |
get_project_metrics | Consultar métricas atuais de um projeto. |
list_builds | Listar informações de builds do projeto. |
get_project_logs | Consultar logs recentes e limitados de uma aplicação. |
get_build_logs | Consultar logs paginados de um build. |
list_deployments | Listar deploys registrados no mês atual. |
get_project_health | Consultar a configuração e disponibilidade do health check. |
list_healthcheck_failures | Listar falhas recentes de health check. |
get_project_network | Consultar resumos, rotas, respostas e eventos de rede. |
get_project_autoscaling | Consultar a configuração atual de auto-scaling. |
list_autoscaling_events | Listar eventos recentes de aumento ou redução de capacidade. |
list_project_instances | Listar os identificadores públicos das instâncias. |
get_valkey_status | Consultar o status e a configuração pública de um projeto Valkey. |
get_object_storage | Consultar se a organização pode usar o Armazém e, quando ele foi selecionado na conexão, seu nome, status, região e endereço. Nunca retorna chaves de acesso. |
list_object_storage_buckets | Listar os buckets do Armazém autorizado, com tamanho, quantidade de arquivos e datas. |
list_object_storage_objects | Listar um nível de pasta de um bucket: subpastas e arquivos com tamanho e data de envio. Nunca retorna o conteúdo dos arquivos nem links de download. |
list_ai_keys | Listar informações de chaves de IA autorizadas, sem credenciais. |
get_ai_usage | Consultar o consumo observado de IA. |
get_project_billing | Consultar medições ou lançamentos de um projeto. |
list_transactions | Listar transações autorizadas da organização. |
get_latest_build_failure | Encontrar o último build com falha de uma aplicação e mostrar o final do log. |
search_project_logs | Procurar um texto nos logs recentes de uma aplicação. |
get_project_incidents | Resumir respostas 5xx, rotas com erro, falhas de health check e eventos de auto-scaling de uma janela recente. |
get_organization_overview | Resumir os projetos autorizados por status e tipo e destacar os que estão com falha. |
Os clientes podem exibir o namespace do servidor antes desses nomes. Com um servidor chamado zenifra, por exemplo, get_context pode aparecer como zenifra_get_context. Não adicione zenifra_ ao nome da própria tool MCP.
Os dados financeiros exigem consentimento próprio durante a autorização. A ausência de acesso financeiro não impede as consultas de projetos e métricas permitidas.
Exemplos de prompts
Depois de verificar a conexão, experimente consultas como:
Qual organização está conectada?Liste os projetos que posso consultar.Mostre as métricas atuais do projeto autorizado que eu indicar.Liste os builds recentes do projeto selecionado e mostre os logs do build que eu indicar.Verifique a saúde, as instâncias e os eventos de auto-scaling deste projeto.Mostre um resumo da rede da última hora e as falhas recentes de health check.Mostre meu consumo de IA no período disponível e as transações autorizadas.Por que o último build deste projeto falhou?Procure "timeout" nos logs recentes desta aplicação.O que deu errado nesta aplicação na última hora?Algum dos meus projetos está com falha?O cliente só deve responder com dados cobertos pelo consentimento da conexão.
Última atualização em