Codex Setup

Add Spala Public MCP to Codex and use Spala's authenticated project handoff flow.

Codex Setup

Start Codex with the Spala installer:

pnpm dlx @spala-ai/mcp-install init --client codex --yes --json

Then verify the client setup:

pnpm dlx @spala-ai/mcp-install status --client codex --json

If this running Codex session cannot see the newly installed Public MCP tools, restart Codex or resume this same conversation once. Do not create the project manually in the dashboard. After resume, Codex must call account_status and continue the automated project flow.

Recommended first prompt

Use the configured Spala Public MCP as the discovery entrypoint.
Call spala_get_onboarding and spala_get_tool_map first.
Call account_status. If authentication is required, open the browser and sign in or sign up, then call account_status again.
If account_status reports setup required, ask me one concise question for exactly its missing fields and call account_setup with my real answers. Do not invent placeholders.
Ask for or confidently derive the real project name. Reuse an existing project when available; otherwise create it through the supported Spala project workflow.
Call project_connect exactly once for the project.
Use the returned project connection details to create the workspace-local project MCP, then continue all project work there.
Never construct or hardcode a project MCP URL.

Workflow

Install and check Codex

Run the pnpm dlx @spala-ai/mcp-install init --client codex --yes --json command above, then run pnpm dlx @spala-ai/mcp-install status --client codex --json.

Resume once if tools cannot hot-load

Restart or resume this conversation only when the active Codex process cannot see Public MCP. Continue with account status after resume; do not send the user to create a dashboard project.

Discover and check the account

Ask Codex to call spala_get_onboarding, spala_get_tool_map, and then account_status.

Authenticate only when required

If account_status reports that authentication is required, complete the browser login or signup flow. Call account_status again after the browser flow succeeds.

Complete a new account in the terminal

If account_status reports missing account fields, Codex asks once for exactly those values and calls account_setup. The user does not need to complete onboarding in the dashboard.

Reuse or create a project

Ask for or derive the real project name, then reuse an existing project or create it through the supported workflow. Do not use placeholder names or guess project identity or URLs.

Connect once and bind locally

Call project_connect exactly once. Pass its returned project connection details to the installer so Codex gets a workspace-local project MCP. Keep the connection details and credentials managed by the installer; do not paste them into client configuration.

Build on the project MCP

Use the workspace-local project MCP to inspect the project, make backend changes, validate, publish, and review the result.

Spala Public MCP
/agents/mcp
Endpoint, tools, OAuth metadata, and handoff
Claude Setup
/agents/claude
Claude Code install command
Cursor Setup
/agents/cursor
Cursor MCP configuration