All docs

ChatGPT and Codex

Codex CLI runs Marina on your machine. Anything working in a browser signs in to the hosted server instead.

Codex CLI

codex mcp add marina --env MARINA_API_TOKEN=<token> -- marina mcp

Mint the token first, so Codex is not holding your own credential:

marina tokens create codex --preset agent --spend 200

That writes an entry to ~/.codex/config.toml, which you can also edit by hand:

[mcp_servers.marina]
command = "marina"
args = ["mcp"]

Start Codex and Marina’s tools are available, filtered to what the credential allows.

Working in the browser

The setup above runs on your machine, on stdin and stdout, so nothing in a browser can reach it. Point anything working in a browser at the hosted server instead:

https://mcp.marinahost.app/mcp

It is an address rather than a subprocess, so a client adds it as a connector and sends you to Marina to sign in. There is no token to mint and nothing to install. Connect an agent covers what the sign-in screen asks for.

Without a token

Leave --env off and the server uses whatever marina login stored on that machine, which is your own account with all of your permissions. Give it its own credential for anything you are not watching.

When it does not connect

Codex starts marina as a subprocess. If which marina disagrees with the command in config.toml, use the absolute path.