# Codex front door — MCP server

Wraps the Google Ads Gateway Worker as two Codex tools: `list_accounts` and `run_gaql`.
Holds no Google credentials — just the Worker URL and the shared team token.

## Per-laptop setup (each teammate, once)

Logging into the shared ChatGPT/Codex account does **not** carry this — MCP config is a
local file. Each laptop does this once (~30 seconds):

```bash
cd <path-to>/google-ads-gateway/mcp
npm install
```

Then add the server to Codex's config. For **Codex CLI**, edit `~/.codex/config.toml`:

```toml
[mcp_servers.google_ads]
command = "node"
args = ["/ABSOLUTE/PATH/TO/google-ads-gateway/mcp/index.js"]
env = { GADS_GATEWAY_URL = "https://google-ads-gateway.<subdomain>.workers.dev", GADS_GATEWAY_TOKEN = "<team token>" }
```

(For the IDE/desktop Codex, add the same `command` / `args` / `env` in its MCP settings UI.)

Restart Codex. Then in a session:

> list my google ads accounts
> for ACI, pull cost, clicks and conversions by campaign for the last 30 days

## Quick local test (without Codex)

```bash
GADS_GATEWAY_URL=https://google-ads-gateway.<subdomain>.workers.dev \
GADS_GATEWAY_TOKEN=<team token> \
npx @modelcontextprotocol/inspector node index.js
```