Connect Claude Code to Shotline

1. 1. Add the MCP server

   Run this in your project directory:

   claude mcp add --transport http shotline https://getshotline.com/api/mcp

   No token to copy. The first tool call opens a browser login: sign in, pick this project, and you’re connected.

2. Alternative: token auth (CI / headless)

   No browser available? Open your project in Shotline, find the Agents card, and click Invite an agent. Name it (e.g. “Claude Code”) and Shotline generates a token, then shows you this command with it already filled in:

   claude mcp add --transport http shotline https://getshotline.com/api/mcp \
     --header "Authorization: Bearer <agent_token>"

3. 2. Start the loop

   In a Claude Code session, ask it to work Shotline for this project. It calls get_workflow first to get the recommended loop, then list_feedback or create_canvas to open a review link. wait_for_feedback long-polls up to 90 seconds and returns events: new_feedback for a new pin, new_reply when someone replies in a thread, and review_done when you tap “Done reviewing” on the canvas. The agent fixes, pulls the pin with get_feedback, posts proof with post_fix_note, and loops back with next_cursor until you end the session.

Optional: install the /shotline-review skill

Drop a ready-made skill into your project so Claude Code runs the whole review loop (connect, get_workflow, create_canvas, wait_for_feedback) without being told each step.

mkdir -p .claude/skills/shotline-review
curl -o .claude/skills/shotline-review/SKILL.md https://getshotline.com/skills/shotline-review.md

Raw file: /skills/shotline-review.md