Cursor and MCP setup

Use MCP so Cursor can search Mintlify component docs, edit your Mintlify site, and (after deploy) search your published documentation.

MCP servers to add

Server	URL	Purpose
Mintlify Admin MCP	`https://mcp.mintlify.com`	Create/edit pages, update `docs.json`, open PRs (OAuth login)
Mintlify platform docs	`https://mintlify.com/docs/mcp`	Look up Mintlify components and configuration while writing
Your published docs	`https://YOUR-SUBDOMAIN.mintlify.app/mcp`	Search your live Student Label System docs (after Mintlify deploy)

Project config (already in this repo)

This repository includes .cursor/mcp.json with the Admin and platform MCP servers preconfigured. Open the project in Cursor and complete OAuth when prompted for mintlify (Admin MCP).

Manual setup in Cursor

Open MCP settings

Press Cmd+Shift+P (Ctrl+Shift+P on Windows) → Open MCP settings → Add custom MCP.

Add servers

Merge the entries from .cursor/mcp.json in this project, or paste:

{
  "mcpServers": {
    "mintlify": {
      "url": "https://mcp.mintlify.com"
    },
    "mintlify-platform": {
      "url": "https://mintlify.com/docs/mcp"
    },
    "student-label-docs": {
      "url": "https://YOUR-SUBDOMAIN.mintlify.app/mcp"
    }
  }
}

Authenticate Admin MCP

Reload Cursor and sign in when mintlify (Admin MCP) requests OAuth. This scopes write access to your Mintlify project.

Install the Mintlify skill

From the repo root:

npm run docs:skill

This installs Mintlify writing guidance for Cursor (components, docs.json, tone).

Test

Ask Cursor: “What MCP tools do you have?” — you should see Mintlify servers listed.

Example prompts for documentation

“Add a new Mintlify page under Storage explaining the 7-year retention policy.”
“Update docs.json to add a Troubleshooting group with a page for printer issues.”
“Search our published docs MCP for how archive box PDFs work and summarize for staff.”

Getting started

Daily workflows

Storage & archive

Admin tools

Reference

Contributors

MCP servers to add

Project config (already in this repo)

Manual setup in Cursor

Example prompts for documentation

References

​MCP servers to add

​Project config (already in this repo)

​Manual setup in Cursor

​Example prompts for documentation

​References

MCP servers to add

Project config (already in this repo)

Manual setup in Cursor

Example prompts for documentation

References