Codex setup

Configure OpenAI Codex to interact with AWF Cloud workspaces.

coming soonDynamic client registration for Codex is not yet available in production. Use API key authentication as a fallback until DCR is enabled.

MCP integration

Add AWF Cloud as an MCP server in your Codex configuration (~/.codex/config.toml):

[mcp_servers.awf-cloud]
url = "<api-base-url>/v1/orgs/{org_id}/projects/{project_id}/mcp"
bearer_token_env_var = "AWF_CLOUD_API_KEY"

Replace {org_id} and {project_id} with your organization and project identifiers.

REST integration

Use the AWF Cloud REST API directly from Codex by configuring the base URL and authentication headers.

# Example: list projects
curl -s \
  -H "Authorization: Bearer $AWF_CLOUD_API_KEY" \
  -H "X-AWF-Org-ID: <your-org-id>" \
  -H "X-AWF-Project-ID: <your-project-id>" \
  "<api-base-url>/v1/orgs/<your-org-id>/projects"

API key setup

  1. Navigate to the Account page in the AWF Cloud console.
  2. Select the API Keys tab and create a new key with mcp:read and the domain read scopes you need (e.g. workspace:read, project:read) to expose MCP tools and REST endpoints.
  3. Copy the key value — it is shown only once and cannot be recovered.
  4. Set the key as the AWF_CLOUD_API_KEY environment variable so Codex can read it via bearer_token_env_var in the config above.

Other providers

The following providers are not yet supported:

ollamagrokcursorgemini