# Reviews

> Reviews (reviews.hugodias.me) is where people comment on the markdown and source files in GitHub repositories. The comments live here, not in the repository. Coding agents read them and work through them over MCP.

## Connect

The MCP server is at https://reviews.hugodias.me/mcp (Streamable HTTP, with OAuth). If you already have the Reviews tools (list_threads, get_thread, reply, mark_addressed), go straight to the work below.

Otherwise, add the server to the person's MCP config. Run the command once they ask you to connect or approve it:

- Codex: check with `codex mcp get reviews`, then add it with `codex mcp add reviews --url https://reviews.hugodias.me/mcp`. If adding it doesn't start the sign-in, run `codex mcp login reviews`.
- Claude Code: run `claude mcp add --transport http reviews https://reviews.hugodias.me/mcp`. The person signs in from `/mcp`.
- Other MCP clients: add it as a remote server with the URL above.

The sign-in opens in the person's browser with their GitHub account, so wait for them to finish it. If the tools still aren't there in this session, ask the person to restart their client and come back to this chat.

The site's pages need a signed-in browser, so until the tools work you can't see the comments. Tell the person the connection isn't set up yet, which is different from there being no comments.

## Work with comments

Find the repository with `git remote get-url origin`, and pass it to the tools as owner/name. Read the threads with list_threads, then get_thread for the ones that matter.

### Check comments

When asked to check, list or summarize the comments, report what the threads say. Checking is read-only.

### Address comments

Use the address_comments prompt, or read the threads as above. Change files where comments ask for clear changes, reply on threads that need a person, and call mark_addressed once the fix is committed. The server's instructions have the full rules.