GreatWait

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

GreatWait es un servidor MCP remoto. La mayoría de los clientes solo necesitan su dirección.

Qué	Dónde
Dirección del servidor	https://api.greatwait.dev/mcp
Descubrimiento	https://api.greatwait.dev/.well-known/oauth-protected-resource/mcp

Cuando apruebes la conexión, elige el proyecto en el que trabaja. Para trabajar en otro proyecto, conéctate de nuevo.

Tu primer callback

Los agentes de codificación como Claude Code, Codex y Cursor pueden crear ellos mismos la URL de webhook.site. En un cliente solo de chat, pega una desde webhook.site.

El agente programa la llamada directamente con esa URL. Nunca ve el secreto de firma. Ese permanece en la página del endpoint en el panel de control.

Esto es lo que hace un cliente conectado:

#	Herramienta o recurso	Para qué sirve
1	herramienta schedules_create	Crear una programación
2	herramienta schedules_read	Leer una programación
3	herramienta occurrences_list	Listar ocurrencias retenidas
4	herramienta occurrences_read	Leer una ocurrencia
5	herramienta attempts_list	Listar intentos de entrega
6	herramienta attempts_read	Leer un intento de entrega
7	herramienta schedules_cancel	Cancelar una programación

La cancelación va al final y solo detiene una programación que aún no se ha disparado. Una vez que una de un solo uso se ha entregado, no hay nada que cancelar, y la llamada responde state_conflict.

Tu cliente solicita acceso completo, incluida la facturación y las claves API. Si eso es más de lo que quieres, conéctate con una clave API que tenga solo los ámbitos que elijas.

Claude Code

El agente de codificación de Anthropic, en la terminal y en el editor. Habla la revisión de protocolo más reciente, por lo que es el más estricto de los tres sobre lo que envía el servidor.

1. Añade el servidor a Claude Code. Un comando, una dirección. Claude Code lee el documento de descubrimiento por sí mismo y marca el servidor como que requiere autenticación. Añade –scope user para que esté disponible en todos los proyectos en lugar de solo en este.

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

2. Autorízalo. Claude Code se registra a sí mismo y abre la pantalla de consentimiento de GreatWait en tu navegador. Elige el proyecto y luego aprueba. Dentro de una sesión de Claude Code, el mismo paso es /mcp, luego el servidor y luego Authenticate.

claude mcp login greatwait

3. Comprueba que está conectado. Conectado significa autorizado y que se leyó la lista de herramientas. Dentro de una sesión, /mcp lista las herramientas en sí. Una conexión autorizada con menos ámbitos lista menos herramientas, que es la forma más rápida de distinguir un problema de ámbito de un problema de conexión.

claude mcp get greatwait

Autenticar con una clave API

Claude Code guarda la clave en texto plano en ~/.claude.json, donde cualquier cosa que se ejecute como tú puede leerla.

1. Crea una clave. En el panel de claves API, selecciona New key y marca endpoints:write, occurrences:read, schedules:read, schedules:write. La clave se muestra una sola vez.
2. Añade el servidor con la clave. Reemplaza el marcador de posición con tu clave. Si greatwait ya está añadido, elimínalo primero con 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

El agente de codificación de OpenAI, en la terminal. Su cliente MCP es su propia implementación y retiene cada cambio para tu aprobación antes de realizarlo.

1. Añade el servidor a Codex. Un comando, una dirección. Codex escribe el servidor en ~/.codex/config.toml, ve que necesita autorización y pasa directamente al inicio de sesión siguiente.

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

2. Autorízalo. Codex se registra a sí mismo y abre la pantalla de consentimiento de GreatWait en tu navegador. Elige el proyecto y luego aprueba. Ejecuta esto solo si el inicio de sesión del paso de añadir se cerró antes de terminar.

codex mcp login greatwait

3. Comprueba que está autorizado. La línea de greatwait muestra OAuth una vez que la aprobación se ha registrado. Dentro de una sesión de Codex, /mcp lista las herramientas. Codex te pide que apruebes cada llamada a herramienta que cambie algo, como crear una programación; las lecturas se ejecutan sin preguntar.

codex mcp list

Autenticar con una clave API

Codex lee la clave de una variable de entorno, por lo que queda en texto plano dondequiera que la establezcas, como en tu perfil de shell.

1. Crea una clave. En el panel de claves API, selecciona New key y marca endpoints:write, occurrences:read, schedules:read, schedules:write. La clave se muestra una sola vez.
2. Pon la clave en una variable de entorno. Reemplaza el marcador de posición con tu clave. Añade la línea a tu perfil de shell para que cada terminal desde la que Codex se inicie la tenga.

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

3. Añade el servidor con la clave. Codex escribe el servidor en ~/.codex/config.toml con el nombre de la variable, no la clave. Si greatwait ya está añadido, elimínalo primero con codex mcp remove greatwait.

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

Cursor

El editor de código con IA. Su cliente MCP es su propia implementación en lugar del SDK de referencia, y fue el primer cliente probado contra producción.

1. Añade el servidor a la configuración MCP de Cursor. Una entrada, una dirección. Cursor lee el documento de descubrimiento por sí mismo y deduce que el servidor necesita autorización.

En ~/.cursor/mcp.json:

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

2. Autorízalo. Cursor se registra a sí mismo y abre la pantalla de consentimiento de GreatWait en tu navegador. Aprueba allí. Dentro del editor, el mismo paso es el aviso de inicio de sesión junto al servidor en la configuración.

cursor-agent mcp login greatwait

3. Comprueba qué puede hacer. Las herramientas que tu conexión puede ver. Una conexión autorizada con menos ámbitos lista menos herramientas, que es la forma más rápida de distinguir un problema de ámbito de un problema de conexión.

cursor-agent mcp list-tools greatwait

Autenticar con una clave API

Cursor guarda la clave en texto plano en ~/.cursor/mcp.json, donde cualquier cosa que se ejecute como tú puede leerla.

1. Crea una clave. En el panel de claves API, selecciona New key y marca endpoints:write, occurrences:read, schedules:read, schedules:write. La clave se muestra una sola vez.
2. Añade la clave a la configuración MCP de Cursor. Reemplaza el marcador de posición con tu clave. No se vuelve a mostrar en ningún otro lugar.

En ~/.cursor/mcp.json:

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

Desactivar una conexión

Abre Settings → Access.

• Un cliente con el que iniciaste sesión con OAuth está en Connected applications. Selecciona Withdraw access y luego Withdraw it. Su siguiente llamada a herramienta será rechazada.
• Una clave está en API keys. Selecciona Revoke y luego Revoke it. Eso no se puede deshacer. Para reconectarte, crea una nueva clave con New key y actualiza la configuración del cliente.

Solución de problemas

Lo que ves	Qué hacer
La pantalla de consentimiento se niega antes de mostrar ningún ámbito, nombrando la redirección.	Cierra cualquier pestaña de inicio de sesión anterior e inicia sesión de nuevo: claude mcp login greatwait en Claude Code, codex mcp login greatwait en Codex o cursor-agent mcp login greatwait en Cursor. Un inicio de sesión anterior a medio terminar es la causa habitual.
Aprobaste en el navegador, pero el cliente aún dice que el servidor necesita autenticación.	Inicia sesión de nuevo con el mismo comando. Un código de inicio de sesión funciona una sola vez y caduca rápidamente.
El cliente dice que el servidor necesita autenticación o no lista ninguna herramienta.	La conexión no ha iniciado sesión. Con OAuth, ejecuta de nuevo el comando de inicio de sesión de tu cliente. Con una clave, comprueba que la copiaste completa. Se muestra una sola vez, y parte de una clave falla igual que una incorrecta.
Las llamadas que funcionaban hace un momento ahora fallan siempre.	Alguien revocó la clave, y eso no se puede deshacer. Crea una nueva clave en el panel de claves API y ponla en la configuración del cliente.
Las llamadas fallan siempre, a partir de una fecha límite que te comunicaron.	La clave se rotó y la antigua ha dejado de funcionar. Usa la nueva clave que te mostraron al rotar. Si no la guardaste, rota de nuevo.
Algunas herramientas funcionan y una falla nombrando el ámbito que necesita.	La conexión no tiene ese ámbito. Con OAuth, inicia sesión de nuevo y apruébalo. Con una clave, crea una nueva que lo tenga. Los ámbitos de una clave no se pueden cambiar.
Una llamada a herramienta nombra una programación o endpoint que la conexión no puede ver.	Cada conexión trabaja en un proyecto, por lo que un ID copiado de otro proyecto no está allí. Pide al cliente que liste lo que puede ver y usa un ID de esa lista.
Una llamada a herramienta se rechaza por un argumento que el cliente pensaba que era opcional.	Un argumento que nombra otro proyecto se rechaza, no se ignora. Elimínalo. La conexión ya conoce su proyecto.

Configuración de cookies