Integration · Codex

Move the finished Codex result out of scrollback

DraftRelay gives Codex a focused MCP handoff: the agent saves one polished artifact and returns a browser receipt, while you review and copy the destination version you need.

01Add

Register the URL, then start the OAuth login.

Run in a terminal

codex mcp add draftrelay --url https://draftrelay.onrender.com/mcp
codex mcp login draftrelay

The first command records a remote MCP server named draftrelay. The second starts the authorization flow. Sign in through the browser, inspect the requested output scopes, and approve only if the hostname and application are the ones you expect.

02Verify

Check the configured server before relying on it.

List Codex MCP servers

codex mcp list

Confirm that draftrelay points to https://draftrelay.onrender.com/mcp. In a Codex session, ask the agent to list the DraftRelay tools or save a harmless test note. A successful save returns an item ID, revision, lifecycle status, and review URL.

03Use

Make the handoff part of the finish condition.

Implement and verify the change. When the work is complete, save one DraftRelay PR description under the Payments project with summary, test plan, risk, branch, commit, and referenced files. Do not save command output or the conversation.

Putting the save after verification helps the artifact reflect the actual outcome instead of an early plan. If verification is partial or failed, ask Codex to say that plainly in both the copy and provenance rather than presenting an unverified result as complete.

04Troubleshoot

Separate registration, authentication, and policy failures.

The server is absent
Run codex mcp list and add the URL again if the label is missing.
Login is required
Run codex mcp login draftrelay and complete the browser flow.
A tool lacks permission
Reconnect and approve the required read, write, or use scope.
A save is rejected
Read the returned validation, quota, or redacted secret-policy error; do not retry unchanged content indefinitely.
Copy is blocked
Open the review URL and satisfy the project’s review or acknowledgement policy.

05Disconnect

Revoke access when the client should stop using the inbox.

Remove the Codex MCP registration with the Codex CLI and revoke its OAuth connection from DraftRelay account settings. A revoked connection loses its access and refresh credentials; reconnecting requires a new authorization.