Codex

Connect ASO++ to OpenAI Codex CLI using MCP server configuration.

OpenAI Codex CLI is OpenAI's terminal-based coding agent. It supports MCP servers via a configuration file in your home directory.

Prerequisites

Codex CLI installed (npm install -g @openai/codex)
An ASO++ API token — generate one here

Configuration

•

Open the Codex config file

The Codex configuration file lives at ~/.codex/config.json. Create it if it doesn't exist.

mkdir -p ~/.codex && touch ~/.codex/config.json

•

Add the ASO++ MCP server

Open ~/.codex/config.json and add:

{
  "mcpServers": {
    "asopp": {
      "type": "http",
      "url": "https://asopp.cc/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with your actual token.

•

Start a Codex session

Run:

codex

Then type a prompt that uses ASO++ tools:

Find the top competitor keywords for the Duolingo app in the US market

Codex will call get_competitor_keywords and return the results.

Using environment variables

To keep your token out of the config file:

{
  "mcpServers": {
    "asopp": {
      "type": "http",
      "url": "https://asopp.cc/mcp",
      "headers": {
        "Authorization": "Bearer ${ASO_TOKEN}"
      }
    }
  }
}

Export the variable in your shell profile:

export ASO_TOKEN="your_token_here"

Troubleshooting

Tokens — Generate or revoke tokens
MCP setup overview — Troubleshooting tips and other supported tools

PreviousVS Code NextGemini CLI