# Как подключить VeriThink MCP (RU)

Краткая инструкция для пользователей. Полная страница на сайте: [/account/for-developers.html](/account/for-developers.html).

## Шаг 1 — API-ключ

1. Откройте **[мастер подключения MCP](/account/mcp-connect.html)** (рекомендуется) или [личный кабинет](/account/index.html?tab=keys).
2. Войдите по email (magic-link).
3. Создайте API-ключ (префикс `vt_…`).
4. **Сохраните ключ сразу** — повторно он не показывается.
5. Нажмите **«Добавить в Cursor (hosted)»** — одна кнопка, без ручного JSON.

## Шаг 2 — Выберите способ

| | **Облачный (Hosted)** | **Локальный (Local)** |
|---|------------------------|------------------------|
| **Когда** | Нет желания ставить ReasonService на ПК | Полный контроль, dev на `:8787` |
| **Установка** | Не нужен npx | `npx -y verithink-mcp` + ReasonService |
| **Endpoint** | `https://mcp.verifythink.com/mcp` | stdio через npx |

Оба варианта дают одинаковый цикл: `reason_plan` → код → `reason_verify` → `reason_feedback`.

**Честно про сайт:** быстрый чат на сайте отвечает короче; полный цикл plan/verify — в Cursor через MCP. Флаги `VERITHINK_IQ_*` в проде по умолчанию выключены, пока оператор не включит их в env.

## Облачный MCP — JSON для Cursor

Cursor → **Settings → MCP** → вставьте в `%USERPROFILE%\.cursor\mcp.json` (или `.cursor/mcp.json` в проекте):

```json
{
  "mcpServers": {
    "verithink": {
      "url": "https://mcp.verifythink.com/mcp",
      "headers": {
        "Authorization": "Bearer vt_ВАШ_КЛЮЧ",
        "X-VeriThink-Workspace": "${workspaceFolder}"
      }
    }
  }
}
```

Замените `vt_ВАШ_КЛЮЧ` на ключ из кабинета. На **mcp.verifythink.com** заголовок `X-VeriThink-Workspace` **обязателен** (без него сервер отвечает **403**); он изолирует каждое окно Cursor. На hosted MCP пути `providedFiles` не читаются с вашего диска — передавайте тела файлов в `context`. Нажмите **Reload** в настройках MCP и один раз **Connect** у verithink.

## Локальный MCP — JSON для Cursor

1. Запустите ReasonService: `./scripts/start-local.ps1` (порт **8787**).
2. В Cursor:

```json
{
  "mcpServers": {
    "verithink": {
      "command": "npx",
      "args": ["-y", "verithink-mcp"],
      "env": {
        "VERITHINK_AUTOSTART": "1",
        "VERITHINK_LLM_PROVIDER": "openai"
      }
    }
  }
}
```

Или нажмите **«Добавить в Cursor»** на [странице разработчика](/account/for-developers.html).

## Проверка

В Agent-чате Cursor: «Вызови `reason_health`». Должен вернуться статус сервиса без ошибок MCP.

## Тариф (grant) и ключ — не путать

Админ может включить Pro/Max на аккаунте — это **не** секрет для Cursor. Ключ `vt_…` создаётся отдельно в [кабинете](/account/index.html?tab=keys).

## Если ключ скомпрометирован

1. Кабинет → **API keys** → **Ротировать** (старый секрет сразу недействителен) или **Отозвать** + создать новый.
2. Обновите `Authorization` в настройках MCP Cursor.
3. Подробнее: [жизненный цикл ключа](/docs/public/MCP_KEY_LIFECYCLE_RU.md) · [схема](/docs/assets/mcp-key-lifecycle.svg).

## Документация

| Документ | Для кого |
|----------|----------|
| [MCP_QUICKSTART.md](../MCP_QUICKSTART.md) | Быстрый старт (hosted + local) |
| [HOSTED_MCP.md](../HOSTED_MCP.md) | Оператор: TLS, Caddy, env |
| [MCP_CURSOR_GUIDE_RU.md](../MCP_CURSOR_GUIDE_RU.md) | Полное руководство Cursor |