Agrega OceanToken a tu agente de código

OceanToken tiene un servidor MCP y un plugin para agentes de código. Con ellos, tu agente puede buscar en el catálogo de modelos, ver cuánto costará una solicitud, generar imágenes, video y locuciones, transcribir audio y pasar una subtarea a otro modelo, todo con cargo a tu saldo de OceanToken.

Esto agrega herramientas; el agente sigue usando su propio modelo. Para ejecutar el propio agente con modelos de OceanToken, consulta Ejecuta tu agente en OceanToken.

El plugin, el instalador de línea de comandos y sus manifiestos son de código abierto en github.com/OceanTokenAI/oceantoken-plugins.

Claude Code: instala el plugin

Escribe estos dos comandos en Claude Code:

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

Luego ejecuta /mcp, elige plugin:oceantoken:oceantoken y selecciona Authenticate para iniciar sesión. El plugin agrega las herramientas y skills de abajo. Para otros agentes, consulta Conecta con un solo comando.

Qué obtiene tu agente

Herramienta	Qué hace
`search_models`	Busca en el catálogo por nombre, tipo, proveedor, capacidad y precio
`get_model`	Precios, límites y los tamaños, duraciones y entradas que acepta un modelo
`estimate_cost`	Cuánto costará una solicitud antes de ejecutarla y si tu saldo alcanza
`generate_image`	Texto a imagen y edición de imágenes, con vistas previas y enlaces de descarga
`create_video` y `get_job`	Video a partir de texto, de un primer (y último) fotograma o de material de referencia
`generate_speech`	Locuciones y narración
`transcribe_audio`	Transcripciones y subtítulos SRT o VTT
`ask_model`	Pasa una subtarea a otro modelo: uno más barato o una segunda opinión
`upload_file`	Usa archivos locales como referencia
`get_account`	Saldo, saldo disponible y gasto

Tres skills enseñan al agente a usarlas bien: oceantoken-media produce imágenes, video y audio para un proyecto, oceantoken-models elige modelos, calcula precios y delega, y oceantoken-setup ejecuta el propio Codex o Claude Code en OceanToken o conecta tu app.

Conecta con un solo comando

Pídele a tu agente:

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

o ejecútalo tú mismo en una terminal:

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

Necesita Node.js 18.17 o posterior. <client> es uno de estos:

Cliente	`<client>`	Inicio de sesión
Codex (CLI o app)	`codex`	El comando abre tu navegador y espera
Claude Code (terminal, extensión de IDE o app de escritorio)	`claude-code`	El comando abre tu navegador y espera
Cursor	`cursor`	En Cursor, en Settings → Tools & MCP
Gemini CLI	`gemini`	En Gemini CLI: `/mcp auth oceantoken`
OpenClaw	`openclaw`	El comando abre tu navegador y espera
OpenCode	`opencode`	El comando abre tu navegador y espera
VS Code (GitHub Copilot)	`vscode`	En VS Code, cuando arranca el servidor
WorkBuddy	`workbuddy`	En WorkBuddy
Hermes Agent	`hermes`	El comando abre tu navegador y espera
Windsurf / Devin Desktop	`windsurf`	En Cascade

Todos los clientes reciben el servidor MCP y las tres skills, salvo Windsurf, que no tiene carpeta de skills y recibe solo el servidor.

Lo que cambia el comando:

Codex, Claude Code, Gemini CLI y OpenClaw reciben el plugin, instalado con la propia línea de comandos del cliente. Con --api-key, Codex, Claude Code y Gemini CLI reciben en su lugar una entrada oceantoken en su archivo de configuración.
Los demás clientes reciben una entrada oceantoken en su archivo de configuración MCP. Las entradas existentes se conservan, y un archivo con comentarios nunca se reescribe: recibes el fragmento para pegarlo tú.
Antes de cambiar un archivo de configuración por primera vez, el comando lo copia a <file>.bak-oceantoken y nunca sobrescribe esa copia, así que tu original sobrevive a cualquier número de conexiones y desconexiones. Cada cambio posterior deja además <file>.bak-oceantoken-<UTC time> con el archivo tal como estaba justo antes. Una copia de seguridad es una copia simple: si el archivo tenía una clave, la copia también.
Las skills van a la carpeta de skills del propio cliente.

Volver a ejecutarlo es seguro; actualiza lo que instaló. Termina con un resumen: Result connected significa que terminaste, e incomplete lista lo que falta en Next, como iniciar sesión desde la app o reiniciar la sesión.

Opciones

--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 lista los clientes compatibles y cuáles están instalados en esta máquina.

El inicio de sesión es OAuth. La página de inicio de sesión ofrece dos formas de conectar:

Sign in con tu correo y contraseña de OceanToken. Esto crea una clave de API para la app que se conecta, que puedes ver y revocar en API Keys en la consola. Los usuarios nuevos pueden crear una cuenta en la misma página.
API key: pega una clave que ya tengas. Ponle un límite de créditos si quieres limitar lo que puede gastar el agente.

Revocar la clave desconecta al agente de inmediato.

Para conectar con una clave y sin navegador, pásala por stdin para que no quede en el historial de tu shell. El comando nunca pone la clave en la línea de comandos de otro programa ni la imprime: solo la escribe en el archivo de configuración del cliente (OpenClaw la recibe por stdin y escribe su propia configuración):

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

Configúralo a mano

El mismo resultado que el comando, cliente por cliente.

Codex

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

El último comando abre la página de inicio de sesión. En la app de Codex también puedes agregar el marketplace, instalar OceanToken desde el panel Plugins e iniciar sesión cuando te lo pida.

Sin navegador

En un servidor, en CI o donde no sea posible iniciar sesión en un navegador, agrega el servidor con una clave de API en lugar del plugin:

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

Codex guarda solo el nombre de la variable y lee la clave de ella cada vez que arranca. codex mcp list muestra el servidor con autenticación Bearer token. Esto agrega las herramientas pero no las skills. npx -y @oceantoken/cli@latest connect codex --use-env-key agrega ambas, pero escribe la clave misma en config.toml.

Herramientas de pago en `codex exec`

codex exec no puede detenerse a preguntarte, así que rechaza toda herramienta que gaste saldo o suba un archivo, con MCP tool call requires approval, but approval policy is never. Son generate_image, create_video, generate_speech, transcribe_audio, ask_model y upload_file. Aprueba las que necesita la ejecución y da acceso a la red al sandbox para que Codex pueda descargar lo que devuelven las herramientas:

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"' aprueba todas las herramientas de OceanToken a la vez.
Las herramientas devuelven enlaces de descarga. Sin sandbox_workspace_write.network_access=true, el sandbox de Codex no tiene red y la descarga falla.
search_models, get_model, estimate_cost, get_account y get_job solo leen y se ejecutan sin aprobación.
Estas anulaciones -c funcionan cuando el servidor está en config.toml, como lo dejan codex mcp add (arriba) o connect codex --use-env-key. Con el plugin, Codex se detiene con invalid transport in mcp_servers.oceantoken, así que usa la vía de la clave para codex exec.

Claude Code

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

En /mcp, elige plugin:oceantoken:oceantoken y selecciona Authenticate.

App de escritorio de Claude y claude.ai

Settings → Connectors → Add custom connector, URL https://mcp.oceantoken.ai/mcp y luego Connect. Esto agrega las herramientas; las skills vienen con el plugin de Claude Code.

Cursor

Agrega el servidor MCP a Cursor. Cursor te pide iniciar sesión la primera vez que se ejecuta una herramienta. Para tener también las skills, instala el plugin desde el repositorio, que tiene un manifiesto de marketplace para Cursor, o usa el comando de arriba.

Gemini CLI

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

Luego, dentro de Gemini CLI, ejecuta /mcp auth oceantoken e inicia sesión. La extensión trae el servidor MCP y las tres 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

El paquete trae las tres skills. mcp set registra el servidor en OpenClaw para que mcp login pueda iniciar tu sesión.

Cualquier otro cliente MCP

El servidor es https://mcp.oceantoken.ai/mcp, sobre streamable HTTP. Admite OAuth con registro dinámico de clientes, así que la mayoría de los clientes solo necesitan la URL:

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

Para usar una clave de API en su lugar, envíala como 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"

El servidor también está en el MCP Registry oficial como ai.oceantoken/mcp, así que los clientes que exploran el registry pueden encontrarlo por su nombre.

Haz que tu agente lo use

Los agentes eligen sus propias herramientas. Recurren a OceanToken para lo que no pueden hacer por sí mismos, como video, locuciones, subtítulos y estimaciones de costo. Para todo lo demás, pídelo por su nombre:

$oceantoken-media ... en Codex, /oceantoken:oceantoken-media ... en Claude Code, o simplemente «usa OceanToken para ...».

O conviértelo en una regla del proyecto en AGENTS.md (Codex) o 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.

Costos

Lo que generan las herramientas se cobra de tu saldo a los mismos precios que la API; consulta Modelos. Pide primero una estimación al agente: para eso está estimate_cost. Los trabajos de video reservan su costo estimado al empezar y cobran el costo real al terminar, y los trabajos fallidos no se cobran. Cada solicitud aparece en la consola en Logs.

Quítalo

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

Esto quita solo lo que agregó connect. Para cortar el acceso al instante, revoca la clave del agente en API Keys.

Claude Code: instala el plugin​

Qué obtiene tu agente​

Conecta con un solo comando​

Opciones​

Inicia sesión​

Configúralo a mano​

Codex​

Sin navegador​

Herramientas de pago en codex exec​

Claude Code​

App de escritorio de Claude y claude.ai​

Cursor​

Gemini CLI​

OpenClaw​

Cualquier otro cliente MCP​

Haz que tu agente lo use​

Costos​

Quítalo​