Connect Codex to Shotline

Pull client feedback, ship the fix, post proof — in about 2 minutes.

  1. 1. Get your agent token

    Open your project in Shotline, find the Agents card, and click Invite an agent. Name it (e.g. “Codex”) and Shotline generates a token, then shows you the exact config below with it already filled in.

  2. 2. Add the MCP server

    Add to ~/.codex/config.toml:

    [mcp_servers.shotline]
    url = "https://getshotline.com/api/mcp"
    http_headers = { "Authorization" = "Bearer <agent_token>" }

    OAuth login is supported where Codex’s MCP client supports it: drop http_headers and the first tool call prompts you to sign in and pick a project.

  3. 3. Start working the queue

    Restart Codex, then ask it to check Shotline for open feedback on this project. It calls get_workflow for the recommended loop, then list_feedback, pulls the selector/screenshot/thread with get_feedback, ships the fix, and posts proof back with post_fix_note.

What Codex can do

Read

  • get_workflow
  • list_feedback
  • get_feedback
  • get_project_summary
  • get_project_context
  • get_page_context
  • get_approvals

Triage

  • update_status
  • add_comment
  • ask_clarification
  • set_priority
  • set_assignee
  • set_tags

Close the loop

  • recapture
  • post_fix_note

Give your agent the whole loop.

Free on every plan.

Start free
Shotline — Connect Codex to Shotline