Kira Perplexity Scout — MCP-сервер

Подключает Perplexity как помощника прямо в инструменты Claude/Cowork. Даёт 3 инструмента: perplexity_search, kira_trend_scout, perplexity_deep.

---

Что внутри

• server.py — сам MCP-сервер (Perplexity Sonar API → MCP-инструменты)
• requirements.txt — зависимости
• .env.example — шаблон для API-ключа
• Procfile — команда запуска для хостинга

---

Шаг 1. Получить API-ключ Perplexity

1. Зайди на perplexity.ai → Settings → API (нужен аккаунт; для API нужен платный тариф/кредиты).
2. Создай ключ. Он выглядит как pplx-xxxxxxxx...
3. Сохрани — он понадобится на деплое.

---

Шаг 2. Задеплоить сервер (вариант через Render — бесплатно и без терминала)

Claude connectors требуют публичный HTTPS-URL, поэтому сервер надо разместить онлайн. Самый простой путь — Render:

1. Залей папку perplexity-mcp в новый репозиторий на GitHub (или используй любой git-хостинг).
2. Зайди на render.com → New → Web Service и подключи репозиторий.
3. Настройки:
   • Runtime: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: python server.py
4. В разделе Environment добавь переменную:
   • PERPLEXITY_API_KEY = твой ключ pplx-...
5. Нажми Deploy. Render выдаст URL вида https://kira-perplexity-scout.onrender.com
6. Твой MCP-endpoint будет: https://kira-perplexity-scout.onrender.com/mcp

Альтернатива без GitHub: Railway, Fly.io — логика та же (env-переменная + start command). Локальный запуск (python server.py) тоже работает, но тогда нужен туннель (ngrok), чтобы дать Claude публичный HTTPS-адрес.

---

Шаг 3. Подключить к Cowork / Claude

1. В Claude открой Settings → Connectors → Add custom connector.
2. Вставь URL endpoint: https://...onrender.com/mcp
3. Тип транспорта: Streamable HTTP (сервер уже на нём).
4. Сохрани и включи коннектор в чате.

После этого в моём списке инструментов появятся:

• perplexity_search(query, recency) — быстрый поиск с источниками
• kira_trend_scout(topic, recency) — тренд-бриф под Киру
• perplexity_deep(query) — глубокий ресёрч

---

Шаг 4. Проверка

Напиши мне: «Запусти kira_trend_scout по теме AI-инструменты, свежесть week». Если коннектор подключён — я вызову Perplexity и верну бриф с источниками.

---

Безопасность

• Ключ PERPLEXITY_API_KEY хранится только в env хостинга, в коде его нет.
• Не коммить .env в git (добавь его в .gitignore).
• Если ключ утёк — отзови его в Settings Perplexity и создай новый.