# CYBERSHOP AI — пошаговая инструкция (с нуля)

Канонический сайт: **https://ai.cybershop.kz**

Цель: чтобы Claude, ChatGPT и другие нейросети **находили** ваш каталог и **могли искать** оборудование.

---

## Что уже сделано в коде (вам трогать не нужно)

- Каталог APICore ~1658 SKU на сайте
- Файлы для AI: `/llms.txt`, `/ai.txt`, `/openapi.json`
- MCP-сервер в коде (ждёт деплоя Functions или Cloudflare)
- Гайды в `/docs/llm/`

---

## Этап 1. Дождаться billing Google Cloud (вы делаете)

Пока billing заблокирован, на сайте **не работают**:
- `https://ai.cybershop.kz/mcp`
- `https://ai.cybershop.kz/api/hub/submitLead`

Когда Google разблокирует проект `nurcity-app`:

1. Откройте PowerShell в папке проекта:
   ```
   C:\Users\Данил\Desktop\cybershop-hub\cybershop-hub\cybershop-hub
   ```
2. Выполните (подставьте путь к своему JSON-ключу):
   ```powershell
   npm run deploy:firebase:ai -- --key="C:\Users\Данил\Downloads\nurcity-app-firebase-adminsdk-fbsvc-6f5b03e195.json"
   ```
3. Проверка — в браузере или PowerShell:
   ```powershell
   curl https://ai.cybershop.kz/mcp
   ```
   Должен вернуться JSON с `"name": "cybershop-ai"` и списком tools.

**Если команда упала с 403** — billing ещё не готов, переходите к Этапу 2 (Cloudflare).

---

## Этап 2. MCP через Cloudflare (пока billing не готов) — 15 минут

Это **бесплатно** и не зависит от Google billing.

### 2.1. Регистрация Cloudflare

1. Зайдите на https://dash.cloudflare.com/sign-up
2. Подтвердите email

### 2.2. Установка Wrangler (один раз)

В PowerShell:

```powershell
npm install -g wrangler
wrangler login
```

Откроется браузер — войдите в Cloudflare и разрешите доступ.

### 2.3. Деплой MCP Worker

```powershell
cd C:\Users\Данил\Desktop\cybershop-hub\cybershop-hub\cybershop-hub\workers\cybershop-mcp
npx wrangler deploy
```

В конце будет строка вида:
```
Published cybershop-mcp
  https://cybershop-mcp.ВАШ_АККАУНТ.workers.dev
```

**Скопируйте этот URL** — это ваш живой MCP.

### 2.4. Проверка

```powershell
curl https://cybershop-mcp.ВАШ_АККАУНТ.workers.dev
```

Должен вернуться JSON с tools.

### 2.5. (Опционально) Красивый адрес mcp.cybershop.kz

Если домен `cybershop.kz` в Cloudflare:
1. Workers → cybershop-mcp → Settings → Domains & Routes → Add Custom Domain
2. Укажите `mcp.cybershop.kz`

---

## Этап 3. Подключить Claude

### Claude.ai (сайт)

1. Откройте https://claude.ai
2. **Settings** (шестерёнка) → **Connectors** / **Интеграции**
3. **Add connector** / **Добавить**
4. URL:
   - если billing готов: `https://ai.cybershop.kz/mcp`
   - если Cloudflare: `https://cybershop-mcp.ВАШ_АККАУНТ.workers.dev`
5. Авторизация: **нет / none**

### Проверка в чате Claude

Напишите:
> Найди в каталоге CYBERSHOP PoE-коммутатор на 24 порта

Claude должен вызвать инструмент `search_catalog` и показать SKU.

### Claude Desktop (приложение)

Файл конфигурации:
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "cybershop-ai": {
      "url": "https://ai.cybershop.kz/mcp"
    }
  }
}
```

Или локально (без интернет-MCP):
```json
{
  "mcpServers": {
    "cybershop-ai": {
      "command": "node",
      "args": ["scripts/mcp-stdio-server.mjs"],
      "cwd": "C:\\Users\\Данил\\Desktop\\cybershop-hub\\cybershop-hub\\cybershop-hub"
    }
  }
}
```

Перезапустите Claude Desktop.

---

## Этап 4. Подключить ChatGPT (Custom GPT)

1. Зайдите на https://chatgpt.com → **Explore GPTs** → **Create**
2. Вкладка **Configure**
3. **Instructions** — скопируйте текст из:
   https://ai.cybershop.kz/docs/llm/custom-gpt-instructions.md
4. **Actions** → **Create new action** → **Import from URL**:
   ```
   https://ai.cybershop.kz/openapi.json
   ```
5. Сохраните GPT (можно «Only me» для теста)

Проверка: «Подбери IP-камеры для склада 500 м², бюджет до 500000 тенге»

---

## Этап 5. Зарегистрировать в реестрах MCP (ручная работа, 1–2 часа)

Чтобы агенты **сами находили** вас (как openvan.camp):

| Куда | Что указать |
|------|-------------|
| https://smithery.ai | URL вашего MCP |
| https://glama.ai | MCP directory |
| https://www.pulsemcp.com | Server listing |

**Текст для описания** (копипаст):

> **CYBERSHOP AI** — B2B IT-каталог Казахстана (~1660 SKU APICore). Поиск сетевого оборудования, CCTV, серверной. MCP tools: search_catalog, get_product, submit_lead. Язык: ru. Регион: KZ.

Полный чеклист: https://ai.cybershop.kz/docs/llm/registry-submission-guide.md

---

## Этап 6. Google Search Console и Яндекс (SEO + GEO)

Чтобы сайт **цитировали** в ответах поиска и Perplexity:

### Google

1. https://search.google.com/search-console
2. Добавить ресурс: `https://ai.cybershop.kz`
3. Подтвердить домен (DNS или HTML)
4. **Sitemaps** → добавить: `https://ai.cybershop.kz/sitemap.xml`
5. **Проверка URL** → запросить индексацию: `/`, `/catalog/`, `/faq/`, `/insights/`

### Яндекс

1. https://webmaster.yandex.ru
2. Добавить сайт `https://ai.cybershop.kz`
3. Загрузить тот же sitemap
4. Регион: Казахстан

---

## Этап 7. Gemini (Google AI Studio)

1. https://aistudio.google.com
2. Создайте проект / чат
3. **Grounding** — добавьте URL:
   - `https://ai.cybershop.kz/llms-full.txt`
   - `https://ai.cybershop.kz/data/catalog/index.json`

---

## Шпаргалка: что куда

| Задача | URL / действие |
|--------|----------------|
| Каталог для людей | https://ai.cybershop.kz/catalog/ |
| Каталог для AI (JSON) | https://ai.cybershop.kz/data/catalog/index.json |
| MCP (после billing) | https://ai.cybershop.kz/mcp |
| MCP (Cloudflare) | ваш `*.workers.dev` URL |
| OpenAPI для ChatGPT | https://ai.cybershop.kz/openapi.json |
| Вся документация | https://ai.cybershop.kz/docs/llm/ |
| Деплой после billing | `npm run deploy:firebase:ai -- --key=...` |
| Деплой только сайта | `npm run deploy:firebase:hosting -- --key=...` |

---

## Частые проблемы

**MCP 404 на ai.cybershop.kz**  
→ Functions не задеплоены. Используйте Cloudflare Worker (Этап 2) или дождитесь billing (Этап 1).

**Claude не видит инструменты**  
→ Проверьте URL connector'а. Откройте URL в браузере — должен быть JSON.

**Каталог пустой в MCP**  
→ На сайте должен открываться https://ai.cybershop.kz/data/catalog/index.json с `item_count` ~1658.

**deploy:firebase:ai падает с 403**  
→ Billing или права IAM. Решайте billing; временно — Cloudflare MCP.

---

## Порядок действий (кратко)

1. ⏳ Вы решаете billing Google  
2. 🚀 Пока ждёте — **Cloudflare Worker** (Этап 2) + **Claude connector** (Этап 3)  
3. 🤖 **Custom GPT** (Этап 4)  
4. 📋 **Реестры** Smithery/Glama (Этап 5)  
5. 🔍 **Search Console + Яндекс** (Этап 6)  
6. ✅ После billing — `npm run deploy:firebase:ai` → переключить Claude на `ai.cybershop.kz/mcp`