Connect Codex CLI

Add Acquisity to Codex from your terminal with an API key.

Looking for the app you open from your desktop? Use Connect Codex desktop. This page is for people already using the codex terminal command.

1. Create a read-only key

Create a workspace API key with workspaces:read and campaigns:read.

2. Set the key in your terminal

Replace the placeholder with your complete key. Keep this terminal and its history private.

macOS or Linux:

export ACQUISITY_API_KEY="YOUR_ACQUISITY_API_KEY"

Windows PowerShell:

$env:ACQUISITY_API_KEY = "YOUR_ACQUISITY_API_KEY"

This sets the key for the current terminal session. It is not automatically available to the desktop app or a new terminal.

3. Add the server

codex mcp add acquisity --url https://api.acquisity.ai/mcp --bearer-token-env-var ACQUISITY_API_KEY

Then check that it is listed:

codex mcp list

This saves the server's address and the variable name, not the key itself. Start codex from the same terminal. Use /mcp inside Codex to inspect its connection.

Do not run codex mcp login acquisity: that command is for OAuth sign-in, while this connection uses your API key.

4. Try your first request

Use Acquisity to list my workspaces. Ask me which one to use, then list its campaigns. Do not change anything.

The assistant should return workspace names and campaign information. If the key is missing after opening a new terminal, set the variable again before starting Codex.

Disconnect

codex mcp remove acquisity

The CLI and desktop app share local MCP settings. Removing this server also removes it from that shared configuration. Revoke the key in Acquisity if it should stop working everywhere.

Choose permissions or fix a connection error.

Reference: OpenAI's MCP guide.