Skills and MCP servers both extend Claude Code, so they are easy to mix up. The short version: a skill is know-how, an MCP server is access.
What a skill is
A skill is a folder with a SKILL.md file: instructions, conventions and examples, optionally with supporting files and scripts. Claude Code keeps every skill's short description in context and loads the full instructions only when a task matches — or when you call it with /skill-name. Custom slash commands have been merged into skills, so a skill is also how you build your own /command.
What an MCP server is
MCP (Model Context Protocol) is an open standard for connecting AI tools to external systems. An MCP server gives Claude Code new tools — access to a database, an issue tracker, a design tool, an API. You add one with claude mcp add, for example:
claude mcp add --transport http notion https://mcp.notion.com/mcp
Servers can be scoped to one project, to all your projects, or shared with a team through a .mcp.json file in the repository.
Side by side
| Skill | MCP server | |
|---|---|---|
| Gives Claude | Instructions: how to do a task | Tools and data: what it can reach |
| Made of | Markdown (plus optional scripts) | A running server process or remote endpoint |
| Install | Copy a folder into .claude/skills/ | claude mcp add or .mcp.json |
| Typical examples | Commit-message rules, SEO audit checklist, test-writing conventions | Notion, GitHub, Postgres, browser automation |
| Best when | You keep repeating the same prompt or process | Claude needs to read or change something outside your files |
When to use which
- “Every time I ask for a PR description I paste the same template” → skill.
- “I want Claude to read tickets from our tracker” → MCP server.
- “I want Claude to triage tickets our way” → both: the MCP server provides access, the skill describes the triage process and which tools to use.
Combining them
The most useful setups pair the two. A skill can tell Claude which MCP tools to call, in what order and with what checks — turning raw access into a repeatable workflow. Skills can also pre-approve the specific tools they need with the allowed-tools field.
Looking for skills that work well alongside MCP? See the best MCP-related skills, or browse all topic guides.