Connect Codex

Connect Codex to Vocci from a local development environment.

Setup

Before you start, make sure the Codex CLI is installed and available in your terminal.

Add the remote MCP server:

codex mcp add vocci --url https://mcp.vocci.ai/mcp

Codex behavior varies by version. If mcp add opens the browser OAuth flow, complete it and do not run mcp login again. If mcp add returns without opening OAuth, start the flow manually:

codex mcp login vocci --scopes "profile,offline_access,email"

Vocci production advertises Dynamic Client Registration, so these commands do not need an OAuth client ID. Do not add --oauth-resource unless your Codex build fails to send the discovered MCP resource; when both discovery and the flag add resource, Clerk rejects the authorize request as malformed.

--oauth-resource is saved on the MCP server entry. Leaving the flag off a later command does not remove an older saved value. For a full reset, clear the stored credential while the entry still exists, then recreate the entry without the flag:

codex mcp logout vocci
codex mcp remove vocci
codex mcp add vocci --url https://mcp.vocci.ai/mcp

If logout reports that no credential is stored, continue with remove. After re-adding the entry, complete OAuth if mcp add opens it. Otherwise run codex mcp login vocci --scopes "profile,offline_access,email".

A newly named Vocci entry working while an older entry fails with duplicate resource is a strong signal that the older entry retained this override.

Complete the Vocci sign-in flow opened by either command. Restart Codex if available tools do not refresh right away.

note

Use OAuth through the browser. Do not paste browser session values, authorization headers, or raw user content into Codex configuration.

Verify Installation

Your setup should now be complete when:

• Codex lists a vocci MCP server.
• Vocci tools are available after authorization.
• A non-sensitive Vocci request returns recent sessions with titles, summaries, and source IDs.

Try:

List my recent Vocci sessions and summarize them

If a returned session looks useful, you can open it for more detail.

Troubleshooting

If Codex asks for additional OAuth configuration, first update Codex and try the command again so it can use the discovered registration endpoint. Do not paste browser session values into Codex configuration.