Connect Gryz MCP in Cursor

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

1. Open Cursor Settings
2. Go to MCP (or Features → MCP depending on your Cursor version)
3. 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"
    }
  }
}

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

Step 3 — Sign in with OAuth

1. Cursor opens a browser window to Gryz
2. Sign in with Google, GitHub, an email code, or password
3. Approve access on the Allow screen
4. 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

Reference

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