Add to Cursor

Cursor supports MCP via its agent feature. Configuration is a JSON file in your home directory — same auth model as Claude Desktop, but you paste the config manually.

Install

Open ~/.cursor/mcp.json in any editor (create the file if it doesn’t exist).
Paste:

{
  "mcpServers": {
    "picora": {
      "url": "https://mcp.picora.me",
      "auth": {
        "type": "oauth",
        "authorizationUrl": "https://api.picora.me/oauth/authorize",
        "tokenUrl":         "https://api.picora.me/oauth/token",
        "scopes": [
          "media.read", "media.write",
          "kb.read",    "kb.write",
          "account.read", "usage.read"
        ]
      }
    }
  }
}

Restart Cursor.
Open the agent panel and ask “what can you do with Picora?” — Cursor will run picora.help and list capabilities.
The first non-public tool call kicks off OAuth in your default browser. Approve once.

Recommended scope sets

Use case	Scopes
Save screenshots into a project KB	`media.write`, `kb.write`, `media.read`, `kb.read`
Browse-only research agent	`media.read`, `kb.read`, `account.read`, `usage.read`
Full-stack creator workflow	All read + write + Pro plan for video

China deployment

Replace mcp.picora.me and the two OAuth URLs with their .cn counterparts. The two regions are independently authenticated.

Troubleshooting

Cursor doesn’t show Picora tools after restart. Check ~/.cursor/mcp.json is valid JSON (jq . ~/.cursor/mcp.json should print without errors).
OAuth window opens but never returns. Sign in to center.picora.me first in the same browser; if you have multiple Picora accounts, pick the right one before approving.
MCP_TOOL_NOT_FOUND for a tool you expected. Check the live catalog at api.picora.me/mcp/tools.json — the tool may have been deprecated and removed. Look for a replaceWith field in the error.