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 draftrelayThe 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 listConfirm 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 listand add the URL again if the label is missing. - Login is required
- Run
codex mcp login draftrelayand 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.