# mcp-management

> Install, configure, and troubleshoot MCP servers for Claude Code and Cursor.
Use when setting up new MCP connections, debugging MCP issues, or selecting
which MCP servers to add for a project.

- Author: Mahdi Khan
- Repository: mahdi-khaannn/agentic-templates
- Version: 20260207144042
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/mahdi-khaannn/agentic-templates
- Web: https://mule.run/skillshub/@@mahdi-khaannn/agentic-templates~mcp-management:20260207144042

---

---
name: mcp-management
description: |
  Install, configure, and troubleshoot MCP servers for Claude Code and Cursor.
  Use when setting up new MCP connections, debugging MCP issues, or selecting
  which MCP servers to add for a project.
---
# MCP Server Management

## When to Use
- Setting up a new project that needs external tool access
- Adding database, API, or service integration
- Troubleshooting MCP connection issues
- Choosing which MCP servers to install

## Key Files
- Claude Code: `~/.claude/settings.json` (mcpServers key)
- Cursor: `.cursor/mcp.json` (per-project) or Cursor Settings → MCP
- Reference catalog: `references/mcp-servers-catalog.md`
- Setup guide: `.claude/mcp-setup-guide.md`

## Installation Pattern (all servers follow this)
```json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@scope/mcp-server-name", ...extra-args],
      "env": { "API_KEY": "<value>" }
    }
  }
}
```

## Recommended Starter Set
1. memory (persistent KV across sessions)
2. filesystem (file access beyond workspace)
3. github (repos, issues, PRs)
4. fetch (URL content retrieval)
5. playwright (browser automation)
6. postgres/sqlite (database access)
7. context7 (library docs search — Cursor)
8. excalidraw (diagram creation — Claude Code)
9. brave-search (web search)
10. slack (team comms)

## Troubleshooting
- Server not appearing? → Restart Cursor/Claude Code
- Connection refused? → Check that npx can run the package
- Auth errors? → Verify env vars (tokens, keys)
- Slow? → Cursor uses dynamic MCP loading (only loads when needed)
- Too many tools? → Cursor syncs tool descriptions to folders for efficiency