MCP
Cursor Agent can pass MCP server configuration into ACP session/new / session/load so the Agent sees the same class of tools you use in Cursor.
Prefer Burp MCP
For Burp work (proxy history, Repeater, Scanner hooks, and so on), use Cursor’s existing Burp MCP instead of re-implementing Burp APIs inside this extension. Point the Agent at that server and keep the extension focused on chat host concerns (sessions, permissions, Rules/Memories, launch).
Two modes (Settings → MCP)
MCP source chooses how servers are supplied:
| Mode | Behavior |
|---|---|
| Own list (editable) | Create/edit servers in Settings (list UI or Edit JSON). That list is what ACP receives. |
| Link Cursor MCP (read-only) | Read Cursor’s MCP config for the active launch profile only — user mcp.json plus project .cursor/mcp.json under session cwd. |
Link mode does not merge Windows and Linux MCP files. Switching WSL ↔ Native in Settings changes which files are read.
| Launch profile | Global MCP | Project MCP |
|---|---|---|
| WSL (Windows Burp) | Linux ~/.cursor/mcp.json (agent home) | Linux .cursor/mcp.json under session cwd |
| Native (Windows) | %USERPROFILE%\.cursor\mcp.json | Windows project under session cwd |
| Native (Linux / macOS) | Host ~/.cursor/mcp.json | Host project under session cwd |
Session cwd must match the profile (Linux paths for WSL, Windows paths for Windows Native). Project entries override the same server names from the user file.
Own list JSON
Use a JSON array of server objects in the shape Cursor / ACP expect (name, command or URL, env, etc.). Empty array = no MCP servers from the extension.
Invalid JSON is blocked on Save. Secrets belong in env files / OS env, not in chat transcripts.
Tips
- After changing MCP settings or launch profile, start a new chat (or clear ACP linkage) if an old session was created without those servers.
- Linking Cursor does not copy IDE Composer chats — only MCP server definitions.
- Extension built-in note helpers (
burpai-rule/*,burpai-memory/*,burpai-rename) are separate from MCP; see Settings → Tools and rules-and-memories.md.