Connect Cursor

One click opens Cursor with Gadwal ready to add.

Before you start

  1. Open Gadwal and click AI & MCP in the sidebar of the Connections window (⌘2). The same page is also a tab in Gadwal › Settings (⌘,).
  2. Turn on MCP server. The Address line shows http://127.0.0.1:55183/mcp (you can change the port below it). The server only listens on this Mac.
  3. Check each connection's AI level: Off, Read-only, Ask before write or Full. Production connections start at Read-only. The AI only sees connections that aren't Off. See AI levels and hidden columns.
  4. Keep Gadwal open. The server runs inside the app, so AI tools stop working when you quit it.

AI tools need an active trial or the lifetime unlock. After the trial, turning the server on opens Unlock, and a server that is still running answers every tool call with a message saying so.

In Gadwal

Find the Cursor row under AI Apps on the AI & MCP page. Its button reads Install, and How to connect under it lists the same steps as this page.

The Home window's AI & MCP page in dark mode: a sidebar with Connections, AI & MCP (Off), Backups and Settings, and the page “Connect your AI apps” with the MCP server switch, the address http://127.0.0.1:55183/mcp, port 55183, and AI Apps rows for Claude Desktop (Install), Claude Code (Copy Command), Codex (Copy config.toml Block) and Cursor (Install), each with “How to connect”.
The AI & MCP page (⌘2). Each AI app has a row with its status, its button and “How to connect”.
The Home window's AI & MCP page in light mode: a sidebar with Connections, AI & MCP (Off), Backups and Settings, and the page “Connect your AI apps” with the MCP server switch, the address http://127.0.0.1:55183/mcp, port 55183, and AI Apps rows for Claude Desktop (Install), Claude Code (Copy Command), Codex (Copy config.toml Block) and Cursor (Install), each with “How to connect”.
The AI & MCP page (⌘2). Each AI app has a row with its status, its button and “How to connect”.

Install

  1. On the AI & MCP page, under AI Apps, click Install on the Cursor row.
  2. Gadwal creates a token and opens Cursor with an install link. Cursor shows the gadwal server with its URL and header.
  3. Click Install in Cursor. Cursor writes the server into ~/.cursor/mcp.json.
  4. In Cursor Settings › Tools & MCP, gadwal has a green dot. Then ask the agent about your data.

What Cursor saves

The entry in ~/.cursor/mcp.json looks like this:

"gadwal": {
"url": "http://127.0.0.1:55183/mcp",
"headers": { "Authorization": "Bearer <token>" }
}

If you click Install again later, the button reads Reinstall and sends the current token.