Налаштування MCP

Файл .mcp.json

У корені репо лежить .mcp.json — стартовий профіль для Claude Code. Він задає, які MCP-сервери підключити в контексті цього проєкту. Повний каталог — у реєстрі.

Крок 1. Секрети в оточення

Не вписуй токени у .mcp.json. Замість цього експортуй їх у середовище (або поклади у .env, який у .gitignore):

export GITHUB_PERSONAL_ACCESS_TOKEN="..."
# Якщо колись треба прямий Postgres MCP — лише read-only роль.
# Наразі Postgres MCP не підключений (БД у VPC, доступ через bastion).

.mcp.json посилається на них через ${VAR}.

Крок 2. Увімкнути потрібні сервери

Розкоментуй/додай блоки в .mcp.json за прикладами з реєстру. Мінімум на старт: context7, Railway (для Telegram-сервісів), Cloudflare (DNS/CDN). AWS — через aws CLI з профілем abitly, окремого MCP в робочому профілі немає.

Крок 3. Перезапустити Claude Code

Після зміни .mcp.json перезапусти сесію, щоб сервери підхопились. Перевір, що інструменти доступні.

Безпека

• Postgres у проді → read-only роль для агента.
• Cloudflare/Railway/AWS → токени з мінімальними правами.
• Жодних реальних значень у git (див. environments).