okokumo en tu asistente de IA

okokumo opera un servidor Model Context Protocol oficial y alojado. Conéctalo a un asistente de IA y podrás preguntarle qué comprobaciones están caídas, si recibiste la alerta, cuál fue la disponibilidad de una comprobación esta semana — o pedirle que cree una comprobación, que pause una durante un despliegue o que narre un incidente en tu página de estado.

Es una capa fina sobre la API REST pública: cada herramienta es una llamada a una ruta /v1, hecha en tu nombre — mediante un inicio de sesión en el navegador o una clave de API — con la misma autenticación, la misma separación por organización, las mismas comprobaciones de rol y los mismos límites de plan. No puede hacer nada que una clave de API no pueda hacer ya por REST.

• Endpoint: https://app.okokumo.com/mcp, MCP Streamable HTTP
• Autenticación: inicio de sesión en el navegador (OAuth), el cliente solo necesita la URL; o una clave de API de okokumo, enviada como Authorization: Bearer sk_…
• Planes: todos, Free incluido
• Límite de peticiones: el presupuesto de API de tu organización, 120 peticiones por minuto, compartido con REST

1. Conéctate iniciando sesión (recomendado)

Claude, ChatGPT, Cursor, VS Code y Claude Code se conectan solo con la URL https://app.okokumo.com/mcp. No hay ninguna clave que crear, pegar ni mantener fuera de git.

1. Añade okokumo a tu cliente con esa URL (por cliente, abajo).
2. El cliente abre okokumo en tu navegador. Inicia sesión si aún no lo has hecho.
3. Una pantalla de consentimiento muestra el nombre de la aplicación, la dirección a la que te devolverá, tu organización y lo que obtiene: acceso completo, el mismo que una clave de API, con tu rol. Aprueba o deniega. Aprueba solo una conexión que hayas iniciado tú.
4. De vuelta en el cliente, las herramientas están disponibles.

Solo los propietarios y administradores pueden aprobar, la misma regla que para crear una clave de API. La aplicación queda conectada a la organización que indica la pantalla de consentimiento, y solo a ella.

Claude (claude.ai, Claude Desktop)

Settings → Connectors → Add custom connector, con la URL https://app.okokumo.com/mcp.

ChatGPT

En los ajustes de conectores de ChatGPT, añade un conector personalizado con la misma URL.

Claude Code

claude mcp add --transport http okokumo https://app.okokumo.com/mcp

Después ejecuta /mcp en Claude Code, elige okokumo e inicia sesión.

Cursor

En ~/.cursor/mcp.json o .cursor/mcp.json:

{
  "mcpServers": {
    "okokumo": { "url": "https://app.okokumo.com/mcp" }
  }
}

Cursor te ofrecerá iniciar sesión desde sus ajustes de MCP.

VS Code

En .vscode/mcp.json:

{
  "servers": {
    "okokumo": { "type": "http", "url": "https://app.okokumo.com/mcp" }
  }
}

VS Code te pide iniciar sesión cuando arranca el servidor.

Probados de extremo a extremo hasta ahora: Claude Code y MCP Inspector. claude.ai, ChatGPT, Cursor y VS Code implementan la misma especificación de autorización MCP, pero aún no se han probado en real con okokumo. Si alguno falla, avísanos; mientras tanto, una clave de API (sección 3) funciona.

2. Aplicaciones conectadas y revocación

Account → Connected apps lista todas las aplicaciones conectadas a tu organización: su nombre, quién la conectó y cuándo, y cuándo se usó por última vez. Todos los miembros ven la lista; los propietarios y administradores pueden revocar una aplicación ahí (Revoke). La revocación es inmediata: la aplicación se rechaza en su siguiente petición.

• Los tokens de acceso duran una hora y se renuevan solos. Una aplicación que pase 30 días sin usarse debe aprobarse de nuevo.
• Un restablecimiento de contraseña, una cuenta suspendida o la salida de la organización desconecta todas las aplicaciones que esa persona conectó.

3. O usa una clave de API

Para scripts, CI y clientes sin inicio de sesión OAuth. Las claves de API funcionan exactamente como antes, junto a las aplicaciones conectadas.

En el panel, Account → API keys (propietarios y administradores). La clave se muestra una sola vez.

• Una clave actúa con el rol de la persona que la creó. La clave de un propietario o de un administrador puede hacer todo lo que se enumera abajo; la de un miembro puede gestionar comprobaciones pero no incidentes — exactamente como por REST.
• Usa una clave por cliente — una para Claude Code, otra para Cursor — para poder revocar cada una por separado. La clave se verifica en cada petición: una clave revocada desconecta al cliente en su siguiente mensaje.
• La configuración de abajo contiene un secreto. Trátala como un archivo de contraseñas y mantenla fuera de git.

4. Conecta un cliente con una clave

Sustituye sk_… por tu clave.

Claude Code

claude mcp add --transport http okokumo https://app.okokumo.com/mcp \
  --header "Authorization: Bearer sk_…"
claude mcp get okokumo

Para un .mcp.json de todo el proyecto (--scope project), pon Bearer ${OKOKUMO_API_KEY} en la cabecera y exporta la variable en tu shell, para que la clave nunca acabe en el repositorio.

Claude Desktop

El conector personalizado de la sección 1 no necesita clave. Para usar una clave en su lugar, conéctate mediante el puente mcp-remote (necesita Node.js) en claude_desktop_config.json:

{
  "mcpServers": {
    "okokumo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.okokumo.com/mcp",
               "--header", "Authorization:${OKOKUMO_AUTH}"],
      "env": { "OKOKUMO_AUTH": "Bearer sk_…" }
    }
  }
}

El valor de la cabecera pasa por env porque algunas plataformas dividen los argumentos en el espacio de Bearer sk_…. Reinicia Claude Desktop después de editarlo.

Cursor

En ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto):

{
  "mcpServers": {
    "okokumo": {
      "url": "https://app.okokumo.com/mcp",
      "headers": { "Authorization": "Bearer sk_…" }
    }
  }
}

Otros clientes

Cualquier cliente MCP que hable Streamable HTTP y pueda enviar una cabecera Authorization se conecta igual: el endpoint de arriba, tu clave como token bearer.

5. Qué puede hacer

18 herramientas: 10 de lectura, 8 de escritura. Ninguna borra nada, ninguna toca las claves de API — borrar y gestionar claves se queda en el panel.

• Lectura: tu cuenta; tus comprobaciones; la disponibilidad y la latencia de una comprobación en un día, una semana o un mes; sus cambios de estado; las alertas que envió; los canales a los que alerta; tus canales; tu página de estado y sus incidentes.
• Escritura: crear una comprobación, modificarla, pausarla, reanudarla, elegir a qué canales alerta; crear un incidente, modificarlo, publicar una actualización.

Lo que cambia respecto a llamar a REST directamente, a propósito:

• Actualizaciones parciales. Editar una comprobación o un incidente cambia solo los campos que nombras; la herramienta lee primero el registro actual y conserva el resto.
• Las duraciones van en segundos. grace_seconds: 600 son diez minutos. Las descripciones de las herramientas lo dicen, porque los minutos son el error clásico de un modelo aquí.
• URL de ping incluidas. Las comprobaciones heartbeat y cron vuelven con la ping_url que el trabajo debe llamar.
• Los secretos de los canales quedan fuera de la conversación. Las URL de webhook, los secretos de firma y los ID de chat de Telegram nunca se devuelven.
• Argumentos estrictos. Un argumento desconocido se rechaza con la lista de los aceptados, en lugar de ignorarse en silencio.
• Las escrituras están marcadas. Cada herramienta declara si solo lee o qué modifica, para que tu cliente pueda preguntar antes de ejecutar una escritura. Pausar una comprobación o restringir el enrutamiento de sus alertas cuenta como destructivo — son alertas que no se enviarán — y el modelo tiene instrucciones de confirmarlo contigo primero, y de publicar un incidente solo cuando lo pidas: los incidentes empiezan como borradores privados.

6. Límites y errores

• Cada petición a /mcp cuenta contra las 120 peticiones por minuto de tu organización — el mismo presupuesto que REST, y ambos se suman. Las herramientas que leen antes de escribir (modificar, pausar o reanudar una comprobación, modificar un incidente) cuentan doble.
• Por encima del límite, al asistente se le indica cuántos segundos esperar, y que no reintente en bucle.
• Una llamada rechazada — un límite del plan, un rol sin permiso, un ID que no existe — vuelve como un error que el modelo puede leer y explicarte, terminado con el estado HTTP.
• Una clave desconocida o revocada recibe 401: crea una clave nueva y actualiza la configuración del cliente. Una aplicación revocada recibe la misma respuesta y debe aprobarse de nuevo.