# Подключение AI-агента через MCP

> Подключите ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code или Windsurf к HRC pagalba через MCP с OAuth. Шаги для каждого приложения.

MCP-сервер HRC pagalba работает по адресу `https://mcp.hrc.lt/mcp` (Streamable HTTP). Вставьте его в настройки своего AI-приложения и войдите в HRC pagalba. Точные шаги с кнопками копирования есть и в приложении: «Настройки», «AI-агенты», «Подключить AI-приложение».

> **Важно.** Перед подключением владелец компании включает доступ AI-агентов в разделе «Настройки», «AI-агенты».

![Подключение AI-агентов с выбранным приложением](https://hrc.lt/screens/ru/agents-connect.desktop.1496.afb41044.webp)

## Приложение ChatGPT (и приложение Codex на Mac или Windows)

1. В приложении откройте Settings, Plugins. Справа вверху нажмите Add, затем Add MCP server.
2. В форме Connect to a custom MCP: Name `hrc`, Type Streamable HTTP, URL `https://mcp.hrc.lt/mcp`.
3. Bearer token env var, Headers и Headers from environment variables оставьте пустыми и нажмите Save. Не вписывайте ключ в Bearer token env var: там указывается имя переменной.
4. На вкладке MCPs, в строке hrc, нажмите Authenticate.
5. В браузере войдите в HRC pagalba, выберите компанию и AI-агента, затем нажмите «Разрешить».
6. Браузер покажет короткое сообщение приложения «Authentication complete». Закройте это окно и вернитесь в приложение.

В старой версии приложения та же форма открывается через Settings, MCP servers, Add server.

## ChatGPT в браузере

1. Откройте chatgpt.com/plugins, нажмите +, затем Add custom MCP server.
2. Server URL `https://mcp.hrc.lt/mcp`, Authentication OAuth, затем Create.
3. Войдите в HRC pagalba и нажмите «Разрешить». Ключ здесь не подходит.
4. Нужен тариф Business, Enterprise или Edu.

## Claude (claude.ai и Claude Desktop)

1. Customize (или Settings), Connectors, + Add, Add custom connector.
2. Name HRC pagalba, URL `https://mcp.hrc.lt/mcp`, Continue.
3. Authentication Sign in now, Add, затем войдите и нажмите «Разрешить».

## Claude Code

```sh
claude mcp add --transport http --scope user hrc https://mcp.hrc.lt/mcp
# затем запустите claude, введите /mcp, выберите hrc и Authenticate
```

## Codex в терминале и редакторе кода

```sh
codex mcp add hrc --url https://mcp.hrc.lt/mcp
codex mcp login hrc
```

## Cursor

В файле `~/.cursor/mcp.json`, затем откройте Customize на боковой панели Cursor (в старой версии Cursor Settings, MCP) и войдите у hrc:

```json
{ "mcpServers": { "hrc": { "url": "https://mcp.hrc.lt/mcp" } } }
```

## VS Code (GitHub Copilot)

Command Palette, MCP: Add Server, HTTP, адрес `https://mcp.hrc.lt/mcp`, имя hrc. Нажмите Start; когда VS Code спросит, нажмите Allow и войдите. Нужен VS Code 1.101 или новее.

## Windsurf

В файле `~/.codeium/windsurf/mcp_config.json`, сохраните и войдите, когда Windsurf попросит:

```json
{ "mcpServers": { "hrc": { "serverUrl": "https://mcp.hrc.lt/mcp" } } }
```

## Другое приложение

Тип Streamable HTTP (http), адрес `https://mcp.hrc.lt/mcp`, затем вход через OAuth. Для приложения, которое умеет только локальные серверы:

```sh
npx -y mcp-remote https://mcp.hrc.lt/mcp --transport http-only
```

## Проверьте

Спросите свой AI: «Вызови инструмент HRC pagalba whoami и скажи, к какой компании ты подключён.» В ответе будут компания, ваши разрешения и инструменты.

## Что видит AI-агент

- **Инструменты:** только те, что разрешают его области, и всегда `whoami`. Например `conversation_list`, `prepared_reply_replace`, `task_queue`, `task_take`, `kb_article_update`, `contact_set_profile`, `changelog_entry_create`.
- **Новости:** с разрешением «Новости» AI-агент владельца пишет новость чат-виджета черновиком (`changelog_entry_create`) и публикует её (`changelog_entry_set_status`). Кнопка «AI-помощь» на вкладке «Новости» чат-виджета даёт готовое задание.
- **Файлы в задачах:** с разрешением «Задачи» (запись) AI-агент добавляет файлы к задаче, и они сразу видны в ней. Небольшой файл до 10 МБ передаётся в самом вызове (`task_file_add`). Файл со ссылкой https HRC pagalba скачивает сама (`task_file_add_from_url`, `task_file_upload_status`); в ChatGPT так добавляется файл, загруженный в чат. AI-агент, который выполняет команды (Claude Code, Codex, Cursor), загружает файл любого размера через curl (`task_file_upload_start`, `task_file_upload_sign_parts`, `task_file_upload_complete`, `task_file_upload_abort`). `task_file_list` показывает файлы задачи со ссылкой для скачивания на 5 минут. AI-агент владельца удаляет файл через `task_file_remove`. Действуют лимит размера файла компании, хранилище и запрещённые типы файлов, как и для людей.
- **Ресурсы:** открытые задачи (`hrc://task/<номер>`), статьи баз знаний и руководство KB Markdown.
- **Промпт:** `build_knowledge_base` для создания базы знаний (с правом записи в базы знаний).

Каждый вызов записывается в журнал действий.

## Приложение, которое не умеет входить

Отправляйте заголовок с ключом, который вы создадите в разделе «Настройки», «AI-агенты»:

```text
Authorization: Bearer hrc_live_...
```

Тот же ключ работает и для [REST API](https://hrc.lt/ru/docs/ai-agents/rest-api).