# Якщо він говорить MCP, він говорить Maguyva.

Canonical source: https://maguyva.ai/uk/for-anything

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Інтеграція не прив'язана до конкретного інструменту — вона прив'язана до протоколу. Maguyva — це стандартний MCP-сервер за однією URL-адресою, тож у чому б не працював ваш агент (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity, Zed, Cline чи щось, що ви написали самі), він отримує ту саму доступну для запитів карту вашого репозиторію. Проіндексуйте один раз — і кожен підключений клієнт ставитиме ті самі обґрунтовані запитання.

> Один MCP-сервер. Кожен клієнт. Без плагінів під кожен інструмент, без прив'язки до вендора.

## Що робить кожен шар

Чотири частини. У кожної своя робота.

### Будь-який MCP-клієнт

23 клієнтів із гайдами налаштування, зокрема Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity, або ваш власний агент.

### MCP

Відкритий стандарт, яким уже розмовляють вони всі.

### Maguyva

Один MCP-сервер. Обґрунтовані факти з репозиторію повертаються з file:line.

### Робочі простори, а не користувачі

За агентів немає окремої плати за користувача. [Переглянути ціни](https://maguyva.ai/uk/pricing)

## MCP — це і є інтеграція. Зробіть його стандартом.

Відкритий протокол — це правильне рішення, а не обхідний шлях. Побудова на [MCP](https://modelcontextprotocol.io/docs/getting-started/intro) замість плагіна під кожен інструмент — це саме те, як уникнути повторної інтеграції щоразу, коли виходить кращий агент. Це правильне рішення для:

- Одного блоку конфігурації сервера, що підходить будь-якому сумісному клієнту.
- Інструментів і ресурсів, переносних між редакторами, CLI та агентами.
- Межі, яку ваша команда безпеки перевіряє один раз, а не для кожного вендора окремо.
- Свободи змінювати клієнтів без перебудови всього стеку контексту.

Продовжуйте так робити. Стандартизація на MCP — правильний хід.

Але протокол — це труба. Вона переносить запитання і відповідь — але не *знає* вашу кодову базу. На іншому кінці має бути щось, що справді мапує ваші символи, місця виклику й залежності.

## Де контекст під кожен інструмент перестає масштабуватися

Чотири режими відмови, які не виправить жоден файл правил окремого агента.

### // кожен інструмент заходить з нуля

Оберіть нового агента — і він знову починає наосліп на вашому репозиторії. Ви заново вставляєте ті самі файли, заново закріплюєте той самий контекст, заново пишете ті самі правила. Робота не переноситься, бо вона ніколи не була спільним шаром.

### // файли правил не подорожують

`CLAUDE.md`, `.cursor/rules`, `AGENTS.md` — кожен прив'язаний до свого інструменту, і жоден не є індексом вашого коду, який можна опитати. Змініть клієнта — і карта, яку ви побудували вручну, залишиться позаду.

### // прив'язка до інтеграції — це податок

Вбудовування глибокого контексту кодової бази в плагін одного вендора означає, що того дня, коли ви спробуєте іншого агента, вам доведеться будувати все заново. Що кращий у вас контекст, то дорожче з нього піти.

### // протокол — це труба, а не карта

MCP переносить інструменти й контекст між клієнтом і сервером. Він не знає ваших символів, місць виклику чи графа залежностей. На іншому кінці має бути щось, що справді відповідає на запитання.

## Maguyva — це шар на іншому кінці протоколу

Це не ще один агент. Це сервер контексту репозиторію, який може викликати будь-який MCP-клієнт:

- **Один ендпоінт, кожен клієнт**: той самий `https://maguyva.tools/mcp` обслуговує Claude Code, Codex CLI, Gemini CLI, Cursor, Devin Desktop, Antigravity або скрипт, який ви написали сьогодні вранці.
- **Семантика + AST + граф + текст**: пошук за змістом, структурою, залежністю або буквальним текстом. Кожен результат повертає шлях до файлу та номер рядка, незалежно від того, який клієнт запитував.
- **З урахуванням гілок, між пакетами**: Maguyva бачить саме ту версію коду, яку редагує агент, у кожному пакеті монорепозиторію.
- **Без прив'язки до одного інструменту**: перемикайте агентів, коли забажаєте; шар контексту нікуди не подінеться. Ціноутворення за робочий простір, а не за місце — індексуйте 1 репозиторій чи 50.

> Ваш клієнт говорить MCP.
> Maguyva — це те, що відповідає, *коли він запитує про ваш код.*

## Три робочі процеси, однакові з будь-якого клієнта

Крос-пакетно, крос-мовно. Клієнт змінюється — обґрунтована відповідь ні.

### 01. Знайти потік автентифікації між пакетами з будь-якого агента

```text
agent> де в цьому монорепозиторії відбувається автентифікація?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

→ 4 точки входу в 4 пакетах, відсортовано за щільністю місць виклику.
[exit 0]
```

Claude Code, Cursor чи ваш власний скрипт — не важливо, який клієнт надіслав запит. Повертаються ті самі чотири файли в тому самому порядку, обґрунтовані реальним графом.

### 02. Знайти реальну реалізацію, а не тестову заглушку

```text
agent> як normalizePhoneNumber обробляє E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← реальна реалізація
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← заглушка
[exit 0]
```

Назви брешуть. Моки затіняють реальний код. Maguyva ранжує реальну реалізацію вище за тестовий мок — однаково для кожного клієнта, який запитує.

### 03. Перевірте радіус впливу перед рефакторингом

```text
agent> що викликає QueueDispatcher.publish у всьому монорепозиторії?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← крос-мовно через gRPC-стаб
[exit 0]
```

Крос-пакетно, а на поліглотному репозиторії ще й крос-мовно, місця виклику з'являються прямо в результаті. Завтра змініть агента — радіус впливу нікуди не подінеться, бо він живе на сервері, а не в клієнті.

## Налаштування з будь-яким MCP-клієнтом

Три кроки. Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

### 01. Проіндексуйте репозиторій на maguyva.ai

Оберіть той, який добре знаєте, щоб могли перевірити відповіді. Тариф Free покриває 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію.

### 02. Додайте Maguyva як MCP-сервер у будь-якому клієнті, яким користуєтеся

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. Поставте одне запитання, відповідь на яке вже знаєте

Почніть з одного репозиторію й одного перевірюваного запитання, як-от «що викликає `formatInvoice` у всіх пакетах?». Якщо відповідь збігається з тим, що сказали б ви, кожен інший клієнт, який ви на це спрямуєте, отримає той самий обґрунтований результат.

Інструкції для кожного клієнта (Claude Code, Codex, Cursor, Gemini, Devin Desktop, Antigravity та інших) — у [документації Maguyva про сумісність](https://maguyva.ai/uk/docs/compatibility).

## Проіндексуйте один репозиторій, який ви вже добре знаєте.

Підключіть будь-який MCP-клієнт. Поставте одне запитання, відповідь на яке можна підтвердити.

## Джерела

- [MCP: офіційний вступ](https://modelcontextprotocol.io/docs/getting-started/intro)
- [MCP: приклади клієнтів](https://modelcontextprotocol.io/clients)
- [Maguyva: сумісність і клієнти](https://maguyva.ai/uk/docs/compatibility)
- [Maguyva: стек і безпека](https://maguyva.ai/uk/stack)
- [Maguyva: ціни (за робочий простір, а не за користувача)](https://maguyva.ai/uk/pricing)