Getting Started with Codex

First, create your Open Source Cloud account. Navigate to the OSC console:

Enter your email address and click continue. Check your inbox for a verification code, then enter the code to verify your account.

After verifying your email, you'll be prompted to create a team. Teams are how OSC organizes your services and resources.

Enter a team name (e.g., your company name or project name) and click the Create Team button.

Navigate to Settings → API in the OSC console to find your Personal Access Token (PAT). This token allows Codex to authenticate with OSC on your behalf.

Copy your Personal Access Token from this page.

Codex is OpenAI's CLI tool for AI-assisted development. Install it using npm:

npm install -g @openai/codex

After installation, verify it works by running codex --version

Create or edit your Codex configuration file to add OSC as an MCP server. The configuration file is located at ~/.codex/config.toml

Add the following configuration, replacing <YOUR_PERSONAL_ACCESS_TOKEN> with the token you generated:

[mcp_servers.osc]
type = "http"
url = "https://ai.svc.prod.osaas.io/mcp"

[mcp_servers.osc.headers]
Authorization = "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"

Launch Codex in your terminal. It will automatically load the MCP configuration:

codex

Codex will now have access to all OSC tools and can help you manage open source services.

Now you're ready to create your first service! Ask Codex in natural language:

> Create a MySQL database for me

Codex will use the OSC MCP tools to provision a MySQL instance. Once complete, ask for the connection details:

> What is the IP and port to the database?

Codex will provide you with the host, port, username, and password needed to connect.