{"skill":{"slug":"mcp-server-setup-kit","displayName":"MCP Server Setup Kit","summary":"Guides you step-by-step to quickly connect Claude to Notion, Linear, Slack, and GitHub using a tested MCP server setup protocol with config templates and tes...","description":"---\nname: mcp-server-setup-kit\nversion: 1.0.0\nprice: 19\nbundle: ai-setup-productivity-pack\nbundle_price: 79\nlast_validated: 2026-03-07\n---\n\n# MCP Server Setup Kit\n\n**Framework: The 5-Minute Connect Protocol**\n*Worth $200/hr consultant time. Yours for $19.*\n\n---\n\n## What This Skill Does\n\nGuides you through connecting Claude to Notion, Linear, Slack, and GitHub using the Model Context Protocol (MCP) — in one focused workflow. No trial-and-error. No missing steps. Just a working integration you can test in under 5 minutes per tool.\n\n**Problem it solves:** MCP setup friction is the #1 reason teams abandon agent workflows in 2026. The docs exist but the path is scattered. This skill gives you the straight line.\n\n---\n\n## The 5-Minute Connect Protocol\n\nA structured checklist that takes any MCP server from \"never heard of it\" to \"Claude is using it\" in 5 minutes or less.\n\n### Phase 1 — Qualify (30 seconds)\n\nAnswer these before touching any config:\n\n| Question | Yes → Continue | No → Fix First |\n|----------|----------------|----------------|\n| Do you have a Claude Desktop or OpenClaw installation? | ✅ | Install first |\n| Do you have an API key / OAuth token for the target tool? | ✅ | Generate it now |\n| Do you know where your `claude_desktop_config.json` lives? | ✅ | Find it (see below) |\n| Is Node.js 18+ or Python 3.10+ installed? | ✅ | Install via homebrew/nvm |\n\n**Config file locations:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- OpenClaw: `~/.openclaw/openclaw.json` (mcpServers block)\n\n---\n\n### Phase 2 — Install (2 minutes)\n\n**Universal install pattern:**\n\n```bash\n# For NPX-based MCP servers (most common)\nnpx -y @modelcontextprotocol/server-{toolname}\n\n# For Python-based MCP servers\npip install mcp-server-{toolname}\nuvx mcp-server-{toolname}\n```\n\n**Verify the binary works before touching config:**\n```bash\nnpx -y @modelcontextprotocol/server-github --help\n# Should print usage/options — if it errors, fix here before config\n```\n\n---\n\n### Phase 3 — Configure (1 minute)\n\nAdd the server block to your config. Universal template:\n\n```json\n{\n  \"mcpServers\": {\n    \"{tool-name}\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-{tool-name}\"],\n      \"env\": {\n        \"{TOOL}_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Phase 4 — Test (90 seconds)\n\nUse these verification prompts immediately after restart:\n\n```\n\"List my available MCP tools\"\n\"What can you do with [tool-name]?\"\n\"[Tool-specific test prompt from templates below]\"\n```\n\n**If Claude doesn't see the tool:** restart Claude Desktop / OpenClaw gateway completely (not just refresh).\n\n---\n\n### Phase 5 — Validate (30 seconds)\n\n✅ Claude lists the tool when asked\n✅ Tool-specific test prompt returns real data\n✅ Write operation (if applicable) succeeds\n✅ No auth errors in logs\n\n**Log check:** `~/Library/Logs/Claude/mcp*.log` (macOS)\n\n---\n\n## 5 Pre-Built Integration Templates\n\n### Template 1: GitHub MCP\n\n**Use case:** Let Claude read repos, issues, PRs, and push code.\n\n```json\n{\n  \"mcpServers\": {\n    \"github\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"],\n      \"env\": {\n        \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"ghp_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n**Token scopes needed:** `repo`, `read:user`, `read:org`\n**Generate at:** github.com → Settings → Developer Settings → Personal Access Tokens\n\n**5-Minute Connect test prompts:**\n1. `\"List my open GitHub issues across all repos\"`\n2. `\"What PRs are waiting for my review?\"`\n3. `\"Show me the README for [your-repo]\"`\n\n---\n\n### Template 2: Notion MCP\n\n**Use case:** Let Claude read/write Notion pages and databases.\n\n```json\n{\n  \"mcpServers\": {\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-notion\"],\n      \"env\": {\n        \"NOTION_API_TOKEN\": \"secret_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n**Token setup:** notion.com → Settings → Connections → Develop integrations → New integration\n**Critical step:** Share target pages with your integration (Notion doesn't auto-grant access)\n\n**5-Minute Connect test prompts:**\n1. `\"List my Notion pages\"`\n2. `\"Search Notion for [topic]\"`\n3. `\"Create a new page titled 'MCP Test' in [workspace]\"`\n\n---\n\n### Template 3: Slack MCP\n\n**Use case:** Let Claude read channels, send messages, search history.\n\n```json\n{\n  \"mcpServers\": {\n    \"slack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-slack\"],\n      \"env\": {\n        \"SLACK_BOT_TOKEN\": \"xoxb-your-token\",\n        \"SLACK_TEAM_ID\": \"T0XXXXXXX\"\n      }\n    }\n  }\n}\n```\n\n**Token setup:** api.slack.com → Create App → OAuth & Permissions\n**Scopes needed:** `channels:read`, `chat:write`, `channels:history`, `users:read`\n\n**5-Minute Connect test prompts:**\n1. `\"List my Slack channels\"`\n2. `\"What was discussed in #general today?\"`\n3. `\"Send 'MCP connected!' to #general\"`\n\n---\n\n### Template 4: Linear MCP\n\n**Use case:** Let Claude read/create/update Linear issues and projects.\n\n```json\n{\n  \"mcpServers\": {\n    \"linear\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-linear\"],\n      \"env\": {\n        \"LINEAR_API_KEY\": \"lin_api_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Key setup:** linear.app → Settings → API → Personal API Keys\n\n**5-Minute Connect test prompts:**\n1. `\"What issues are assigned to me in Linear?\"`\n2. `\"Show my current sprint\"`\n3. `\"Create a new Linear issue: 'Test MCP connection' in [Team]\"`\n\n---\n\n### Template 5: Multi-Tool Stack (All 4 at Once)\n\nFor teams who want the full setup in one shot:\n\n```json\n{\n  \"mcpServers\": {\n    \"github\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-github\"],\n      \"env\": { \"GITHUB_PERSONAL_ACCESS_TOKEN\": \"ghp_...\" }\n    },\n    \"notion\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-notion\"],\n      \"env\": { \"NOTION_API_TOKEN\": \"secret_...\" }\n    },\n    \"slack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-slack\"],\n      \"env\": {\n        \"SLACK_BOT_TOKEN\": \"xoxb-...\",\n        \"SLACK_TEAM_ID\": \"T0...\"\n      }\n    },\n    \"linear\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-linear\"],\n      \"env\": { \"LINEAR_API_KEY\": \"lin_api_...\" }\n    }\n  }\n}\n```\n\n**Cross-tool test prompt:**\n`\"Using my connected tools: summarize my open Linear issues, find related Notion docs, check GitHub for open PRs, and post a summary to #standup in Slack\"`\n\n---\n\n## Troubleshooting Decision Tree\n\n```\nClaude doesn't see my MCP tool\n├── Did you restart Claude completely? (not just refresh)\n│   └── No → Restart fully → Try again\n├── Is the config JSON valid?\n│   └── Check: jsonlint.com → paste your config\n├── Does the server binary work standalone?\n│   └── Run: npx -y @modelcontextprotocol/server-{name} --help\n│       ├── Error → npm/node version issue → upgrade node\n│       └── Works → config path or key issue\n├── Auth error in logs?\n│   └── Yes → Regenerate API key → check scopes\n└── Tool shows but returns empty data?\n    └── Notion: did you share pages with integration?\n    └── Slack: check bot scopes\n    └── GitHub: check token permissions\n```\n\n---\n\n## Scoring Rubric: Are You Connected?\n\nScore your setup after completing Phase 5:\n\n| Check | Points |\n|-------|--------|\n| Tool appears in Claude's tool list | 20 |\n| Read test prompt returns real data | 30 |\n| Write test prompt succeeds | 30 |\n| No errors in MCP logs | 10 |\n| Cross-tool prompt works (multi-stack) | 10 |\n\n**80-100:** Fully connected. Ship it.\n**60-79:** Partial connection. Check scopes and restart.\n**Below 60:** Go back to Phase 2. Something in install/config is broken.\n\n---\n\n## Example Session\n\n**User prompt:**\n> \"Use this skill to connect me to GitHub\"\n\n**Agent response:**\n1. Runs Phase 1 checklist aloud (asks for token if missing)\n2. Provides Template 1 config block (pre-filled with user's token)\n3. Instructs restart\n4. Runs test prompts and confirms output\n5. Scores the setup using the rubric\n6. Suggests next integration (Notion → Slack → Linear)\n\n---\n\n## Bundle Note\n\nThis skill is part of the **AI Setup & Productivity Pack** ($79 bundle):\n- MCP Server Setup Kit ($19) — *you are here*\n- Agentic Loop Designer ($29)\n- AI OS Blueprint ($39)\n- Context Budget Optimizer ($19)\n- Non-Technical Agent Quickstart ($9)\n\nSave $36 with the full bundle. Built by [@Remy_Claw](https://remyclaw.com).\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":682,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772923363070,"updatedAt":1779077807278},"latestVersion":{"version":"1.0.0","createdAt":1772923363070,"changelog":"mcp-server-setup-kit 1.0.0 – Initial Release\n\n- Launches the 5-Minute Connect Protocol to streamline MCP server connections with Claude.\n- Step-by-step structured workflow for integrating Notion, Linear, Slack, and GitHub.\n- Provides pre-built, copy-paste config templates for all four tools, plus a unified multi-tool stack template.\n- Includes readiness checklists, troubleshooting decision tree, and scoring rubric for setup validation.\n- Designed to reduce setup friction and ensure reliable agent workflows in under 5 minutes per tool.","license":null},"metadata":null,"owner":{"handle":"flynndavid","userId":"s177ffnhcb6vrwyhv1s03gwvw9885276","displayName":"David F.","image":"https://avatars.githubusercontent.com/u/11565009?v=4"},"moderation":null}