# cursor-agent-mcp

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

```powershell
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