Saas Mcp Onboarding

Включение каталоговых SaaS MCP (Linear, n8n) с безопасными белыми списками.

Метаданные навыка

Источник	Встроенный (установлен по умолчанию)
Путь	skills/devops/saas-mcp-onboarding
Версия	1.0.0
Автор	VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	mcp, linear, n8n, notion, saas, oauth, catalog
Связанные навыки	mcp-safe-hygiene, cursor-capabilities-bridge, notion

Справочник: полный SKILL.md

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

SaaS MCP Onboarding

Включайте каталоговые SaaS MCP-серверы по-курсоровски: сначала белый список, секреты в .env / OAuth, никаких заглушечных папок TermitPro. Предпочитайте каталог Nous самодельным конфигам.

Когда использовать

• Пользователь хочет Linear / n8n / аналогичный хостинговый MCP
• После навыка гигиены P3 — добавление реального удалённого сервера
• Notion: предпочитайте встроенный навык notion (CLI/API), а не заглушечный плагин

Предварительные требования

• vibeos mcp catalog показывает запись
• Для Linear: доступен браузер для OAuth (или обратная вставка / SSH-туннель)
• Для n8n: запущенный экземпляр + N8N_API_KEY в ~/.vibeos/.env
• Правила навыка mcp-safe-hygiene всё ещё действуют (≤5 включено, tools.include)

Как запустить

Linear (OAuth, по умолчанию только чтение)

# Установка из каталога (может остаться отключённым, пока вы не включите)
vibeos mcp install linear

# Первое подключение запускает браузерный OAuth, затем:
vibeos mcp login linear          # если нужно
vibeos mcp test linear
# установите enabled: true в конфиге, если установка оставила его отключённым
# НОВАЯ сессия после включения

# Расширение до создания/обновления только намеренно:
vibeos mcp configure linear

Настройки «только чтение» по умолчанию находятся в optional-mcps/linear/manifest.yaml (tools.default_enabled).

n8n (API-ключ)

# Требует N8N_BASE_URL + N8N_API_KEY в ~/.vibeos/.env
vibeos mcp install n8n
vibeos mcp test n8n

Предпочитайте default_enabled из каталога (health/list/get/export) до мутаций activate/deactivate.

Notion

Не включайте ~/.vibeos/plugins/mcp-obsidian / заглушки TermitPro. Используйте навык notion с NOTION_API_KEY в .env (CLI/ntn или HTTP).

GitHub

Пропустите GitHub MCP, пока действует политика no-github. Используйте project_git (только чтение) + навыки при необходимости.

Краткая справка

Сервер	Аутентификация	Установка	Примечания
linear	OAuth HTTP	vibeos mcp install linear	Белый список «только чтение»
n8n	API-ключ	vibeos mcp install n8n	Требуется локальный/удалённый n8n
Notion	API-ключ	навык notion	Не каталоговый MCP здесь
GitHub	—	отложено	политика no-github

Процедура

1. vibeos mcp catalog — подтвердите запись.
2. Установите; убедитесь, что tools.include задан (диагностика MCP Config Hygiene).
3. Завершите аутентификацию (login / .env).
4. vibeos mcp test <name>.
5. Включайте только на том профиле, которому это нужно (кодинг vs общение).
6. Новая сессия чата; выполните пробные промпты из mcp-safe-hygiene.

Подводные камни

• Включение Linear без OAuth → проба падает; инструменты появляются после mcp login
• Геоблокировка: Вход в Linear может показать «Linear is not available in Russia» — выполните vibeos mcp login linear из разрешённой сети/VPN, затем включите
• Отсутствие tools.include открывает create/update — предпочитайте настройки каталога по умолчанию
• Включение в середине сессии ломает ожидания схемы инструментов — нужна новая сессия
• Папки-заглушки в plugins/mcp-* не являются VibeOS MCP

Проверка

• vibeos doctor → гигиена MCP в порядке
• vibeos mcp list показывает сервер + количество выбранных инструментов
• Пробный запуск Linear: «list my open issues via MCP» → list_issues (после OAuth)