# ThinkReview

**Category:** 🔒 Security  
**Repository:** https://github.com/Thinkode/thinkreview-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/thinkreview

## Description
Live PR/MR code reviews via review_url_code. OAuth or portal Bearer auth.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "thinkreview": {
    "command": "npx",
    "args": ["-y","thinkreview"]
  }
}
```

## Documentation & README

# ThinkReview MCP

Hosted [Model Context Protocol](https://modelcontextprotocol.io) server for **AI code reviews** on pull request and merge request URLs.

Connect **Cursor**, **Claude Code**, **Claude Desktop**, or **GitHub Copilot**, paste a PR/MR URL, and get a structured review — without pasting a diff into chat.

| | |
|---|---|
| **Endpoint** | `https://mcp.thinkreview.dev/v1` |
| **Transport** | Streamable HTTP |
| **Auth** | **OAuth (recommended)** or Bearer token |
| **Registry** | [`io.github.Thinkode/thinkreview`](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Thinkode%2Fthinkreview/versions/latest) |
| **Product** | [thinkreview.dev/features/mcp](https://thinkreview.dev/features/mcp) |
| **Docs** | [thinkreview.dev/docs/mcp-integration](https://thinkreview.dev/docs/mcp-integration/) |
| **Setup** | [portal.thinkreview.dev/mcp](https://portal.thinkreview.dev/mcp) |

> This repository is for **visibility and client documentation**. ThinkReview MCP runs as a **remote hosted server**. The review engine, auth, billing, and git integrations stay on ThinkReview infrastructure and are not published here.

---

## What it does

ThinkReview MCP exposes one tool:

### `review_url_code`

Run a live code review on a GitHub, GitLab, Azure DevOps, or Bitbucket PR/MR URL.

ThinkReview fetches changed files through your **stored git credentials** (portal Integrations) and returns a structured review: summary, suggestions, security notes, best practices, and suggested follow-up questions.

| Parameter | Required | Description |
|---|---|---|
| `prUrl` | Yes | Full or domain-style PR/MR URL (e.g. `https://github.com/org/repo/pull/42`) |
| `language` | No | Response language (default: English) |
| `mrId` | No | Optional tracking ID for your workflow |
| `forceRegenerate` | No | `true` to bypass cache and force a new review |

URL reviews use the **same review credits** as the ThinkReview browser extension.

---

## Authentication

Choose one method. Interactive configs for both are on [portal.thinkreview.dev/mcp](https://portal.thinkreview.dev/mcp).

| Method | How it works | Best for |
|---|---|---|
| **OAuth (recommended)** | URL-only MCP config → **Authenticate** in the browser on the ThinkReview portal | Cursor, Claude Code, Claude Desktop, Copilot |
| **Bearer token** | Long-lived portal token in `Authorization: Bearer <token>` headers | Extension, CI, or clients that cannot complete OAuth |

OAuth sessions are **separate** from the extension Bearer token. Regenerating the Bearer token does **not** revoke OAuth MCP sessions.

---

## Prerequisites

1. A [ThinkReview](https://thinkreview.dev) account with an active plan or available review credits
2. Git credentials under **Settings → Integrations** for the host of the PR you want to review
3. An MCP client that supports **Streamable HTTP**, plus either:
   - **OAuth** for remote HTTP servers, or
   - A Bearer token from [portal.thinkreview.dev/mcp](https://portal.thinkreview.dev/mcp)

---

## Quick start — OAuth (recommended)

Add a **URL-only** config, then **Authenticate** in your client (browser opens the ThinkReview portal).

### Cursor

```json
{
  "mcpServers": {
    "thinkreview": {
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}
```

Enable **thinkreview**, click **Authenticate**, complete portal consent.  
Example: [`examples/oauth/cursor.mcp.json`](examples/oauth/cursor.mcp.json)

### Claude Code

CLI:

```bash
claude mcp add --transport http thinkreview https://mcp.thinkreview.dev/v1
```

![Add ThinkReview MCP with Claude Code CLI](docs/claude-code-setup/01-claude-code-mcp-add.png)

Or config (`~/.claude.json` / project `.mcp.json`):

```json
{
  "mcpServers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}
```

Example: [`examples/oauth/claude.mcp.json`](examples/oauth/claude.mcp.json)

#### Authenticate (OAuth)

1. Start Claude Code and run `/mcp`.

![Open /mcp in Claude Code](docs/claude-code-setup/02-claude-code-open-mcp.png)

2. Select **thinkreview** — status shows **needs authentication**.

![thinkreview needs authentication](docs/claude-code-setup/03-claude-code-needs-auth.png)

3. Choose **Authenticate**.

![Select Authenticate](docs/claude-code-setup/04-claude-code-authenticate.png)

4. Claude Code opens the browser OAuth flow (`/authorize` → portal consent).

![Browser OAuth URL in Claude Code](docs/claude-code-setup/05-claude-code-browser-oauth.png)

![Authorize ThinkReview MCP on the portal](docs/claude-code-setup/06-portal-oauth-consent.png)

5. After you click **Allow**, return to Claude Code — you should see **Authentication successful**.

![Authentication successful](docs/claude-code-setup/07-claude-code-auth-success.png)

#### Run a review

Ask Claude Code to review a PR URL (tool: `review_url_code`):

![Invoke review_url_code](docs/claude-code-setup/08-claude-code-review-tool.png)

![Example review result](docs/claude-code-setup/09-claude-code-review-result.png)

### Claude Desktop

**Preferred:** Settings → **Connectors** → Add custom connector → `https://mcp.thinkreview.dev/v1` → Connect → complete portal OAuth.

Claude Desktop’s `claude_desktop_config.json` does **not** accept Claude Code’s `"type": "http"` block. To use the config file instead, bridge with `mcp-remote` (requires Node.js), then fully quit and reopen Desktop:

```json
{
  "mcpServers": {
    "thinkreview": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.thinkreview.dev/v1"]
    }
  }
}
```

![claude_desktop_config.json with mcp-remote](docs/claude-code-setup/10-claude-desktop-config.png)

After restart, Settings → Developer → Local MCP servers should show **thinkreview** as **running**. Complete OAuth when prompted (same portal consent as Claude Code).

![thinkreview running in Claude Desktop](docs/claude-code-setup/11-claude-desktop-running.png)

Example: [`examples/oauth/claude-desktop.mcp.json`](examples/oauth/claude-desktop.mcp.json)

### GitHub Copilot (VS Code)

`.vscode/mcp.json` or user MCP config (`servers` key):

```json
{
  "servers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1"
    }
  }
}
```

Use **Auth / Authenticate** on the thinkreview server, then enable it in Copilot Chat.  
Example: [`examples/oauth/vscode-copilot.mcp.json`](examples/oauth/vscode-copilot.mcp.json)

### Example prompt

> Call `review_url_code` for https://github.com/org/repo/pull/123

---

## Alternative — Bearer token

Copy your token from [portal.thinkreview.dev/mcp](https://portal.thinkreview.dev/mcp) and add it as a header. Same session token as the browser extension. Regenerating invalidates the previous token for extension and Bearer-based MCP clients.

### Cursor

```json
{
  "mcpServers": {
    "thinkreview": {
      "url": "https://mcp.thinkreview.dev/v1",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

Example: [`examples/bearer/cursor.mcp.json`](examples/bearer/cursor.mcp.json)

### Claude Code

```bash
claude mcp add --transport http thinkreview https://mcp.thinkreview.dev/v1 \
  --header "Authorization: Bearer <your-token>"
```

```json
{
  "mcpServers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

Example: [`examples/bearer/claude.mcp.json`](examples/bearer/claude.mcp.json)

### Claude Desktop (`mcp-remote` + header)

```json
{
  "mcpServers": {
    "thinkreview": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.thinkreview.dev/v1",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your-token>"
      }
    }
  }
}
```

Example: [`examples/bearer/claude-desktop.mcp.json`](examples/bearer/claude-desktop.mcp.json)

### GitHub Copilot (VS Code)

```json
{
  "servers": {
    "thinkreview": {
      "type": "http",
      "url": "https://mcp.thinkreview.dev/v1",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
```

Example: [`examples/bearer/vscode-copilot.mcp.json`](examples/bearer/vscode-copilot.mcp.json)

---

## Supported platforms

Same hosts as the ThinkReview extension:

- GitHub.com and GitHub Enterprise Server
- GitLab.com and self-managed GitLab
- Azure DevOps Cloud and on-premise
- Bitbucket Cloud and Bitbucket Data Center

---

## Security

- Prefer **OAuth** so long-lived tokens are not stored in MCP config files
- If you use a Bearer token, treat it like a password — do not commit it to git
- Store tokens only in local MCP client config or a secrets manager
- Regenerate the Bearer token from the portal if it is ever exposed
- Use git PATs with the minimum scopes needed to read PRs/MRs and diffs

---

## Related

- [Browser extension (open source)](https://github.com/Thinkode/thinkreview-browser-extension)
- [MCP product page](https://thinkreview.dev/features/mcp)
- [Full integration docs](https://thinkreview.dev/docs/mcp-integration/)
- [Support / contact](https://thinkreview.dev/contact)
- [Feedback](https://thinkreview.dev/feedback)

---

## License

Documentation and example configs in this repository are licensed under the [MIT License](LICENSE).

The ThinkReview hosted MCP service, APIs, and review infrastructure remain proprietary to Thinkode / ThinkReview.