PR Studio
Connect a coding agent
Connect Codex or Claude Code to PR Studio so your agent can add before and after evidence to Cases. You review the comparison in PR Studio before the agent publishes it.
On macOS 14 or later, use PR Studio with Codex or Claude Code on the same Mac.
1. Choose a shared folder
In PR Studio, click Connect an Agent on Home or open Settings → Coding Agents. Click Choose Folder… and choose a local folder your agent can access. PR Studio remembers this folder and keeps its Cases data inside it.
2. Connect your agent
In PR Studio, click Copy Setup Prompt and paste it into a local Codex or Claude Code session on this Mac. The prompt tells your agent which shared folder to use. It can reuse the helper you selected in PR Studio or install it with your approval.
When your agent finishes, go to Check the connection. To configure it yourself, follow the manual steps below.
Download and choose the helper
Download MCP helper ZIP
The helper is signed and notarized for Apple silicon and Intel Macs.
- In Finder, open the downloaded ZIP to extract
prstudio-mcp.
- Move the helper into a folder you plan to keep. For example, in Finder select Go → Home and create a folder called PR Studio MCP.
- Return to Coding Agents in PR Studio. Click Choose Helper… and select the extracted
prstudio-mcp file. After registration, your coding agent starts the helper automatically.
Register the helper
Codex desktop
In the ChatGPT desktop app, open Settings → MCP servers → Add Server. Name the server prstudio and choose STDIO.
For Command, paste the full path displayed below Choose Helper… in PR Studio’s Install the helper step. Add two separate arguments in this order.
--cases-directory
- The full folder path displayed in step 1 of Coding Agents.
Save, then select Restart. For Codex CLI, select Codex in step 3 of Coding Agents and copy its command. Run it in Terminal and start a fresh Codex session.
Claude Code
Select Claude Code in step 3 of Coding Agents and copy its command. Run it in Terminal to register the selected helper and Cases folder for all your projects.
Restart Claude Code and use /mcp to check that prstudio is connected.
3. Check the connection
Restart your client after saving its settings. In a fresh session, ask it to list PR Studio Cases with find_cases. A folder with no cases returns an empty list. Check the connection status at the top of Coding Agents in PR Studio.
For your first comparison, copy the task prompt under Teach your agent the routine and give it to your agent before it edits code.
For publishing approved Cases to GitHub, the agent also needs GitHub CLI 2.99 or later signed in to an account with access to the pull request.
Troubleshooting
- If Finder shows “prstudio-mcp” Not Opened after you double-click the extracted file, choose Done. In PR Studio, use Choose Helper… to select the file and finish registering your agent. Apple’s Gatekeeper guidance for command-line tools
- If you move the helper or change the shared folder, select the new path in PR Studio, update the
prstudio server, and restart your client.
- If the server already exists, edit that entry instead of adding another. In Claude Code, a project’s local registration can take precedence over the entry for all your projects. Update the local entry or remove it with
claude mcp remove prstudio --scope local from that project.
- If Cases differ between the app and your agent, check that the registration uses the same shared folder shown in Coding Agents.