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 --oauth-resource https://mcp.vocci.ai/mcp

Adding the server should open the OAuth sign-in flow automatically. Complete the Vocci sign-in flow in the browser. After the login finishes, 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 narrow, non-sensitive Vocci search returns results with titles, snippets, and source IDs.

Try:

Search Vocci for recent notes about onboarding.

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

Troubleshooting

If Codex asks for additional OAuth configuration, use the OAuth values provided by Vocci for the public MCP server. Do not paste browser session values into Codex configuration.