# Підключення 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/uk/agents-connect.desktop.1496.7b05586e.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/uk/docs/ai-agents/rest-api).