How to use Thinkr from Claude, ChatGPT, Cursor, and other AI tools

Thinkr works as an MCP server, so an AI assistant can read your PRDs and run Thinkr's critique on your behalf. There are two ways to connect, depending on the tool:

Tool	How it connects
claude.ai (web and desktop), ChatGPT	Sign in to Thinkr. No token.
Claude Code	Sign in to Thinkr, or use a token
Cursor, Antigravity, GitHub Copilot, other MCP clients	A token

Before you start

Your workspace needs to be on Solo, Team, or Enterprise. Free workspaces show up when you sign in, but you can't pick them, and the Connect via MCP card on Integrations shows See plans instead of Create a token.

Connect from claude.ai

1. In Claude, go to Customize → Connectors and click Add custom connector. On a Claude Team or Enterprise plan, an Owner adds it instead, under Organization settings → Connectors → Add → Custom, and then each member clicks Connect.
2. Enter https://app.usethinkr.com/mcp as the server URL. If Claude asks how it should identify itself, choose Use Claude's published identity. Thinkr doesn't support Register automatically.
3. Click Add, then Connect. Claude opens Thinkr's sign-in page.
4. Pick the workspace Claude should work in, check what it will be able to do, and click Allow. You're sent back to Claude.

In a chat, Thinkr is under + → Connectors, where you can turn it on or off for that conversation.

Connect from ChatGPT

ChatGPT connects through Developer mode, on the web, on Plus, Pro, Business, Enterprise, and Edu plans. On Business, Enterprise, and Edu, a workspace admin may need to allow it first.

1. In ChatGPT, open Settings → Security and login and turn on Developer mode.
2. Open Settings → Plugins and click + to create an app. Name it Thinkr, enter https://app.usethinkr.com/mcp as the MCP server URL, and choose OAuth for authentication.
3. ChatGPT opens Thinkr's sign-in page. Pick the workspace and click Allow.
4. In a chat, turn Thinkr on from the composer's Developer mode tools.

Connect from Claude Code

Add the server without a token, then sign in:

claude mcp add --transport http thinkr https://app.usethinkr.com/mcp

In Claude Code, run /mcp, select thinkr, and follow the steps in your browser. You can also run claude mcp login thinkr from your terminal. Claude Code keeps the connection signed in and refreshes it on its own.

Prefer a token? Use the steps in the next section and the Claude Code command shown there.

What the sign-in page shows

When an app connects by signing in, Thinkr shows you, before anything is shared:

• Which app is asking, and the site it comes from. claude.ai and chatgpt.com are marked Verified. Anything else is marked Unverified: only continue if you started the connection yourself.
• What it will be able to do: read the PRDs and critiques in the workspace you pick, and run critiques, which count toward that workspace's usage. It can't edit or delete anything.
• The workspace. Each connection works in one workspace. To use another, connect again and pick it.
• Where you'll go back to once you decide.

A sign-in request lasts 10 minutes. If it expires, start again from the app.

Connect with a token

For Cursor, Antigravity, GitHub Copilot, and any other client that sends a custom header, create a token and paste it into the client's setup.

Step 1, Create a token

Open Integrations from the sidebar. Under Use Thinkr from your AI tools, click Create a token on the Connect via MCP card.

Fill in the dialog:

• Token name, something you'll recognise later, like Cursor on my laptop.
• Workspace, the workspace this token works in. It can only see that workspace's PRDs and critiques, and any critique it runs counts against that workspace's usage.
• Expires, 30 days, 90 days, 1 year, or never. 90 days is the default.

Click Create token. Thinkr shows the token once. Copy it now, because Thinkr only keeps a hash and can't show it again. If you lose it, revoke it and create a new one.

Step 2, Add Thinkr to your client

Right below the token, pick your client and copy the setup. It already has your token filled in.

Claude Code: run the command in your terminal.

claude mcp add --transport http thinkr https://app.usethinkr.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor: add this to ~/.cursor/mcp.json, or merge it into your existing mcpServers.

{
  "mcpServers": {
    "thinkr": {
      "url": "https://app.usethinkr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Antigravity: in the agent panel, open … → MCP Servers → Manage MCP Servers → View raw config, then merge this into mcpServers. Antigravity only reads serverUrl, so the Cursor setup (which uses url) won't connect here.

{
  "mcpServers": {
    "thinkr": {
      "serverUrl": "https://app.usethinkr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

GitHub Copilot (VS Code): run MCP: Open User Configuration from the Command Palette and merge this into servers. Copilot picks it up in agent mode.

{
  "servers": {
    "thinkr": {
      "type": "http",
      "url": "https://app.usethinkr.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Use your user configuration rather than a .vscode/mcp.json in a repository, so the token doesn't get committed with your code.

Other clients: point them at https://app.usethinkr.com/mcp with the header Authorization: Bearer YOUR_TOKEN.

Ask your assistant

Thinkr gives your assistant five tools: list_prds, get_prd, critique_prd, get_critique, and list_critiques. You don't call them by name. Just ask:

• "List my Thinkr PRDs about checkout."
• "Critique the Checkout redesign PRD with Thinkr."
• "Run a Thinkr critique on the PRD in this file, then fix the high-severity findings."
• "Critique this Notion page with Thinkr: https://www.notion.so/…" Thinkr reads it through your own Notion connection, so connect Notion and share the page with Thinkr first.

A critique takes a few minutes. The assistant starts it, then checks back until it's done, and gets the 0–100 score, the readiness band, and the findings ordered by severity. The full pass-by-pass review is always one click away in Thinkr; every result includes a link.

Each person can have two MCP critiques running at once. If your assistant tries to start a third, Thinkr asks it to wait for one to finish.

Manage access

• Apps you signed in to are under Settings → Connected apps, with the workspace each one uses and when it was last used. Disconnect stops that app right away. To remove it from the app's side too, delete the connector in Claude or ChatGPT.
• Tokens are on Integrations: click Manage tokens to see each one's workspace, last use, and expiry. Revoke cuts off every client using that token immediately.
• Both follow workspace membership. If you're removed from a workspace, your tokens and connected apps for it stop working on the next call, with nothing to clean up.

If signing in doesn't work

• "This connection can't continue": Thinkr couldn't verify the app, or the app asked to send you somewhere it hasn't registered. In claude.ai, remove the connector and add it again with Use Claude's published identity.
• "This request has expired": you took more than 10 minutes, or the request was already used. Start again from the app.
• Your workspace is greyed out: its plan doesn't include connected apps. They're on Solo and above.
• A client that only supports automatic registration can't sign in to Thinkr yet. Use a token instead.

Ready to try it? Open Thinkr and click Integrations, or add the connector in Claude or ChatGPT.