Saas Mcp Onboarding

Enable catalog SaaS MCPs with safe whitelists.

Skill metadata

Source	Bundled (installed by default)
Path	skills/devops/saas-mcp-onboarding
Version	1.1.0
Author	VibeOS
License	MIT
Platforms	linux, macos, windows
Tags	mcp, linear, n8n, notion, figma, saas, oauth, catalog
Related skills	niche-mcp-kit, mcp-safe-hygiene, cursor-capabilities-bridge, notion, figma-edit, design-to-code-loop

Reference: full SKILL.md

info

The following is the complete skill definition that VibeOS loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

SaaS MCP Onboarding

Turn on catalog SaaS MCP servers the Cursor-way: whitelist first, secrets in .env / OAuth, never TermitPro stub folders. Prefer the Nous catalog over hand-rolled configs.

For the full C8 cookbook (Figma + Notion + Linear staging + examples), also load skill niche-mcp-kit. Snippets: examples/mcp/README.md.

When to Use

• User wants Linear / Notion / Figma / n8n hosted MCP
• After P3 hygiene skill — adding a real remote server
• Notion: prefer catalog MCP OAuth; fall back to skill notion + API key

Prerequisites

• vibeos mcp catalog (or vibeos mcp catalog) shows the entry
• For OAuth servers: browser available (or paste-back / SSH forward)
• For n8n: running instance + keys in ~/.vibeos/.env
• Skill mcp-safe-hygiene rules still apply (≤5 enabled, tools.include)

How to Run

Linear (OAuth, read-first by default)

vibeos mcp install linear
vibeos mcp login linear          # if needed
vibeos mcp test linear
# set enabled: true in config if install left it disabled
# NEW session after enable
vibeos mcp configure linear      # expand writes only when intentional

Read-first defaults: optional-mcps/linear/manifest.yaml.

Geo-block: Linear OAuth may fail from some regions (e.g. Russia). Keep enabled: false and complete login from an allowed network/VPN. See examples/mcp/README.md.

Notion (OAuth catalog MCP)

vibeos mcp install notion
vibeos mcp login notion
vibeos mcp test notion
# NEW session
vibeos mcp configure notion      # opt into create/update only when asked

Catalog defaults are read-first (notion-search, notion-fetch, …).

Fallback if OAuth fails: skill notion + NOTION_API_KEY in .env. Do not enable TermitPro stub dirs under plugins/mcp-*.

Figma (OAuth)

vibeos mcp install figma
vibeos mcp login figma
vibeos mcp test figma
# NEW session — then skill figma-edit / design-to-code-loop
vibeos mcp configure figma       # catalog default_enabled is empty on purpose

Paste a Figma file/selection URL into the prompt for link-based context.

n8n (API key)

# Requires N8N_BASE_URL (or N8N_API_URL) + N8N_API_KEY in ~/.vibeos/.env
vibeos mcp install n8n
vibeos mcp test n8n

Prefer the catalog’s default_enabled (health/list/get/export) before activate/deactivate mutations.

GitHub

Skip GitHub MCP while the no-github / Timeweb-ship policy is active. Use project_git (read-only) + local git when needed.

Foundry / Scylla / ParadeDB (Cursor plugins)

Not catalog MCP here — use skill niche-integrations-onboarding to copy into ~/.vibeos/skills/ or add a user MCP. Never vendor into this repo’s plugins/.

Quick Reference

Server	Auth	Install	Notes
linear	OAuth HTTP	vibeos mcp install linear	Read-first; RU geo may block
notion	OAuth HTTP	vibeos mcp install notion	Or skill notion + API key
figma	OAuth HTTP	vibeos mcp install figma	+ figma-edit / design-to-code
n8n	API key	vibeos mcp install n8n	Needs local/remote n8n
GitHub	—	deferred	Timeweb-only ship path
Foundry/Scylla	—	niche-integrations-onboarding	User home only

Procedure

1. vibeos mcp catalog — confirm entry.
2. Install; ensure tools.include is set (doctor MCP Config Hygiene).
3. Complete auth (login / .env).
4. vibeos mcp test <name>.
5. Enable only on the profile that needs it (coding vs messaging).
6. New chat session; run smoke prompts from mcp-safe-hygiene.

Pitfalls

• Enabling Linear without OAuth → probe fails; tools appear after mcp login
• Geo-block: Linear login may show “Linear is not available in Russia” — complete vibeos mcp login linear from an allowed network/VPN, then enable
• Leaving no tools.include exposes create/update — prefer catalog defaults
• Mid-session enable breaks tool-schema expectations — new session
• Stub dirs under plugins/mcp-* are not VibeOS MCP
• Confusing Figma MCP with figma-edit — MCP is conversation tools; skill is REST

Verification

• vibeos doctor → MCP hygiene OK
• vibeos mcp list shows server + selected tool count
• Linear smoke: “list my open issues via MCP” → list_issues (after OAuth)
• Notion smoke: “search workspace for X via MCP” → notion-search
• See also: vibeos adoption status, skill niche-mcp-kit