para conectores personalizados do Grok
Conecte o Grok ao seu monitoramento de uptime
O conector personalizado do Grok não se registra sozinho como fazem o Claude, o Cursor e o VS Code. O formulário dele pede um ID do cliente, duas URLs de endpoint e uma lista de escopos. Cole os valores abaixo, salve, entre com seu login do Uptimepage, aprove a tela de consentimento e o Grok poderá ler seus monitores, incidentes e páginas de status no chat.
Preencha o formulário do conector
No grok.com, abra “Connectors”, depois “New Connector”, depois “Custom”. Informe a URL do servidor MCP e, na seção OAuth, cole o ID do cliente, o endpoint de autorização e o endpoint de token da tabela acima. Em “Token auth method”, escolha "none", com PKCE. Nos escopos, targets:read status_page:read incidents:read maintenance:read basta para responder a qualquer pergunta; adicione channels:read para o inventário de canais de notificação e variables:read para as chaves das variáveis. Conceda um escopo de escrita só depois de ver o Grok mostrar um pedido de confirmação, já que um cliente que não consegue mostrá-lo executa as escritas com o escopo concedido sem perguntar a ninguém: incidents:write para reconhecer, resolver ou publicar, status_page:write para montar uma página, maintenance:write para agendar manutenções e targets:write junto com targets:execute para criar um monitor, porque criar um monitor roda a verificação primeiro. A tela de consentimento mostra exatamente o que está sendo concedido. Salve, e o Grok leva você para entrar.
Por que um ID do cliente publicado é seguro
O ID pertence a um cliente público sem segredo, então não concede nada sozinho. O único redirecionamento registrado para ele é grok.com, o que significa que um código de autorização não pode ir para nenhum outro lugar. O PKCE permite que só a sessão do Grok que iniciou o fluxo resgate o código. E a tela de consentimento continua sendo sua: ela mostra o nome da sua organização, lista as capacidades, diz que você vai voltar para grok.com e não emite nada até você clicar em “Approve”. Só aprove uma conexão que você mesmo iniciou.
O que o Grok pode fazer
Pergunte o que está fora do ar e o Grok chama get_org_health, depois get_monitor_history para o monitor que importa, com o tempo de resposta dividido em DNS, conexão, TLS e primeiro byte. Pergunte sobre um incidente e ele lê a linha do tempo e as atualizações dos operadores. Peça os números do mês e get_incident_metrics retorna o MTTA, o MTTR e os monitores mais barulhentos. As 39 ferramentas aparecem na lista, mas os escopos acima são de leitura, então as que funcionam são as 19 ferramentas de leitura, que é onde está a maior parte do valor de qualquer forma; as 20 que agem se recusam a rodar até que um escopo de escrita seja concedido na tela de consentimento. Com um escopo concedido, cada uma pergunta a você primeiro quando o Grok consegue mostrar a confirmação e, quando não consegue, roda com o escopo concedido e fica marcada como não confirmada na trilha de auditoria.
Três prompts para começar
“O que está quebrado agora, e há quanto tempo?” “Compare os incidentes desta semana com os da semana passada e me diga qual monitor causou mais.” “O fluxo de checkout está mais lento do que há um mês, e em qual passo?” O último consulta get_flow_step_trend, que informa, por passo, como a duração média mudou e quantas execuções passaram ou falharam nele, então um login que ainda passa, mas demora o dobro, aparece antes de falhar.
Grok Build e outros clientes que aceitam um cabeçalho
Um cliente que envia um cabeçalho Authorization fixo em vez de rodar o OAuth, como o Grok Build, funciona com um token de API com escopo restrito: gere no app, em “Settings”, depois “API tokens”, um token vinculado à organização, somente leitura e com prazo de validade, e defina o cabeçalho como Bearer seguido do token. Quem hospeda por conta própria registra o próprio cliente uma vez com o comando abaixo e cola o client_id retornado no mesmo formulário, com os próprios hosts nos dois endpoints. Aprove-o uma vez logo em seguida: um cliente que ninguém aprovou na semana seguinte ao registro é removido.
Auto-hospedado: registre seu próprio cliente do Grok
curl -X POST https://app.example.com/oauth/register \
-H 'Content-Type: application/json' \
-d '{"client_name":"Grok","redirect_uris":["https://grok.com/connectors-oauth-exchange-code/"]}'Perguntas frequentes
Por que o Grok pede um ID do cliente?
É seguro o ID do cliente ser público?
Quais escopos devo colar?
Posso usar com o Grok Build?
Visão geral
- URL do servidor MCP https://mcp.uptimepage.dev/mcp
- ID do cliente ump_DWhz9cACC1T6Tr-5oEw2qw
- Endpoint de autorização https://app.uptimepage.dev/oauth/authorize
- Endpoint de token https://app.uptimepage.dev/oauth/token
- Método de autenticação do token none (PKCE)
- Escopos targets:read status_page:read incidents:read maintenance:read
- Callback registrado só grok.com
- Preço para começar grátis, sem cartão