Docs / Integrations / Codex (MCP)

Codex integration (MCP)

The Codex integration lets you manage your press releases and companies right from a conversation. Ask Codex to "draft a launch announcement for Acme," "add our new company," or "show me my recent releases," all without leaving your AI assistant.

This works through MCP (the Model Context Protocol), an open standard for connecting AI assistants to the tools you already use. Once connected, Codex can act on your Press Ranger account on your behalf, and only on the data you own.

Your connection details live on the Integrations page, under Settings in Press Ranger.

What Codex can do

After you connect, Codex can:

  • List your companies and create or update them, including name, description, website, location, and logo.
  • List and read your press releases, including the full headline, subheadline, and body.
  • Create a new press release for one of your companies, including photos and a YouTube video. You write the brief in plain language and Codex drafts it; Press Ranger stores it as an editable draft.
  • Edit an existing draft, changing the headline, body, photos, and more.
  • Check whether a draft is ready to publish, verifying the required fields and Press Ranger's content guidelines.
  • Pull the distribution report for a published release: placements, views, and AI search visibility.

Everything Codex creates lands in your account as a draft for you to review and publish in the web app. Codex never publishes or distributes anything on its own.

What it can't do

  • It can only see and change your own companies and press releases, never anyone else's.
  • It can't publish or send a press release to distribution. Publishing always happens in the Press Ranger web app, where you confirm the details and any costs.
  • Released, queued, or scheduled press releases are locked, so Codex can't change them, just like in the editor.

Connecting Codex

Open the Integrations page (under Settings) in Press Ranger to find your connection details. There are two ways to connect, depending on how you use Codex.

Codex app

  1. In Codex, open Settings → MCP Servers, click + Add servers, and choose Streamable HTTP.
  2. Enter Press Ranger as the name.
  3. Paste your connection URL from the Integrations page (it looks like https://pressranger.com/mcp). Leave the bearer-token and header fields empty.
  4. Save, then click Authenticate on the server. Your browser opens to Press Ranger; review what Codex is asking for and click Authorize.

Codex CLI (terminal)

Add the server, then authorize:

codex mcp add pressranger --url https://pressranger.com/mcp
codex mcp login pressranger

The login command opens your browser to Authorize, the same as the app.

Prefer a token instead of the browser flow? Generate one on the Integrations page, then reference it from ~/.codex/config.toml:

[mcp_servers.pressranger]
url = "https://pressranger.com/mcp"
bearer_token_env_var = "PRESSRANGER_TOKEN"

And set it in your shell before starting Codex: export PRESSRANGER_TOKEN=YOUR_TOKEN.

Treat an access token like a password. It grants access to your Press Ranger account, and you can reveal, copy, or revoke your tokens any time from the Integrations page.

Tips for great results

  • Be specific about the company. Ask Codex to list your companies first, then tell it which one a release is for.
  • Give Codex the facts. The more context you provide (what you're announcing, key quotes, the spokesperson), the stronger the draft.
  • Add a photo by URL. Releases with an image perform noticeably better. Paste a public image link and Codex will attach it.
  • Review before publishing. Open the draft's edit link, confirm everything reads well, then publish from the web app.

Managing your connection

Everything about the connection lives on the Integrations page:

  • See and copy the connection URL.
  • Generate, reveal, or revoke access tokens.
  • Disconnect an assistant whenever you like; revoking access takes effect immediately.
Last updated 6 minutes ago