# Интеграции и API — минимум для основателя

> [HTML-версия](https://learnvibecoding.ru/publiclessons/integratsii-i-api-minimum-dlya-osnovatelya) · [Индекс для LLM](https://learnvibecoding.ru/llms.txt) · [Политика использования материалов](https://learnvibecoding.ru/politika-materialov)
> Материалы защищены. Обучение LLM без согласия запрещено. При разрешённом использовании — обязательна прямая ссылка на страницу-источник.

**Курс:** От идеи к окупаемому AI-продукту

Твой AI-продукт не существует в вакууме.Клиенты работают в Slack, Google Sheets, CRM-системах — и если им нужно каждый раз открывать отдельный сайт и копировать данные вручную, это трение. Интеграции убирают это трение: AI начинает работать там, где уже находится клиент.

## Блок 1: Что такое интеграция

**Интеграция** — это автоматическая связь между твоим AI-продуктом и другой системой клиента. Человек ничего не переключает, данные передаются сами.

![С интеграцией и без интеграции](https://nhvwqitwebmmswnjylop.supabase.co/storage/v1/object/public/Pictures%20for%20course/Product,%20AI%20product,%20vibecoding/integration_vs_no_integration.png)

```
БЕЗ ИНТЕГРАЦИИ:
─────────────────
Клиент добавил контакт в CRM
→ Открывает твой сайт
→ Копирует данные вручную
→ Получает результат
→ Копирует результат обратно в CRM

С ИНТЕГРАЦИЕЙ:
───────────────
Клиент добавил контакт в CRM
→ AI автоматически анализирует
→ Результат появляется прямо в CRM
```

### Три примера как это выглядит у клиента

**Slack:** сотрудник пишет `/ai придумай идеи для поста` — бот отвечает прямо в канале.

**Google Sheets:** маркетолог вводит тему в колонку A — в колонке B автоматически появляется сгенерированный текст.

**CRM:** менеджер добавляет новый контакт — AI автоматически ставит скор и рекомендацию в поле карточки.

---

## Блок 2: API — язык на котором системы обмениваются данными

Чтобы две системы обменивались данными, им нужен общий язык и правила передачи. Это и есть **API (Application Programming Interface)**.

![API как связующий мост](https://nhvwqitwebmmswnjylop.supabase.co/storage/v1/object/public/Pictures%20for%20course/Product,%20AI%20product,%20vibecoding/api_as_a_bridge.png)

API — это меню в ресторане. В меню написано, что можно заказать, в каком формате и что получишь в ответ. Ты не заходишь на кухню — просто делаешь заказ по правилам меню.

```
КАК РАБОТАЕТ API ЗАПРОС:

1. CRM говорит твоему серверу:
   "Пришёл новый контакт: Иван, компания ООО Рога, бюджет $100K"

2. Твой сервер отправляет в Claude:
   "Оцени потенциал этого клиента"

3. Claude отвечает:
   "Скор 7/10, рекомендация: выяснить потребности перед презентацией"

4. Твой сервер отправляет результат в CRM:
   поле "AI-скор" = 7/10, поле "Рекомендация" = текст

Всё это происходит за 1-2 секунды, автоматически.
```

### Первая интеграция у любого AI-продукта — это сам AI

Прежде чем думать о Slack, CRM или Google Sheets — твой продукт уже использует интеграцию: подключение к языковой модели (Claude, GPT, Gemini) через их API. Это и есть ядро продукта.

```
Твой сервер → API запрос → Claude API → ответ → твой сервер → клиент
```

Это тоже интеграция, со всеми вытекающими:
- За неё платишь по токенам
- Она может быть недоступна (outage на стороне Anthropic/OpenAI) — стоит иметь fallback или хотя бы понятную ошибку для клиента
- Её нужно защищать: API-ключ никогда не должен быть виден на фронтенде или в публичном коде

Все остальные интеграции (Slack, CRM, Sheets) — надстройка над этим ядром.

---

## Блок 3: Шесть типов интеграций

![Шесть способов интеграции: Webhook, API, Hub, Widget, MCP, Plugin](https://nhvwqitwebmmswnjylop.supabase.co/storage/v1/object/public/Pictures%20for%20course/Product,%20AI%20product,%20vibecoding/six_integration_types.png)

| Тип | Как работает | Сложность | Когда использовать |
|-----|-------------|-----------|-------------------|
| **Webhook** | Чужая система сама присылает данные при событии | Простая | Реагировать на событие: новый контакт, новая строка в таблице |
| **Двусторонний API** | Данные идут туда и обратно | Средняя | Большинство интеграций: CRM, Google Sheets, базы данных |
| **Хаб (Zapier / Make)** | Ты делаешь одну интеграцию с Zapier — через него клиент сам подключает 5000+ приложений | Простая | MVP: не хочешь писать 10 разных интеграций, клиент настраивает сам |
| **Widget / Embed** | Клиент вставляет одну строку JS-кода на свой сайт — твой AI появляется там как виджет | Простая | Чат-боты, поддержка на сайте (SiteGPT, Chatbase) |
| **MCP** | AI сам подключается к инструменту напрямую через стандартный протокол | Простая (если инструмент уже поддерживает MCP) | Агентный продукт, AI сам решает какие данные достать |
| **Native Plugin** | Твой код живёт внутри чужой системы | Сложная | Кнопка прямо внутри Salesforce или Notion — это про масштаб |

### MCP — новый стандарт, который меняет правила

**MCP (Model Context Protocol)** — протокол от Anthropic, который позволяет AI-модели напрямую подключаться к внешним инструментам без кастомного кода с твоей стороны.

В классической интеграции ты сам пишешь весь "мост":
```
Клиент → твой код (достаёт данные) → Claude → результат
```

С MCP Claude сам умеет дотянуться до инструмента:
```
Клиент → Claude (через MCP напрямую читает CRM / файл / базу) → результат
```

**Главное, что нужно знать:** большинство популярных инструментов уже имеют готовые MCP-серверы — Slack, GitHub, Google Drive, Notion, Linear, Figma, PostgreSQL и десятки других. Тебе не нужно его писать — ты просто подключаешь готовый. Это буквально несколько строк конфигурации.

Это меняет логику интеграций: вместо того, чтобы писать код для каждого инструмента, ты можешь подключить десяток MCP-серверов и AI сам решает, что и когда использовать.

**MCP хорошо подходит когда:**
- Строишь агентный продукт — AI должен сам решать какие данные нужны
- Нужно подключить 3+ источника данных (при меньшем числе кастомный API проще)
- Инструмент уже поддерживает MCP (проверяй список перед тем как писать что-то самому)

### MCP съедает токены — это важно понимать

MCP — не бесплатный. Каждый подключённый MCP-сервер добавляет в контекст описания всех своих инструментов (tool schemas), и это происходит при каждом запросе. Реальные бенчмарки показывают:

- Одна простая операция через MCP может стоить в **4–35 раз больше токенов**, чем прямой API-вызов
- Три подключённых MCP-сервера с 40+ инструментами способны съедать **до 70% контекстного окна** ещё до того как агент начал работать

**Когда проще и дешевле написать свою интеграцию:**
- Простая, повторяющаяся задача с одним фиксированным эндпоинтом (например, раз в час тянуть метрики из одного API)
- Высокочастотные операции — каждый лишний токен множится на тысячи вызовов в день
- Одна интеграция с одним инструментом — кастомный API всегда будет дешевле и проще

**Как экономить токены при использовании MCP:**

| Способ | Что делает |
|--------|-----------|
| **Динамическая загрузка инструментов** | Загружай только те MCP-инструменты которые нужны для конкретной задачи, не все сразу |
| **Шейпинг вывода** | Настрой MCP-сервер чтобы возвращал только нужные поля, а не весь объект целиком |
| **Кэширование** | Кэшируй описания инструментов и часто запрашиваемые данные между вызовами |
| **Лимит серверов** | Держи не больше 5–15 MCP-серверов на один воркфлоу — производительность падает с ростом числа инструментов |

---

## Блок 4: Какую интеграцию выбирать

Написать интеграцию сегодня — это минуты, не недели. Поэтому вопрос уже не "когда у меня будет время", а **"какую именно делать и зачем"**.

Настоящая ловушка: ты не знаешь, какая интеграция нужна, пока не поговорил с клиентами. Можно за 10 минут сделать Salesforce-интеграцию, а выяснится, что 80% клиентов работают в Google Sheets.

```
ПРАВИЛЬНЫЙ ПОДХОД:
──────────────────

Шаг 1: Запускаешь и спрашиваешь клиентов
  "В каких инструментах ты работаешь каждый день?"
  "Что неудобно в том как сейчас работает продукт?"

Шаг 2: Делаешь ту интеграцию, которую просили
  Знаешь, что точно нужно — делаешь быстро.
  Сначала проверяй есть ли готовый MCP-сервер для этого инструмента.
```

**Когда интеграция нужна с самого начала:**
- Продукт по природе живёт внутри другой системы (делаешь Slack-бота — без Slack нет продукта)
- Клиент сам сказал до старта: "Без интеграции с нашей CRM не купим"

---

## Блок 5: Как интеграции влияют на API-расходы

Интеграции часто увеличивают объём запросов — потому что AI начинает обрабатывать данные автоматически, а не только когда клиент что-то сделал вручную.

```
БЕЗ ИНТЕГРАЦИИ:
Клиент раз в день вводит текст → 30 запросов/месяц → $1.50

С ИНТЕГРАЦИЕЙ (Sheets, 10 строк в день):
AI обрабатывает каждую строку автоматически → 300 запросов/месяц → $15

С ИНТЕГРАЦИЕЙ (CRM, 100 контактов в день):
3000 запросов/месяц → $150
```

При интеграции следи за объёмом. Если клиент будет грузить тысячи записей — нужен лимит или отдельный тариф.

| Ситуация | Что делать |
|----------|-----------|
| Небольшой объём (до 300 запросов/месяц) | Включить в базовую подписку |
| Превышение лимита | Брать $0.05–0.10 за каждый дополнительный запрос |
| Крупный клиент (1000+ запросов) | Enterprise-тариф с фиксированной ценой |

---

> 📝 **Практическое задание** вынесено в отдельный урок: **Урок_8_практика_Интеграции.md**
...............

[Все уроки](https://learnvibecoding.ru/publiclessons.md) · HTML: https://learnvibecoding.ru/publiclessons