Complete written walkthrough for adding the Gryz MCP server to Cursor with OAuth, copyable config, troubleshooting, and an optional video demo.

Before you start

You need a free Gryz account and Cursor with MCP enabled. This guide is complete on its own — follow every step below even if you skip the video.

Watch the full video on YouTube: Connect Gryz MCP in Cursor.

Prerequisites

Gryz account (sign up)
Cursor desktop (MCP support)
MCP server URL (always use www):

https://www.gryz.ai/api/mcp/

Step 1 — Open MCP settings in Cursor

Open Cursor Settings
Go to MCP (or Features → MCP depending on your Cursor version)
Choose Add MCP server or edit ~/.cursor/mcp.json manually

Step 2 — Add OAuth config (recommended)

OAuth avoids storing an API key on disk. Add this block:

{
  "mcpServers": {
    "gryz": {
      "url": "https://www.gryz.ai/api/mcp/"
    }
  }
}

One-click install

Opens Cursor and adds the Gryz MCP server automatically. You will still complete OAuth in your browser afterward.

Add to Cursor View the plugin on GitHub →

Legacy URL still works if already configured: https://www.grtwo.app/api/mcp

Save the file and restart Cursor if it does not pick up the change immediately.

Cursor opens a browser window to Gryz
Sign in with Google, GitHub, magic link, or password
Approve access on the Allow screen
Return to Cursor — the server should show as connected

Step 4 — API key alternative

If OAuth is unavailable in your environment, generate a key on the API keys page:

{
  "mcpServers": {
    "gryz": {
      "url": "https://www.gryz.ai/api/mcp/",
      "headers": {
        "Authorization": "Bearer gryz_YOUR_KEY_HERE"
      }
    }
  }
}

Replace gryz_YOUR_KEY_HERE with your key. Never commit this file to git.

Step 5 — Verify the connection

Try these prompts in Cursor:

List my Gryz documents
Publish this markdown to Gryz as a private doc titled "Cursor MCP test"

A successful publish returns a URL in the assistant reply. Open it to confirm the document rendered.

Example prompts

Publish this spec to Gryz as a public doc titled "Q3 roadmap"
Get my Gryz document with slug "q3-roadmap"
Delete my Gryz test document with slug "cursor-mcp-test"

Troubleshooting

Issue	Fix
Unknown client / OAuth error	Remove the Gryz connector, re-add `https://www.gryz.ai/api/mcp/`, complete sign-in in the browser Cursor opens
Magic link on another device	Start OAuth on desktop; open the email link on the same machine
Stuck on "Finishing sign-in…"	Wait a few seconds; do not refresh manually
401 / connection failed	Confirm `www` and trailing slash; apex redirects strip auth headers
Tools not appearing	Restart Cursor after editing `mcp.json`

Reference

For the tools table, ChatGPT and Claude setup, and API details, see the MCP setup reference.

Connect Gryz MCP in Cursor

On this page