# Connect Cursor to Stuff

Use the Stuff plugin to combine files in Stuff with local code and four workflow skills, around the same permissioned MCP tools. [Plugins versus connectors](https://stuff.ac/file/97188272-dea9-4fd2-a368-8ba4212bb97c).

## 1. Install

Download and extract the [coding-agent bundle](https://stuff.ac/file/44c9c784-301c-485d-a6a5-de50be590ee9/raw). Copy its `stuff-ac/plugins/stuff-ac` folder to:

```text
~/.cursor/plugins/local/stuff-ac
```

Review any existing installation before replacing it. Restart Cursor or use **Developer: Reload Window**. Open **Customize** and select the local Stuff plugin.

You should see **one MCP server and four skills**: `handoff`, `local-folder`, `project-context`, and `safe-edit`.

![Actual Cursor Customize screen with the installed Stuff plugin, MCP server and four skills](/api/v1/items/2f261d93-bbb5-42e6-b934-27d40e90f0aa/content)

This is Cursor 3.22. **Needs authentication** is expected before signing in. Cursor can discover plugins from other supported locations too; if multiple Stuff entries appear, inspect their source and use one connection. [Official local-plugin instructions](https://cursor.com/docs/plugins).

## 2. Connect

Choose **Authenticate** next to Stuff's MCP server. In the browser, verify the Stuff account, choose **Only spaces I choose**, select a test space and choose its permissions. Review and approve, then return to Cursor.

![Cursor consent prepared for Project Lantern only](/api/v1/items/3817edda-b177-43ce-a05e-f6d976ddfe18/content)

This real form was opened by the local Cursor plugin, captured before approval. It selects read/write for the fictional Project Lantern space and no sharing-management permission. After approval, Customize showed the connection enabled:

![Cursor connected to Stuff with 63 tools, two resources and four skills](/api/v1/items/176d47ba-2bc1-4da8-8d87-4cd57344a297/content)

Tool counts can change as Stuff develops. An enabled status is the first check; a fresh read is the useful test.

## 3. Try project context

In a new agent chat:

> Use Stuff's project-context skill to read Project Lantern.md. Suggest a launch-page outline using it as context. Give me the source link. Do not edit any files yet.

Then try the [completed three-assistant handoff](https://stuff.ac/file/0eb413e9-22f2-4e84-b8ab-3743cfc851c8). Ask for `safe-edit`, `local-folder` or `handoff` when appropriate.

## MCP-only alternative

For tools without the plugin, merge this into your personal `~/.cursor/mcp.json`, preserving existing entries:

```json
{
  "mcpServers": {
    "stuff": {"url": "https://stuff.ac/mcp"}
  }
}
```

Open **Customize → MCPs** and authenticate. Choose either the plugin's server or a direct server. Keep keys out of shared files. Managed workspaces may restrict local plugins; use an approved configuration rather than bypassing policy.

Cloud Agents have separate configuration. Connecting the IDE does not prove a cloud agent is configured. [Cursor Cloud Agent capabilities](https://cursor.com/docs/cloud-agent/capabilities).

## Disconnect

Disable/uninstall the plugin, remove any separate direct MCP entry, and revoke the matching connection in **Stuff → Agents**. Uninstalling alone does not revoke a credential. [Revocation walkthrough](https://stuff.ac/file/e7263199-8d02-4e17-848b-866b6d44b827).

**Verification, October 1, 2026:** Cursor 3.22 authenticated the local plugin for Project Lantern, loaded safe-edit, read Codex's version 2, appended one line with a version guard, and read version 3 back. After we revoked its Stuff grant, a fresh read returned **Unauthorized**. The [handoff and revocation screenshots](https://stuff.ac/file/0eb413e9-22f2-4e84-b8ab-3743cfc851c8) show the actual chat. This direct-install package has not been approved for Cursor's public marketplace.

[Overview and download checksum](https://stuff.ac/file/97188272-dea9-4fd2-a368-8ba4212bb97c) · [All setup guides](https://stuff.ac/file/552c90a8-384e-4263-b71d-84c30beb2df1)