UptimeObserver

Monitoramento de Uptime

Ver em uptimeobserver.comExperimente este MCPPatrocinado

Documentação

MCP

Visão Geral

As chaves de API MCP (Model Context Protocol) permitem que você acesse programaticamente os dados de monitoramento do UptimeObserver por meio da nossa API. Use essas chaves para integrar o UptimeObserver a assistentes de IA, ferramentas de automação e aplicativos personalizados.

Como Funcionam as Chaves de API MCP

As chaves de API MCP fornecem acesso autenticado ao endpoint da API do UptimeObserver. Cada chave:

  • É prefixada com uo_ para fácil identificação
  • É exibida apenas uma vez no momento da criação — armazene-a com segurança
  • Pode ser rotacionada para gerar uma nova chave sem tempo de inatividade
  • Pode ser revogada para desativar o acesso imediatamente

Autenticação

As chaves de API MCP podem ser enviadas em dois formatos:

Autenticação por Cabeçalho

X-API-Key: uo_yourkeyhere

Autenticação por Token Bearer

Authorization: Bearer uo_yourkeyhere

[!warning] JWT Não Aceito O endpoint /api/mcp aceita apenas chaves de API MCP. Tokens JWT padrão não são válidos para acesso MCP.

Criando uma Chave de API MCP

  1. Acesse UptimeObserver e faça login na sua conta.
  2. Navegue até a seção Integrações no seu painel.
  3. Escolha MCP na lista de integrações disponíveis.
  4. Clique em Criar Chave.

[!warning] Exibição Única A chave gerada é exibida apenas uma vez em uma janela modal. Copie e armazene-a com segurança antes de fechar a janela. Se você perder a chave, será necessário rotacioná-la para obter uma nova.

  1. Copie a chave e armazene-a em um local seguro (gerenciador de senhas, variáveis de ambiente ou gerenciador de segredos).

Usando o Endpoint MCP

Endpoint

POST https://mcp.uptimeobserver.com/mcp

Exemplo de Requisição

curl -X POST https://mcp.uptimeobserver.com/mcp \
  -H "X-API-Key: uo_yourkeyhere" \
  -H "Content-Type: application/json"

Ou usando autenticação Bearer:

curl -X POST https://mcp.uptimeobserver.com/mcp \
  -H "Authorization: Bearer uo_yourkeyhere" \
  -H "Content-Type: application/json"

Gerenciando Chaves de API

Rotacionando uma Chave

A rotação gera uma nova chave mantendo a antiga ativa até que a nova seja confirmada. Use a rotação para atualizações rotineiras de chaves sem interrupção do serviço:

  1. Navegue até Integrações → MCP no seu painel.
  2. Clique em Rotacionar ao lado da chave que deseja substituir.
  3. Uma nova chave é gerada. Copie e armazene-a com segurança.
  4. Atualize seus aplicativos para usar a nova chave.
  5. A chave antiga permanece válida até que você a revogue explicitamente.

Revogando uma Chave

A revogação desativa imediatamente uma chave de API. Todos os aplicativos que usam essa chave perderão o acesso:

  1. Navegue até Integrações → MCP no seu painel.
  2. Clique em Revogar ao lado da chave que deseja desativar.
  3. Confirme a revogação na janela de diálogo.

[!danger] Irreversível Chaves revogadas não podem ser recuperadas. Você precisará criar uma nova chave se quiser restaurar o acesso.

Boas Práticas de Segurança

  • Armazene chaves com segurança — Use um gerenciador de senhas, variáveis de ambiente ou um gerenciador de segredos. Nunca envie chaves para o controle de versão
  • Rotacione regularmente — Rotacione as chaves periodicamente como parte da sua higiene de segurança
  • Revogue imediatamente chaves comprometidas — Se uma chave for exposta, revogue-a e crie uma nova
  • Use chaves separadas por aplicativo — Crie chaves distintas para diferentes ferramentas ou ambientes
  • Aplique o princípio do menor privilégio — Compartilhe chaves apenas com aplicativos que precisam delas

Casos de Uso

  • Integração com Assistentes de IA — Conecte dados de monitoramento a ferramentas de observabilidade com tecnologia de IA por meio do protocolo MCP
  • Painéis Personalizados — Crie painéis de status internos que puxam dados de monitoramento em tempo real
  • Fluxos de Automação — Dispare respostas automatizadas com base em mudanças de status do monitor
  • Integração CI/CD — Verifique a saúde do serviço como parte do seu pipeline de implantação

Solução de Problemas

401 Não Autorizado

  • Verifique se a chave de API está correta e não foi revogada
  • Certifique-se de estar usando o cabeçalho X-API-Key ou o cabeçalho Authorization: Bearer (não ambos)
  • Verifique se o prefixo da chave uo_ está incluído
  • Tokens JWT não são aceitos no endpoint MCP

403 Proibido

  • A chave de API pode ter sido revogada. Verifique o status da chave no painel MCP
  • Sua conta pode não ter permissão para acessar o endpoint MCP

Chave Perdida ou Esquecida

  • As chaves MCP são exibidas apenas uma vez no momento da criação
  • Se você perder uma chave, rotacione-a para gerar uma nova e atualize seus aplicativos

[!info] Precisa de Ajuda? Se você precisar de assistência com chaves de API MCP, entre em contato usando o botão "Precisa de Ajuda?" no canto inferior direito ou envie um e-mail para support@uptimeobserver.com.