What do you get in Cursor once ConvOps is connected?
Cursor's agent edits code well. ConvOps adds the part that rules files cannot hold: a process with state, checks and approvals that persists across chats and teammates.
- Workflows the agent walks step by step, with the current step's instructions only.
- Gates the engine evaluates; an unmet one is returned to the agent with the reason.
- Approval steps that wait for you before merge or release.
- Team memory and routes, so the agent knows where things live without a long rule file.
ConvOps is the operations layer for AI agents: an MCP server that holds your team's process as workflows, with approval gates, a shared memory and an audit trail. It runs no AI models; Cursor does the work. The steps, gates and decisions come from the ConvOps workflow engine, and the approvals and audit trail from governance.
What do you need to connect Cursor to ConvOps?
A Cursor setup that supports remote MCP servers, a ConvOps account, and the server URL. Plans start free; see pricing for limits.
| You need | Detail |
|---|---|
| Cursor | A version with remote MCP (Streamable HTTP). |
| A ConvOps account | The Free plan works. Sign up at my.convops.app; a first sign-in without a workspace takes you to create one. |
| Server URL | https://mcp.convops.app/ |
How do I add the ConvOps MCP server to Cursor?
Cursor reads MCP servers from a JSON file. Use the global file for yourself, or the project file to share the setup with the repository.
- 1
Add ConvOps to mcp.json
Create the file if it does not exist. If it does, add the convops entry inside mcpServers.
~/.cursor/mcp.json { "mcpServers": { "convops": { "url": "https://mcp.convops.app/" } } } - 2
Sign in
Open Customize in Cursor's sidebar, where MCP servers are managed, and find convops. Cursor supports OAuth for Streamable HTTP servers: start the sign-in there, your browser opens the ConvOps sign-in, and you approve access.
- 3
Check the tools
ConvOps should be enabled with its tools listed. Cursor's agent uses listed tools when relevant, under your run-mode settings.
- 4
Start a task from the agent
In Agent, ask: "Use ConvOps to start a feature task for CSV export and follow its workflow."
Prefer an API key?
To use an API key instead of OAuth, create one in the ConvOps app under Settings, API Keys and add it as a header. Keep a file with a key out of version control.
{
"mcpServers": {
"convops": {
"url": "https://mcp.convops.app/",
"headers": { "Authorization": "Bearer <your-api-key>" }
}
}
}Official reference: Cursor: Model Context Protocol, Cursor: rules. We checked these steps against those docs on . Anysphere updates its interface often; when a menu name differs, the vendor docs are current.
What does a governed task look like in Cursor?
A small feature. The plan step needs your OK before the agent writes code, so a wrong direction costs one message, not an afternoon.
new session
- Plannot handed over yet
- Plan approvalapproval
- Build and testnot handed over yet
- Open the PRnot handed over yet
example
Each tool row is Cursor calling ConvOps. The engine hands over one step, checks the gate when the agent asks to advance, and holds the run at an approval step until a person answers. The same task can be picked up later, by you or by a teammate in another client, at the step where it stopped.
Should the process live in Cursor rules or in ConvOps?
Rules for the code, workflows for the process. Cursor reads project rules from .cursor/rules and also supports AGENTS.md. Keep those for conventions and architecture. A process with ordered steps, checks and approvals fits ConvOps better, because the agent gets one step at a time and the state survives the chat. The glossary entry on agent instruction files draws the line.
Global or project file. ~/.cursor/mcp.json applies to every project you open. .cursor/mcp.json in the repository shares the server with the team; each person signs in with their own ConvOps account.
Run mode still applies. Per Cursor, it asks for approval before using MCP tools by default, following the same run modes as terminal commands. That is Cursor's control. ConvOps approval steps are separate: they are part of the workflow and recorded.
Planning tools fit next to it. Claude Task Master, for example, runs as an MCP server in Cursor and turns a PRD into a task list; ConvOps then governs how each task is done. See the Task Master comparison.
Why is ConvOps not showing up in Cursor?
Almost always one of two things: the sign-in has not finished, or the server is off for this session. Start with the first row.
| Symptom | Fix |
|---|---|
| ConvOps shows an error in Customize | Check the JSON is valid and the URL is exactly https://mcp.convops.app/ , then toggle the server off and on. |
| Login prompt never appears | Remove the server, save, add it back, and start the login from Customize. |
| Agent ignores the tools | Ask in Agent mode and name ConvOps in the request. Check the server is enabled. |
| Teammates cannot see it | Move the entry to .cursor/mcp.json in the repository and commit it. |
What else do people ask about ConvOps in Cursor?
Short answers, checked against the Anysphere documentation linked above.
Should I put ConvOps in the global or project mcp.json?
Global (~/.cursor/mcp.json) if it is just you. Project (.cursor/mcp.json) if the team should get it on clone. Everyone signs in with their own account either way.
Do I still need Cursor rules?
Yes, for codebase conventions. Move ordered processes, checks and approvals into ConvOps workflows, where they have state and an audit trail.
Can a Cursor user and a Claude Code user share a workflow?
Yes. Workflows and tasks live in the ConvOps workspace, so any connected client works the same process.
Does ConvOps read my code?
No. Cursor works on your code. ConvOps only receives the tool calls the agent makes, such as a step result or a note to remember.