Docs

MCP Setup Guide

Connect grtwo-docs to Claude.ai or Cursor and publish documents without leaving the conversation.

What it does

The grtwo MCP server lets your AI assistant publish, list, retrieve, update, and delete documents in your grtwo dashboard. All five tools require a Pro or Pro Plus subscription.

Requirements

Pro ($5/mo) or Pro Plus ($15/mo) subscription
MCP server URL (always use www — apex redirects drop auth headers)

https://www.grtwo.app/api/mcp

Connect in Claude.ai

Open Settings → Connectors in claude.ai
Click Add connector (or Add custom MCP server)
Paste the MCP server URL above
Complete OAuth sign-in when prompted — your browser opens to authorize access
Ask Claude to list or publish documents (see example prompts below)

Connect in ChatGPT

ChatGPT discovers MCP servers through the official MCP Registry. grtwo-docs is listed as GRTwo Docs.

Open Settings → MCP connections in ChatGPT
Search for GRTwo Docs (or add the MCP server URL above manually)
Complete OAuth sign-in when prompted — same Pro account as Claude
Ask ChatGPT to list or publish documents (see example prompts below)

Connect in Cursor

Add the server to ~/.cursor/mcp.json. OAuth is recommended — no API key in the file.

Option A — OAuth (recommended)

{
  "mcpServers": {
    "grtwo": {
      "url": "https://www.grtwo.app/api/mcp"
    }
  }
}

Option B — API key

Generate a key on the API keys page, then add it as a Bearer token:

{
  "mcpServers": {
    "grtwo": {
      "url": "https://www.grtwo.app/api/mcp",
      "headers": {
        "Authorization": "Bearer grtwo_YOUR_KEY_HERE"
      }
    }
  }
}

Example prompts

Try these once connected:

“Publish this markdown to grtwo as a public doc titled "Q3 Roadmap"
“Save this HTML to my grtwo dashboard as a private document
“List my grtwo documents

Tools

Tool	Description	Access
publish_document	Publish Markdown or HTML as a public or private document	Write
get_document	Retrieve a document by slug	Read
list_documents	List your documents, newest first	Read
update_document	Update content, type, or title of a document you own	Write
delete_document	Permanently delete a document you own	Delete

Tool hints: read tools use readOnlyHint; write tools use destructiveHint: false; delete uses destructiveHint: true.

Troubleshooting

Unknown client — Claude registers a fresh client_id via /api/oauth/register/ before opening the browser. Remove the connector in Claude, add https://www.grtwo.app/api/mcp again, and complete sign-in in the same browser Claude opens.
Magic link on a different device — OAuth state lives in a short-lived browser cookie. Start the connection on desktop and open the email link on desktop, not on your phone.
After the magic link— you should land on the Allow screen automatically. If you briefly see "Finishing sign-in…", wait a second; do not refresh manually.
Use www — Always add https://www.grtwo.app/api/mcp. The apex domain redirects and can break the OAuth cookie handoff.
Claude Desktop — Add the connector under Settings → Connectors (not claude_desktop_config.json). Claude uses https://claude.ai/api/mcp/auth_callback as the redirect URI.