Ajouter OceanToken à votre agent de code

OceanToken propose un serveur MCP et un plugin pour les agents de code. Avec eux, votre agent peut chercher dans le catalogue de modèles, voir ce que coûtera une requête, générer des images, des vidéos et des voix off, transcrire de l’audio et confier une sous-tâche à un autre modèle, le tout débité de votre solde OceanToken.

Cela ajoute des outils ; l’agent garde son propre modèle. Pour faire tourner l’agent lui-même sur des modèles OceanToken, consultez Faire tourner votre agent sur OceanToken.

Le plugin, l’installeur en ligne de commande et leurs manifestes sont open source sur github.com/OceanTokenAI/oceantoken-plugins.

Claude Code : installer le plugin

Tapez ces deux commandes dans Claude Code :

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken

Lancez ensuite /mcp, choisissez plugin:oceantoken:oceantoken et sélectionnez Authenticate pour vous connecter. Le plugin ajoute les outils et skills ci-dessous. Pour les autres agents, consultez Connecter en une commande.

Ce que reçoit votre agent

Outil	Ce qu’il fait
search_models	Cherche dans le catalogue par nom, type, éditeur, capacité et prix
get_model	Tarifs, limites, et tailles, durées et entrées qu’accepte un modèle
estimate_cost	Le coût d’une requête avant son exécution, et si votre solde suffit
generate_image	Texte vers image et retouche d’images, avec aperçus et liens de téléchargement
create_video et get_job	Vidéo à partir d’un texte, d’une première (et dernière) image ou de médias de référence
generate_speech	Voix off et narration
transcribe_audio	Transcriptions et sous-titres SRT ou VTT
ask_model	Confier une sous-tâche à un autre modèle : moins cher, ou pour un second avis
upload_file	Utiliser des fichiers locaux comme références
get_account	Solde, solde disponible et dépenses

Trois skills apprennent à l’agent à bien s’en servir : oceantoken-media produit images, vidéos et audio pour un projet, oceantoken-models choisit, chiffre et délègue, et oceantoken-setup fait tourner Codex ou Claude Code lui-même sur OceanToken ou branche votre application.

Connecter en une commande

Demandez à votre agent :

Install OceanToken for me by following https://mcp.oceantoken.ai/install

ou lancez-la vous-même dans un terminal :

npx -y @oceantoken/cli@latest connect <client>

Elle nécessite Node.js 18.17 ou plus récent. <client> vaut l’un de ceux-ci :

Client	<client>	Connexion
Codex (CLI ou app)	codex	La commande ouvre votre navigateur et attend
Claude Code (terminal, extension IDE ou app de bureau)	claude-code	La commande ouvre votre navigateur et attend
Cursor	cursor	Dans Cursor, sous Settings → Tools & MCP
Gemini CLI	gemini	Dans Gemini CLI : /mcp auth oceantoken
OpenClaw	openclaw	La commande ouvre votre navigateur et attend
OpenCode	opencode	La commande ouvre votre navigateur et attend
VS Code (GitHub Copilot)	vscode	Dans VS Code, au démarrage du serveur
WorkBuddy	workbuddy	Dans WorkBuddy
Hermes Agent	hermes	La commande ouvre votre navigateur et attend
Windsurf / Devin Desktop	windsurf	Dans Cascade

Chaque client reçoit le serveur MCP et les trois skills, sauf Windsurf, qui n’a pas de dossier de skills et ne reçoit que le serveur.

Ce que la commande modifie :

• Codex, Claude Code, Gemini CLI et OpenClaw reçoivent le plugin, installé avec la ligne de commande du client. Avec --api-key, Codex, Claude Code et Gemini CLI reçoivent à la place une entrée oceantoken dans leur fichier de configuration.
• Les autres clients reçoivent une entrée oceantoken dans leur fichier de configuration MCP. Les entrées existantes sont conservées, et un fichier contenant des commentaires n’est jamais réécrit : vous recevez l’extrait à coller.
• Avant de modifier un fichier de configuration pour la première fois, la commande le copie dans <file>.bak-oceantoken et n’écrase jamais cette copie : votre original survit à autant de connexions et déconnexions que vous voulez. Chaque modification ultérieure laisse aussi <file>.bak-oceantoken-<UTC time> avec le fichier tel qu’il était juste avant. Une sauvegarde est une simple copie : si le fichier contenait une clé, la sauvegarde aussi.
• Les skills vont dans le dossier de skills du client.

La relancer est sans risque ; elle met à jour ce qu’elle a installé. Elle se termine par un résumé : Result connected signifie que c’est terminé, et incomplete liste sous Next ce qu’il reste à faire, comme se connecter depuis l’app ou redémarrer la session.

Options

--api-key <key|->   Use an API key instead of OAuth sign-in ("-" reads it from stdin)
--use-env-key       Use the key in OCEANTOKEN_API_KEY
--no-login          Configure only; do not start the sign-in
--no-skills         Do not install the OceanToken skills
--dry-run           Show what would change without changing anything
--json              Print the report as JSON
--url <mcp-url>     MCP endpoint (default https://mcp.oceantoken.ai/mcp)

npx -y @oceantoken/cli@latest clients liste les clients pris en charge et ceux installés sur cette machine.

Se connecter

La connexion passe par OAuth. La page de connexion propose deux façons de connecter :

• Sign in avec l’e-mail et le mot de passe de votre compte OceanToken. Cela crée une clé API pour l’application qui se connecte, que vous pouvez voir et révoquer sous API Keys dans la console. Les nouveaux utilisateurs peuvent créer un compte sur la même page.
• API key : collez une clé que vous avez déjà. Donnez-lui une limite de crédits si vous voulez plafonner ce que l’agent peut dépenser.

Révoquer la clé déconnecte l’agent immédiatement.

Pour connecter avec une clé et sans navigateur, passez-la sur stdin afin qu’elle reste hors de l’historique de votre shell. La commande ne met jamais la clé sur la ligne de commande d’un autre programme et ne l’affiche jamais : elle l’écrit seulement dans le fichier de configuration du client (OpenClaw la reçoit sur stdin et écrit sa propre configuration) :

printf %s "$OCEANTOKEN_API_KEY" | npx -y @oceantoken/cli@latest connect <client> --api-key -

Configurer à la main

Le même résultat que la commande, client par client.

Codex

codex plugin marketplace add OceanTokenAI/oceantoken-plugins
codex plugin add oceantoken@oceantoken
codex mcp login oceantoken

La dernière commande ouvre la page de connexion. Dans l’app Codex, vous pouvez aussi ajouter le marketplace, puis installer OceanToken depuis le panneau Plugins et vous connecter quand c’est demandé.

Sans navigateur

Sur un serveur, en CI ou partout où une connexion par navigateur est impossible, ajoutez le serveur avec une clé API au lieu du plugin :

export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

Codex ne stocke que le nom de la variable et y lit la clé à chaque démarrage. codex mcp list affiche le serveur avec l’authentification Bearer token. Cela ajoute les outils mais pas les skills. npx -y @oceantoken/cli@latest connect codex --use-env-key ajoute les deux, mais écrit la clé elle-même dans config.toml.

Outils payants dans codex exec

codex exec ne peut pas s’arrêter pour vous demander, il refuse donc tout outil qui dépense du solde ou envoie un fichier, avec MCP tool call requires approval, but approval policy is never. Il s’agit de generate_image, create_video, generate_speech, transcribe_audio, ask_model et upload_file. Approuvez ceux dont l’exécution a besoin et donnez au sandbox l’accès au réseau pour que Codex puisse télécharger ce que renvoient les outils :

codex exec -s workspace-write \
  -c 'mcp_servers.oceantoken.tools.generate_image.approval_mode="approve"' \
  -c 'mcp_servers.oceantoken.tools.generate_speech.approval_mode="approve"' \
  -c sandbox_workspace_write.network_access=true \
  "Make a hero image for the landing page and save it as hero.png"

• -c 'mcp_servers.oceantoken.default_tools_approval_mode="approve"' approuve tous les outils d’OceanToken d’un coup.
• Les outils renvoient des liens de téléchargement. Sans sandbox_workspace_write.network_access=true, le sandbox de Codex n’a pas de réseau et le téléchargement échoue.
• search_models, get_model, estimate_cost, get_account et get_job ne font que lire et s’exécutent sans approbation.
• Ces surcharges -c fonctionnent quand le serveur est dans config.toml, comme le placent codex mcp add ci-dessus ou connect codex --use-env-key. Avec le plugin, Codex s’arrête sur invalid transport in mcp_servers.oceantoken : utilisez donc la voie de la clé pour codex exec.

Claude Code

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken
/mcp

Dans /mcp, choisissez plugin:oceantoken:oceantoken et sélectionnez Authenticate.

App de bureau Claude et claude.ai

Settings → Connectors → Add custom connector, URL https://mcp.oceantoken.ai/mcp, puis Connect. Cela ajoute les outils ; les skills viennent avec le plugin Claude Code.

Cursor

Ajoutez le serveur MCP à Cursor. Cursor vous demande de vous connecter la première fois qu’un outil s’exécute. Pour avoir aussi les skills, installez le plugin depuis le dépôt, qui contient un manifeste de marketplace Cursor, ou utilisez la commande ci-dessus.

Gemini CLI

gemini extensions install https://github.com/OceanTokenAI/oceantoken-plugins

Ensuite, dans Gemini CLI, lancez /mcp auth oceantoken et connectez-vous. L’extension apporte le serveur MCP et les trois skills.

OpenClaw

openclaw plugins install clawhub:@oceantoken/oceantoken --accept-capabilities
openclaw mcp set oceantoken '{"url":"https://mcp.oceantoken.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login oceantoken

Le paquet apporte les trois skills. mcp set enregistre le serveur auprès d’OpenClaw pour que mcp login puisse vous connecter.

Tout autre client MCP

Le serveur est https://mcp.oceantoken.ai/mcp, en streamable HTTP. Il prend en charge OAuth avec enregistrement dynamique des clients : la plupart des clients n’ont besoin que de l’URL :

{
  "mcpServers": {
    "oceantoken": { "type": "http", "url": "https://mcp.oceantoken.ai/mcp" }
  }
}

Pour utiliser plutôt une clé API, envoyez-la comme bearer token :

# Codex, without the plugin
export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

# Claude Code, without the plugin
claude mcp add --transport http oceantoken https://mcp.oceantoken.ai/mcp \
  --header "Authorization: Bearer $OCEANTOKEN_API_KEY"

Le serveur figure aussi dans le MCP Registry officiel sous le nom ai.oceantoken/mcp : les clients qui parcourent le registry peuvent le trouver par son nom.

Faire utiliser OceanToken par votre agent

Les agents choisissent eux-mêmes leurs outils. Ils se tournent vers OceanToken pour ce qu’ils ne savent pas faire seuls, comme la vidéo, les voix off, les sous-titres et les estimations de coût. Pour le reste, demandez-le nommément :

• $oceantoken-media ... dans Codex, /oceantoken:oceantoken-media ... dans Claude Code, ou simplement « utilise OceanToken pour ... ».

• Ou faites-en une règle de projet dans AGENTS.md (Codex) ou CLAUDE.md (Claude Code) :

  Generate images, video, voice-overs and subtitles with the OceanToken tools.
  Estimate the cost first and ask me before spending more than $2.

Coûts

Ce que génèrent les outils est débité de votre solde aux mêmes prix que l’API ; consultez Modèles. Demandez d’abord une estimation à l’agent : c’est le rôle de estimate_cost. Les tâches vidéo réservent leur coût estimé au démarrage et facturent le coût réel à la fin, et les tâches échouées ne sont pas facturées. Chaque requête apparaît dans la console sous Logs.

Le retirer

npx -y @oceantoken/cli@latest disconnect <client>

Cela retire seulement ce que connect a ajouté. Pour couper l’accès sur-le-champ, révoquez la clé de l’agent sous API Keys.