| 1 | # Agent Forge MCP в Cursor |
| 2 | |
| 3 | **AgentForge.Mcp** — stdio MCP-сервер к HTTP API forge. Токен берётся из `~/.forge/credentials.json` (после `forge auth login`) или из `FORGE_API_TOKEN`. |
| 4 | |
| 5 | ## 1. Forge API должен быть запущен |
| 6 | |
| 7 | **Рекомендуется (Docker):** см. [local-dev-docker.md](local-dev-docker.md) |
| 8 | |
| 9 | ```powershell |
| 10 | cd agent-forge |
| 11 | .\scripts\docker-up.ps1 |
| 12 | ``` |
| 13 | |
| 14 | Альтернатива без Docker: `dotnet run --project src\AgentForge\AgentForge.csproj` |
| 15 | |
| 16 | Проверка: http://127.0.0.1:8770/health |
| 17 | |
| 18 | ## 2. Опубликовать MCP |
| 19 | |
| 20 | ```powershell |
| 21 | .\scripts\publish-mcp.ps1 |
| 22 | ``` |
| 23 | |
| 24 | По умолчанию: сборка в `publish-mcp/` и зеркало **`D:\agent-forge-mcp\AgentForge.Mcp.exe`**. |
| 25 | |
| 26 | Без зеркала: `.\scripts\publish-mcp.ps1 -Target ""` |
| 27 | |
| 28 | ## 3. Добавить в Cursor |
| 29 | |
| 30 | Cursor Settings → MCP → добавить сервер. Фрагмент: [mcp-cursor-example.json](mcp-cursor-example.json). |
| 31 | |
| 32 | ```json |
| 33 | { |
| 34 | "mcpServers": { |
| 35 | "forge": { |
| 36 | "command": "D:\\agent-forge-mcp\\AgentForge.Mcp.exe", |
| 37 | "env": { |
| 38 | "FORGE_BASE_URL": "http://127.0.0.1:8770" |
| 39 | } |
| 40 | } |
| 41 | } |
| 42 | } |
| 43 | ``` |
| 44 | |
| 45 | Переменные (опционально): |
| 46 | |
| 47 | | Env | Назначение | |
| 48 | |-----|------------| |
| 49 | | `FORGE_BASE_URL` | URL forge (default `http://127.0.0.1:8770`) | |
| 50 | | `FORGE_API_TOKEN` | Bearer, если нет `~/.forge/credentials.json` | |
| 51 | | `FORGE_ACTOR` | Identity на все write (`oar:Comet`) — заголовок `X-Forge-Actor` | |
| 52 | |
| 53 | ## Инструменты |
| 54 | |
| 55 | `list_repos`, `create_repo`, `get_repo`, … — полный список и схемы: `GET /api/v1/capabilities` → `tools[]` (MCP ListTools зеркалит это при старте bridge). |
| 56 | |
| 57 | ## Два агента (два окна Cursor) |
| 58 | |
| 59 | Разные MCP entry с разным `FORGE_ACTOR` — см. [pilot-two-agents-cursor.md](pilot-two-agents-cursor.md). |
| 60 | |
| 61 | ## Альтернатива: Cascade IDE |
| 62 | |
| 63 | Forge Lens из открытого файла в CIDE: `ide_forge_lens_*` через **CascadeIDE** `--mcp-stdio` (тяжелее, нужна IDE). Для headless pilot достаточно **AgentForge.Mcp**. |
| 64 | |