Client feedback straight to Claude Code and Cursor
This guide is for developers and agencies whose clients review a live or staging site. Your client clicks an element and says the change; your coding agent applies it in your repo. Updated 19 November 2026.
What you need
- A PinSay account. The free plan needs no card.
- A web app you can add the widget to.
- An AI coding agent (Claude Code, Cursor, Codex or opencode) running in your repo.
The loop, step by step
- Your client points and says. They click an element on the live or staging site and type or speak the change, in English, Arabic or any language.
- PinSay captures the element. The comment carries the CSS selector, the CSS rules that apply (including the winning rule), the route, the viewport and a sanitized DOM snapshot.
- You ask your agent. In Claude Code, Cursor, Codex or opencode, through the PinSay MCP server or
npx @pinsay/cli apply. - The agent changes your code and commits. Locally, in your repo.
--markmarks the comments applied. - You review and push. Read the diff and push when you are happy.
- The comment goes Live. After your deploy,
npx @pinsay/cli status --deployedturns Applied into Live.
Set up Claude Code
Run this in your terminal. Then in Claude Code run /mcp, choose pinsay, then Authenticate.
claude mcp add --transport http pinsay https://app.pinsay.dev/mcp
To use an API key instead, create one with read and apply permissions and keep it out of git:
claude mcp add --transport http pinsay https://app.pinsay.dev/mcp --header "Authorization: Bearer $PINSAY_API_KEY"
To install the widget and the agent skills in your project, run:
npx @pinsay/cli@latest init
Set up Cursor
Put this in .cursor/mcp.json in your project, or in ~/.cursor/mcp.json for every project. When pinsay first connects, Cursor opens PinSay in your browser: pick the workspace and approve.
{
"mcpServers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp"
}
}
}
Without MCP: the CLI
Run npx @pinsay/cli apply to build the apply prompt for any agent that can run a terminal command.
Run npx @pinsay/cli apply --mark to commit and mark the comments applied.
What PinSay never does
- PinSay does not run your coding agent or edit your code: your agent does, on your machine.
- PinSay never pushes to your remote.
- PinSay never deploys or touches your production servers.
- Your source code is never uploaded: a comment carries only a sanitized snapshot of the page it is pinned to.
Sources
Commands from the PinSay docs (/docs/mcp.html, /docs/apply.html, /docs/deployments.html), checked 19 November 2026.