---
title: "Плагін для агентів — Предок"
description: "Як встановити плагін predok-plugin у Claude Code, Codex, Gemini CLI, OpenCode, Cursor чи інше агентне середовище: сервер Предка й методичка дослідження родоводу."
lang: uk
url: https://predok.ai/uk/help/agents
updated: 2026-11-21
alternates:
  en: https://predok.ai/en/help/agents.md
---

# Плагін для агентів

[predok-plugin](https://github.com/solvek/predok) — відкритий плагін для ШІ-агентів у терміналі й редакторі. У ньому два компоненти:

- **скіл `predok`** — методичка дослідження родоводу; щоразу читає актуальну версію з [бази знань Предка](https://predok.ai/uk/w/);
- **MCP-сервер `predok`** за адресою `https://api.predok.ai/mcp`: люди, події, місця, прізвища, архівні джерела з шифрами й сканами. Агент звертається до нього першим.

Агент, який прочитав цю сторінку, може встановити плагін сам: нижче те саме, що в [README плагіна](https://github.com/solvek/predok).

## Claude Code

У сесії Claude Code:

```
/plugin marketplace add solvek/predok
/plugin install predok-plugin@predok
```

Друга команда відкриває панель плагіна: оберіть, для кого його встановити (для вас у всіх проєктах, для всіх у репозиторії або лише для вас у цій теці). З терміналу:

```bash
claude plugin marketplace add solvek/predok
claude plugin install predok-plugin@predok --scope local
```

## Codex

```bash
codex plugin marketplace add solvek/predok
```

Потім відкрийте каталог плагінів (**Plugins**) у Codex, оберіть маркетплейс **Predok** і встановіть **predok-plugin**. Без плагіна, вручну:

```bash
codex mcp add predok --url https://api.predok.ai/mcp
codex mcp login predok
```

Скіл — скопіюйте теку `skills/predok` з репозиторію в `~/.agents/skills/` або в `.agents/skills/` потрібного проєкту.

## Gemini CLI

```bash
gemini extensions install https://github.com/solvek/predok
```

## OpenCode

```bash
opencode mcp add predok --global --url https://api.predok.ai/mcp
```

Скіл — скопіюйте теку `skills/predok` у `~/.config/opencode/skills/` або в `.opencode/skills/` проєкту.

## Cursor

Додайте сервер у `~/.cursor/mcp.json` (усі проєкти) або `.cursor/mcp.json` проєкту:

```json
{
  "mcpServers": {
    "predok": { "url": "https://api.predok.ai/mcp" }
  }
}
```

Вміст `skills/predok/SKILL.md` додайте як правило в `.cursor/rules/`.

## Claude (застосунок і claude.ai)

Це не агентне середовище, а асистент із конекторами: дивіться [конектор](https://predok.ai/uk/help/connector.md).

## Інші середовища

Додайте MCP-сервер `https://api.predok.ai/mcp` (транспорт Streamable HTTP) у файл налаштувань MCP свого середовища. Здебільшого це JSON такого вигляду; назву файлу й точний формат дивіться в документації середовища:

```json
{
  "mcpServers": {
    "predok": { "type": "http", "url": "https://api.predok.ai/mcp" }
  }
}
```

Якщо середовище підтримує скіли, правила чи системні інструкції, підключіть [`skills/predok/SKILL.md`](https://github.com/solvek/predok/blob/main/skills/predok/SKILL.md).

## Вхід

Сервер використовує OAuth: вхід через Google. Читання рахується в кредитах, є безкоштовний ліміт ([тарифи](https://predok.ai/uk/pricing)).

- **Claude Code:** `/mcp` → `predok` → **Authenticate**, увійти в браузері й повернутися в термінал.
- **Gemini CLI:** `/mcp auth predok`.
- **Codex:** `codex mcp login predok`.
- **OpenCode:** `/mcps` → `predok` або `opencode mcp auth predok`.

## Перший запит

Опишіть агентові, що знаєте про предків і чого хочете, наприклад:

```
Мій прадід Іван Коваль народився близько 1890 року в селі на Волині. З чого почати пошук?
```

Агент прочитає потрібні розділи методички, складе план пошуку й запропонує джерела, архіви та онлайн-ресурси з посиланнями на predok.ai.

Повернутися до [огляду](https://predok.ai/uk/help.md).
