MCP Server Setup Kit

Framework: The 5-Minute Connect Protocol
Worth $200/hr consultant time. Yours for $19.

What This Skill Does

Guides 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.

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.

The 5-Minute Connect Protocol

A structured checklist that takes any MCP server from "never heard of it" to "Claude is using it" in 5 minutes or less.

Phase 1 — Qualify (30 seconds)

Answer these before touching any config:

Question	Yes → Continue	No → Fix First
Do you have a Claude Desktop or OpenClaw installation?	✅	Install first
Do you have an API key / OAuth token for the target tool?

Config file locations:

- macOS: INLINECODE1
Windows: INLINECODE2
OpenClaw: ~/.openclaw/openclaw.json (mcpServers block)

Phase 2 — Install (2 minutes)

Universal install pattern:

CODEBLOCK0

Verify the binary works before touching config:

npx -y @modelcontextprotocol/server-github --help
# Should print usage/options — if it errors, fix here before config

Phase 3 — Configure (1 minute)

Add the server block to your config. Universal template:

CODEBLOCK2

Phase 4 — Test (90 seconds)

Use these verification prompts immediately after restart:

CODEBLOCK3

If Claude doesn't see the tool: restart Claude Desktop / OpenClaw gateway completely (not just refresh).

Phase 5 — Validate (30 seconds)

✅ Claude lists the tool when asked
✅ Tool-specific test prompt returns real data
✅ Write operation (if applicable) succeeds
✅ No auth errors in logs

Log check: ~/Library/Logs/Claude/mcp*.log (macOS)

5 Pre-Built Integration Templates

Template 1: GitHub MCP

Use case: Let Claude read repos, issues, PRs, and push code.

CODEBLOCK4

Token scopes needed: repo, read:user, read:org
Generate at: github.com → Settings → Developer Settings → Personal Access Tokens

5-Minute Connect test prompts:

1. INLINECODE8
INLINECODE9
INLINECODE10

Template 2: Notion MCP

Use case: Let Claude read/write Notion pages and databases.

CODEBLOCK5

Token setup: notion.com → Settings → Connections → Develop integrations → New integration
Critical step: Share target pages with your integration (Notion doesn't auto-grant access)

5-Minute Connect test prompts:

1. INLINECODE11
INLINECODE12
INLINECODE13

Template 3: Slack MCP

Use case: Let Claude read channels, send messages, search history.

CODEBLOCK6

Token setup: api.slack.com → Create App → OAuth & Permissions
Scopes needed: channels:read, chat:write, channels:history, INLINECODE17

5-Minute Connect test prompts:

1. INLINECODE18
INLINECODE19
INLINECODE20

Template 4: Linear MCP

Use case: Let Claude read/create/update Linear issues and projects.

CODEBLOCK7

Key setup: linear.app → Settings → API → Personal API Keys

5-Minute Connect test prompts:

1. INLINECODE21
INLINECODE22
INLINECODE23

Template 5: Multi-Tool Stack (All 4 at Once)

For teams who want the full setup in one shot:

CODEBLOCK8

Cross-tool test prompt:
"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"

Troubleshooting Decision Tree

CODEBLOCK9

Scoring Rubric: Are You Connected?

Score your setup after completing Phase 5:

Check	Points
Tool appears in Claude's tool list	20
Read test prompt returns real data

30 |
| Write test prompt succeeds | 30 |
| No errors in MCP logs | 10 |
| Cross-tool prompt works (multi-stack) | 10 |

80-100: Fully connected. Ship it.
60-79: Partial connection. Check scopes and restart.
Below 60: Go back to Phase 2. Something in install/config is broken.

Example Session

User prompt:

"Use this skill to connect me to GitHub"

Agent response:

1. Runs Phase 1 checklist aloud (asks for token if missing)
Provides Template 1 config block (pre-filled with user's token)
Instructs restart
Runs test prompts and confirms output
Scores the setup using the rubric
Suggests next integration (Notion → Slack → Linear)

Bundle Note

This skill is part of the AI Setup & Productivity Pack ($79 bundle):

- MCP Server Setup Kit ($19) — you are here
Agentic Loop Designer ($29)
AI OS Blueprint ($39)
Context Budget Optimizer ($19)
Non-Technical Agent Quickstart ($9)

Save $36 with the full bundle. Built by @RemyClaw.

MCP服务器搭建工具包

框架：5分钟连接协议
价值200美元/小时的顾问时间。仅需19美元。

本技能的作用

引导您使用模型上下文协议（MCP）将Claude连接到Notion、Linear、Slack和GitHub——通过一个专注的工作流程。无需反复试错。没有遗漏步骤。只需一个可在每个工具5分钟内测试的可用集成。

解决的问题： MCP搭建的摩擦是2026年团队放弃代理工作流的首要原因。文档存在但路径分散。本技能为您提供直达路径。

5分钟连接协议

一个结构化的检查清单，可在5分钟或更短时间内将任何MCP服务器从从未听说过变为Claude正在使用。

阶段1 — 资格确认（30秒）

在接触任何配置前回答以下问题：

问题	是 → 继续	否 → 先修复
您是否安装了Claude Desktop或OpenClaw？	✅	先安装
您是否有目标工具的API密钥/OAuth令牌？

配置文件位置：

- macOS：~/Library/Application Support/Claude/claudedesktopconfig.json
Windows：%APPDATA%\Claude\claudedesktopconfig.json
OpenClaw：~/.openclaw/openclaw.json（mcpServers块）

阶段2 — 安装（2分钟）

通用安装模式：

bash

对于基于NPX的MCP服务器（最常见）

npx -y @modelcontextprotocol/server-{工具名称}

对于基于Python的MCP服务器

pip install mcp-server-{工具名称} uvx mcp-server-{工具名称}

在接触配置前验证二进制文件是否可用：
bash
npx -y @modelcontextprotocol/server-github --help

应打印用法/选项 — 如果报错，在配置前在此处修复

阶段3 — 配置（1分钟）

将服务器块添加到您的配置中。通用模板：

json
{
mcpServers: {
{工具名称}: {
command: npx,
args: [-y, @modelcontextprotocol/server-{工具名称}],
env: {
{工具}APIKEY: 您的密钥在此处
}
}
}
}

阶段4 — 测试（90秒）

重启后立即使用以下验证提示：

列出我可用的MCP工具
你能用[工具名称]做什么？
[来自下方模板的特定工具测试提示]

如果Claude看不到该工具： 完全重启Claude Desktop / OpenClaw网关（不仅仅是刷新）。

阶段5 — 验证（30秒）

✅ 询问时Claude列出该工具
✅ 特定工具测试提示返回真实数据
✅ 写入操作（如适用）成功
✅ 日志中无认证错误

日志检查： ~/Library/Logs/Claude/mcp*.log（macOS）

5个预构建集成模板

模板1：GitHub MCP

用例： 让Claude读取仓库、议题、PR和推送代码。

json
{
mcpServers: {
github: {
command: npx,
args: [-y, @modelcontextprotocol/server-github],
env: {
GITHUBPERSONALACCESSTOKEN: ghp您的令牌在此处
}
}
}
}

所需令牌范围： repo、read:user、read:org
生成位置： github.com → 设置 → 开发者设置 → 个人访问令牌

5分钟连接测试提示：

1. 列出我所有仓库中开放的GitHub议题
有哪些PR等待我审核？
显示[您的仓库]的README

模板2：Notion MCP

用例： 让Claude读取/写入Notion页面和数据库。

json
{
mcpServers: {
notion: {
command: npx,
args: [-y, @modelcontextprotocol/server-notion],
env: {
NOTIONAPITOKEN: secret_您的令牌在此处
}
}
}
}

令牌设置： notion.com → 设置 → 连接 → 开发集成 → 新建集成
关键步骤： 与您的集成共享目标页面（Notion不会自动授予访问权限）

5分钟连接测试提示：

1. 列出我的Notion页面
在Notion中搜索[主题]
在[工作区]中创建一个标题为MCP测试的新页面

模板3：Slack MCP

用例： 让Claude读取频道、发送消息、搜索历史。

json
{
mcpServers: {
slack: {
command: npx,
args: [-y, @modelcontextprotocol/server-slack],
env: {
SLACKBOTTOKEN: xoxb-您的令牌,
SLACKTEAMID: T0XXXXXXX
}
}
}
}

令牌设置： api.slack.com → 创建应用 → OAuth与权限
所需范围： channels:read、chat:write、channels:history、users:read

5分钟连接测试提示：

1. 列出我的Slack频道
今天#general频道讨论了什么？
向#general发送MCP已连接！

模板4：Linear MCP

用例： 让Claude读取/创建/更新Linear议题和项目。

json
{
mcpServers: {
linear: {
command: npx,
args: [-y, @modelcontextprotocol/server-linear],
env: {
LINEARAPIKEY: linapi您的密钥在此处
}
}
}
}

关键设置： linear.app → 设置 → API → 个人API密钥

5分钟连接测试提示：

1. Linear中分配给我的议题有哪些？
显示我当前的冲刺
在[团队]中创建新的Linear议题：测试MCP连接

模板5：多工具堆栈（同时集成全部4个）

适用于希望一次性完成全部设置的团队：

json
{
mcpServers: {
github: {
command: npx,
args: [-y, @modelcontextprotocol/server-github],
env: { GITHUBPERSONALACCESSTOKEN: ghp... }
},
notion: {
command: npx,
args: [-y, @modelcontextprotocol/server-notion],
env: { NOTIONAPITOKEN: secret_... }
},
slack: {
command: npx,
args: [-y, @modelcontextprotocol/server-slack],
env: {
SLACKBOTTOKEN: xoxb-...,
SLACKTEAMID: T0...
}
},
linear: {
command: npx,
args: [-y, @modelcontextprotocol/server-linear],
env: { LINEARAPIKEY: linapi... }
}
}
}

跨工具测试提示：
使用我已连接的工具：总结我开放的Linear议题，查找相关的Notion文档，检查GitHub上开放的PR，并将摘要发布到Slack的#standup频道

故障排除决策树

Claude看不到我的MCP工具
├── 您是否完全重启了Claude？（不仅仅是刷新）
│ └── 否 → 完全重启 → 重试
├── 配置JSON是否有效？
│ └── 检查：jsonlint.com → 粘贴您的配置
├── 服务器二进制文件能否独立运行？
│ └── 运行：npx -y @modelcontextprotocol/server-{名称} --help
│ ├── 报错 → npm/node版本问题 → 升级node
│ └── 可用 → 配置路径或密钥问题
├── 日志中有认证错误？
│ └── 是 → 重新生成API密钥 → 检查范围
└── 工具显示但返回空数据？
└── Notion：您是否与集成共享了页面？

mcp-server-setup-kitMCP服务搭建工具