Cursor Agent

MCP-мост OpenCode → Cursor agent CLI (обратное направление к delegate-mcp).

Кто кому

Направление	MCP
Cursor IDE → OpenCode	delegate-mcp
OpenCode → Cursor cloud	cursor-agent-mcp
VP контекст	vp-local-project

Ответ cursor_* только в OpenCode (JSON tool result), не в чат Cursor IDE.

Decision tree

Задача	Tool	Параметры
VP rules / contracts	vp-local-project	—
Git diff review	cursor_review	workspace, extra?
Debug симптом	cursor_debug	symptom, module?
План / merge / git strategy	cursor_ask	mode=plan, без allow_edits
Облако правит файлы	cursor_ask	mode=default, allow_edits=true

Не использовать: cursor_debug для merge; plan + allow_edits=true (сервер игнорирует force).

Tools

Tool	Назначение
cursor_guidelines	Playbook v1.1 — если сомневаешься
cursor_health	agent CLI + auth + busy
cursor_ask	One-shot (см. decision tree)
cursor_review	Code review diff
cursor_debug	Hypothesis table only

Лимит: 1 sync cursor_* / turn. Latency: 15s–5min.

Setup

cd E:\Software\OpenServer\domains\cursor-agent-mcp
npm install && npm run build
# agent login  OR  copy .env.example .env + CURSOR_API_KEY

OpenCode: ~/.config/opencode/opencode.jsonc → cursor-agent. После правок: restart Desktop + новая сессия.

Примеры

cursor_guidelines()
cursor_health()
cursor_review({ workspace: "E:/Software/OpenServer/domains/vp" })
cursor_debug({ symptom: "validate падает на stone после save", module: "validation" })
cursor_ask({ prompt: "План merge .gitignore Makefile composer.lock", mode: "plan" })

Auth

agent login на этой машине или CURSOR_API_KEY в .env.

Связанные файлы

• vp/.opencode/AGENTS.md — инструкции OpenCode
• domains/.cursor/rules/opencode-mcp-routing.mdc — routing rule