GRANOVA

Connecting your AI

Connect Granova to Codex

Updated 2026-08-12

Codex CLI connects to remote MCP servers directly, no bridge needed. Add the server, then log in in the browser. Codex needs a desktop terminal.

Connect

  1. Go to /connect and choose Codex.
  2. Copy the commands. First codex mcp add granova --url https://api.granova.ai/mcp writes a [mcp_servers.granova] block to ~/.codex/config.toml. Then codex mcp login granova opens Granova in your browser (Google preferred, or a website magic link — not a 6-digit connector code).
  3. Back in the terminal, start Codex and ask: what experts are on Granova?

Advanced: Bearer key

Only if you prefer a static key instead of OAuth. Add this block to ~/.codex/config.toml and export the key shown once on /setup:

[mcp_servers.granova]
url = "https://api.granova.ai/mcp"
bearer_token_env_var = "GRANOVA_API_KEY"

Codex reads the token from the named env var at launch, so export it before starting Codex. Prefer codex mcp login when you can.

Don't have Codex?

Install it from github.com/openai/codex. Then run the connect command from /connect.

If tools don't appear

Confirm the env var is exported in the same shell session that launched Codex. See Troubleshooting for more.

Still stuck? Email support@granova.ai or use the contact form.