# JetBrains MCP setup

Подключение JetBrains IDE (IntelliJ IDEA, WebStorm и совместимые) к hosted HTTP MCP Gateway.

## Prerequisites

- MCP plugin / совместимый MCP host с HTTP transport.
- Issued HTTP MCP token (Web Console → MCP Tokens).
- Публичный URL gateway, например `https://mwi.yatsuk.pro/mcp`.

## Пошаговая настройка

1. В Web Console откройте **Docs** → **IDE config** или `GET /api/ide-config`.
2. Скопируйте блок `jetbrains.mcpServers`.
3. Подставьте реальный Bearer token вместо `<issued-http-mcp-token>`.
4. Укажите `X-MCP-Client-ID: jetbrains` (должен быть в allowed clients токена).

## Copy-ready config

```json
{
  "mcpServers": {
    "1c-mcp-gateway": {
      "url": "https://mwi.yatsuk.pro/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_HTTP_MCP_TOKEN",
        "X-MCP-Client-ID": "jetbrains"
      }
    }
  }
}
```

## Проверка tools/list

```bash
curl -sS -X POST https://mwi.yatsuk.pro/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-MCP-Client-ID: jetbrains" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

## Первый тестовый prompt

```
Вызови list_profiles и check_profile_health для активного профиля.
```

## Типовые ошибки

| Issue | Fix |
|-------|-----|
| 401 Unauthorized | Проверьте token и scopes (`mcp:call`) |
| Client not allowed | Добавьте `jetbrains` в allowed clients токена |
| SSE Accept error | Укажите `Accept: application/json, text/event-stream` |

## Security warning

Не храните token в репозитории. Используйте env или secret store IDE.

## Related docs

- [MCP_CONNECTION.md](./MCP_CONNECTION.md)
- [CURSOR via CLAUDE_MCP_SETUP pattern](./CLAUDE_MCP_SETUP.md)