okokumo dans votre assistant IA

Un serveur MCP hébergé pour Claude, ChatGPT, Cursor, VS Code et tout autre client MCP — connexion par le navigateur ou clé d'API, les mêmes règles que l'API REST, sur tous les forfaits.

okokumo exploite un serveur Model Context Protocol officiel et hébergé. Branchez-le sur un assistant IA et vous pouvez lui demander quelles sondes sont en panne, si vous avez été alerté, quelle a été la disponibilité d'une sonde cette semaine — ou lui faire créer une sonde, en mettre une en pause pendant un déploiement, ou raconter un incident sur votre page de statut.

C'est une fine couche au-dessus de l'API REST publique : chaque outil est un appel à une route /v1, fait en votre nom — par une connexion dans le navigateur ou une clé d'API — avec la même authentification, le même cloisonnement par organisation, les mêmes contrôles de rôle et les mêmes limites de forfait. Il ne peut rien faire qu'une clé d'API ne puisse déjà faire en REST.

1. Se connecter depuis le navigateur (recommandé)

Claude, ChatGPT, Cursor, VS Code et Claude Code se connectent avec la seule URL https://app.okokumo.com/mcp. Pas de clé à créer, à coller ni à garder hors de git.

  1. Ajoutez okokumo à votre client avec cette URL (détails par client ci-dessous).
  2. Le client ouvre okokumo dans votre navigateur. Connectez-vous si ce n'est pas déjà fait.
  3. Un écran de consentement affiche le nom de l'application, l'adresse vers laquelle elle vous renverra, votre organisation, et ce qu'elle obtient : un accès complet, le même qu'une clé d'API, avec votre rôle. Approuvez ou refusez. N'approuvez qu'une connexion que vous avez lancée vous-même.
  4. De retour dans le client, les outils sont là.

Seuls les propriétaires et les administrateurs peuvent approuver, comme pour créer une clé d'API. L'application est connectée à l'organisation nommée sur l'écran de consentement, et à elle seule.

Claude (claude.ai, Claude Desktop)

Settings → Connectors → Add custom connector, avec l'URL https://app.okokumo.com/mcp.

ChatGPT

Dans les réglages des connecteurs de ChatGPT, ajoutez un connecteur personnalisé avec la même URL.

Claude Code

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

Lancez ensuite /mcp dans Claude Code, choisissez okokumo et connectez-vous.

Cursor

Dans ~/.cursor/mcp.json ou .cursor/mcp.json :

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

Cursor propose ensuite de vous connecter depuis ses réglages MCP.

VS Code

Dans .vscode/mcp.json :

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

VS Code vous demande de vous connecter au démarrage du serveur.

Testés de bout en bout à ce jour : Claude Code et MCP Inspector. claude.ai, ChatGPT, Cursor et VS Code implémentent la même spécification d'autorisation MCP, mais n'ont pas encore été essayés en conditions réelles avec okokumo. Si l'un d'eux échoue, dites-le-nous ; une clé d'API (section 3) fonctionne en attendant.

2. Applications connectées et révocation

Account → Connected apps liste toutes les applications connectées à votre organisation : leur nom, qui les a connectées et quand, et leur dernière utilisation. Tous les membres voient la liste ; les propriétaires et les administrateurs peuvent y révoquer une application (Revoke). La révocation est immédiate : l'application est refusée dès sa requête suivante.

3. Ou utiliser une clé d'API

Pour les scripts, la CI et les clients sans connexion OAuth. Les clés d'API fonctionnent exactement comme avant, à côté des applications connectées.

Dans le tableau de bord, Account → API keys (propriétaires et administrateurs). La clé n'est affichée qu'une fois.

4. Connecter un client avec une clé

Remplacez sk_… par votre clé.

Claude Code

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

Pour un .mcp.json partagé par tout le projet (--scope project), mettez Bearer ${OKOKUMO_API_KEY} dans l'en-tête et exportez la variable dans votre shell : la clé n'atterrit jamais dans le dépôt.

Claude Desktop

Le connecteur personnalisé de la section 1 n'a pas besoin de clé. Pour utiliser une clé à la place, passez par la passerelle mcp-remote (nécessite Node.js) dans 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_…" }
    }
  }
}

La valeur de l'en-tête passe par env parce que certaines plateformes coupent les arguments sur l'espace de Bearer sk_…. Redémarrez Claude Desktop après modification.

Cursor

Dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (un seul projet) :

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

Autres clients

Tout client MCP qui parle Streamable HTTP et sait envoyer un en-tête Authorization se connecte de la même façon : le point d'accès ci-dessus, votre clé comme jeton bearer.

5. Ce qu'il sait faire

18 outils : 10 en lecture, 8 en écriture. Aucun ne supprime quoi que ce soit, aucun ne touche aux clés d'API — les suppressions et la gestion des clés restent dans le tableau de bord.

Ce qui diffère d'un appel REST direct, volontairement :

6. Limites et erreurs