GreatWait

Callbacks HTTPS confiáveis, únicos e recorrentes, para aplicativos e agentes.

Ver em greatwait.devExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://api.greatwait.dev/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

GreatWait é um servidor MCP remoto. A maioria dos clientes só precisa do endereço dele.

O quê	Onde
Endereço do servidor	`https://api.greatwait.dev/mcp`
Descoberta	`https://api.greatwait.dev/.well-known/oauth-protected-resource/mcp`

Ao aprovar a conexão, escolha o projeto em que ela trabalha. Para trabalhar em outro projeto, conecte-se novamente.

Seu primeiro callback

Agentes de codificação como Claude Code, Codex e Cursor podem criar a URL do webhook.site por conta própria. Em um cliente somente de chat, cole uma URL do webhook.site.

O agente agenda a chamada diretamente com essa URL. Ele nunca vê o segredo de assinatura. Isso permanece na página do endpoint no painel.

Isto é o que um cliente conectado faz:

#	Ferramenta ou recurso	Para que serve
1	ferramenta `schedules_create`	Criar um agendamento
2	ferramenta `schedules_read`	Ler um agendamento
3	ferramenta `occurrences_list`	Listar ocorrências retidas
4	ferramenta `occurrences_read`	Ler uma ocorrência
5	ferramenta `attempts_list`	Listar tentativas de entrega
6	ferramenta `attempts_read`	Ler uma tentativa de entrega
7	ferramenta `schedules_cancel`	Cancelar um agendamento

O cancelamento vem por último e só interrompe um agendamento que ainda não disparou. Depois que um agendamento de uso único foi entregue, não há nada para cancelar, e a chamada responde state_conflict.

Seu cliente pede acesso total, incluindo cobrança e chaves de API. Se isso for mais do que você deseja, conecte-se com uma chave de API que tenha apenas os escopos que você escolher.

Claude Code

O agente de codificação da Anthropic, no terminal e no editor. Ele fala a revisão mais recente do protocolo, então é o mais rigoroso dos três sobre o que o servidor envia.

Adicione o servidor ao Claude Code. Um comando, um endereço. O Claude Code lê o documento de descoberta por conta própria e marca o servidor como precisando de autenticação. Adicione --scope user para disponibilizá-lo em todos os projetos em vez de apenas neste.

claude mcp add --transport http greatwait https://api.greatwait.dev/mcp

Autorize-o. O Claude Code se registra e abre a tela de consentimento do GreatWait no seu navegador. Escolha o projeto e aprove. Dentro de uma sessão do Claude Code, o mesmo passo é /mcp, depois o servidor e, em seguida, Authenticate.

claude mcp login greatwait

Verifique se está conectado. Conectado significa autorizado e que a lista de ferramentas foi lida. Dentro de uma sessão, /mcp lista as próprias ferramentas. Uma conexão autorizada com menos escopos lista menos ferramentas, que é a maneira mais rápida de distinguir um problema de escopo de um problema de conexão.

claude mcp get greatwait

Autenticar com uma chave de API

O Claude Code salva a chave em texto simples em ~/.claude.json, onde qualquer coisa executada por você pode lê-la.

Crie uma chave. No painel de chaves de API, selecione New key e marque endpoints:write, occurrences:read, schedules:read, schedules:write. A chave é mostrada uma única vez.
Adicione o servidor com a chave. Substitua o espaço reservado pela sua chave. Se o greatwait já estiver adicionado, remova-o primeiro com claude mcp remove greatwait.

claude mcp add --transport http greatwait https://api.greatwait.dev/mcp --header "Authorization: Bearer <the key, shown once at creation>"

Codex

O agente de codificação da OpenAI, no terminal. Seu cliente MCP é uma implementação própria e ele retém cada alteração para sua aprovação antes de executá-la.

Adicione o servidor ao Codex. Um comando, um endereço. O Codex grava o servidor em ~/.codex/config.toml, vê que ele precisa de autorização e segue direto para o login abaixo.

codex mcp add greatwait --url https://api.greatwait.dev/mcp

Autorize-o. O Codex se registra e abre a tela de consentimento do GreatWait no seu navegador. Escolha o projeto e aprove. Execute isso somente se o login da etapa de adição foi fechado antes de terminar.

codex mcp login greatwait

Verifique se está autorizado. A linha do greatwait mostra OAuth depois que a aprovação foi registrada. Dentro de uma sessão do Codex, /mcp lista as ferramentas. O Codex pede que você aprove cada chamada de ferramenta que altera algo, como criar um agendamento; leituras são executadas sem perguntar.

codex mcp list

Autenticar com uma chave de API

O Codex lê a chave de uma variável de ambiente, então ela fica em texto simples onde quer que você a defina, como no seu perfil de shell.

Crie uma chave. No painel de chaves de API, selecione New key e marque endpoints:write, occurrences:read, schedules:read, schedules:write. A chave é mostrada uma única vez.
Coloque a chave em uma variável de ambiente. Substitua o espaço reservado pela sua chave. Adicione a linha ao seu perfil de shell para que todo terminal do qual o Codex iniciar tenha a variável.

export GREATWAIT_API_KEY="<the key, shown once at creation>"

Adicione o servidor com a chave. O Codex grava o servidor em ~/.codex/config.toml com o nome da variável, não a chave. Se o greatwait já estiver adicionado, remova-o primeiro com codex mcp remove greatwait.

codex mcp add greatwait --url https://api.greatwait.dev/mcp --bearer-token-env-var GREATWAIT_API_KEY

Cursor

O editor de código com IA. Seu cliente MCP é uma implementação própria, em vez do SDK de referência, e foi o primeiro cliente comprovado em produção.

Adicione o servidor à configuração MCP do Cursor. Uma entrada, um endereço. O Cursor lê o documento de descoberta por conta própria e descobre que o servidor precisa de autorização.

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "greatwait": {
      "url": "https://api.greatwait.dev/mcp"
    }
  }
}

Autorize-o. O Cursor se registra e abre a tela de consentimento do GreatWait no seu navegador. Aprove lá. Dentro do editor, o mesmo passo é o prompt de login ao lado do servidor nas configurações.

cursor-agent mcp login greatwait

Verifique o que ele pode fazer. As ferramentas que sua conexão tem permissão de ver. Uma conexão autorizada com menos escopos lista menos ferramentas, que é a maneira mais rápida de distinguir um problema de escopo de um problema de conexão.

cursor-agent mcp list-tools greatwait

Autenticar com uma chave de API

O Cursor salva a chave em texto simples em ~/.cursor/mcp.json, onde qualquer coisa executada por você pode lê-la.

Crie uma chave. No painel de chaves de API, selecione New key e marque endpoints:write, occurrences:read, schedules:read, schedules:write. A chave é mostrada uma única vez.
Adicione a chave à configuração MCP do Cursor. Substitua o espaço reservado pela sua chave. Ela não é mostrada novamente em lugar nenhum.

Em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "greatwait": {
      "headers": {
        "Authorization": "Bearer <the key, shown once at creation>"
      },
      "url": "https://api.greatwait.dev/mcp"
    }
  }
}

Desativando uma conexão

Abra Settings → Access.

Um cliente com o qual você fez login via OAuth está em Connected applications. Selecione Withdraw access e depois Withdraw it. A próxima chamada de ferramenta dele é recusada.
Uma chave está em API keys. Selecione Revoke e depois Revoke it. Isso não pode ser desfeito. Para reconectar, crie uma nova chave com New key e atualize as configurações do cliente.

Solução de problemas

O que você vê	O que fazer
A tela de consentimento recusa antes de mostrar qualquer escopo, nomeando o redirecionamento.	Feche qualquer aba de login anterior e entre novamente: `claude mcp login greatwait` no Claude Code, `codex mcp login greatwait` no Codex ou `cursor-agent mcp login greatwait` no Cursor. Um login anterior pela metade é a causa usual.
Você aprovou no navegador, mas o cliente ainda diz que o servidor precisa de autenticação.	Entre novamente com o mesmo comando. Um código de login funciona uma vez e expira rapidamente.
O cliente diz que o servidor precisa de autenticação ou não lista nenhuma ferramenta.	A conexão não está autenticada. Com OAuth, execute o comando de login do seu cliente novamente. Com uma chave, verifique se você copiou tudo. Ela é mostrada uma única vez, e parte de uma chave falha da mesma forma que uma chave errada.
Chamadas que funcionavam há pouco agora falham todas as vezes.	Alguém revogou a chave, e isso não pode ser desfeito. Crie uma nova chave no painel de chaves de API e coloque-a nas configurações do cliente.
Chamadas falham todas as vezes, a partir de um prazo sobre o qual você foi avisado.	A chave foi rotacionada e a antiga parou de funcionar. Use a nova chave que foi mostrada quando você rotacionou. Se não a guardou, rotacione novamente.
Algumas ferramentas funcionam, e uma falha nomeando o escopo de que precisa.	A conexão não tem esse escopo. Com OAuth, entre novamente e aprove. Com uma chave, crie uma nova chave que tenha o escopo. Os escopos de uma chave não podem ser alterados.
Uma chamada de ferramenta nomeia um agendamento ou endpoint que a conexão não pode ver.	Cada conexão trabalha em um projeto, então um ID copiado de outro projeto não está lá. Peça ao cliente para listar o que ele pode ver e use um ID dessa lista.
Uma chamada de ferramenta é recusada por um argumento que o cliente achava opcional.	Um argumento que nomeia outro projeto é recusado, não ignorado. Remova-o. A conexão já sabe o projeto dela.

Configurações de cookies