MCP server tutorial 2026: install, configure, run

MCP असल में है क्या

Model Context Protocol — एक specification जो Anthropic ने नवंबर 2024 में publish की थी. यह language models के लिए external tools call करने का — और external tools के लिए ख़ुद को models के सामने expose करने का — एक standard तरीका define करती है. MCP से पहले हर AI tool integration custom होता था; MCP integrations को composable बनाता है.

Architecture नाम से जितनी जटिल लगती है, उतनी है नहीं. MCP server एक ऐसा process है जो आपकी machine पर (या remotely, hosted servers के लिए) चलता है. जब Claude Code start होता है, तो वह हर configured MCP server launch करता है, उस server के provided tools की list receive करता है, और फिर session के दौरान उन tools को नाम से call कर सकता है. सारी communication stdin/stdout के ऊपर JSON-RPC 2.0 के साथ होती है. Local servers के लिए कोई HTTP नहीं, कोई ports नहीं, कोई network configuration नहीं.

Deeper conceptual treatment के लिए MCP क्या है primer देखें. यह post practical setup पर focused है.

Config कहाँ रहती है

MCP server configuration एक settings.json file में रहती है. दो locations हैं:

• ~/.claude/settings.json — global; इस machine पर हर Claude Code session पर apply होती है
• .claude/settings.json (एक project directory में) — project-level; सिर्फ़ तब apply होती है जब Claude Code उस directory में चले, और named keys के लिए global config को override करती है

Project-specific servers (एक database server जो किसी एक project के connection string के लिए scoped हो) के लिए project-level file को prefer करना चाहिए. जिन servers को आप everywhere चाहते हैं (Fetch, GitHub), उनके लिए global file है.

Basic config structure

settings.json में mcpServers key एक map है — server name से server configuration तक. हर server configuration बताती है कि server process कैसे start करना है.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/directory"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_fine_grained_token_here"
      }
    },
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

इस structure पर कुछ notes:

• npx पर -y flag package को install करता है अगर वो पहले से नहीं है. Setup के दौरान यह convenient है, लेकिन पहली बार launch थोड़ा slow हो जाता है. इसे avoid करने के लिए version pin कर सकते हैं: @modelcontextprotocol/server-filesystem@0.6.0.
• Credentials env object में जाते हैं, command-line args में नहीं. Args log होते हैं; environment variables (default में) नहीं होते.
• Server names (keys) arbitrary हैं — ये सिर्फ़ error messages और Claude के tool descriptions में use होते हैं.

पहले install करने वाले पाँच servers

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_TOKEN": "github_pat_..."
    }
  }
}

{
  "playwright": {
    "command": "npx",
    "args": ["-y", "@playwright/mcp@latest"]
  }
}

{
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

Server काम कर रहा है — कैसे verify करें

settings.json edit करने के बाद एक नया Claude Code session start कीजिए. Prompt पर Claude से available tools list करने को कहिए:

आपके पास कौनसे MCP tools का access है?

Claude को आपके configured servers और उनके available tools list करने चाहिए. अगर कोई server missing है, तो failure आम तौर पर तीन में से एक चीज़ है:

1. Package install नहीं हुआ. npx पर -y flag उसे install करेगा, लेकिन पहली run तब fail हो सकती है जब npm की registry slow हो या आपके network में firewall हो. Error देखने के लिए terminal में npx command manually चलाइए.
2. Path ग़लत है. Filesystem server एक absolute path लेता है. Relative path या typo वाला path startup failure देगा. Claude Code MCP server errors को ~/.claude/logs/ में log करता है — पहले वहीं check कीजिए.
3. Credential invalid है. अगर server start हो जाता है लेकिन उसके tools errors return करते हैं, तो सबसे common cause expired या misconfigured API key है. MCP layer को debug करने से पहले credential को सीधे curl में या provider के API playground में test कीजिए.

Project-level vs. global configuration

Septim पर एक common pattern: global config में Fetch, Memory, और Playwright रखते हैं — ऐसे servers जो किसी भी project में useful हैं. Project-level config में Filesystem (project root को allowed path के रूप में), project का database server, और GitHub (project के repo तक scoped).

इस structure का मतलब है — आप किसी भी project directory में जा सकते हैं और Claude Code अपने आप सही servers pick up कर लेगा, manually configs toggle किए बिना. Project-level file same name वाले servers के लिए global file को override करती है, ताकि आप बिना conflict के per project अलग database connections रख सकें.

Remote MCP servers

Anthropic ने early 2026 में remote MCP servers (stdio की जगह SSE पर accessed) के लिए support add किया. इसकी configuration command और args की जगह एक url key use करती है:

{
  "mcpServers": {
    "stripe": {
      "url": "https://mcp.stripe.com",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

उन services के लिए remote servers convenient हैं जो अपने hosted MCP endpoints maintain करती हैं (Stripe और कई दूसरे करते हैं). Tradeoff यह है — हर tool call पर एक network round-trip और credential wire के ऊपर जाता है. HTTPS-only remotes use कीजिए और authorization header को environment variable में एक API key की तरह ही treat कीजिए.

और servers add करने से पहले security पर विचार

हर add किया हुआ server आपके Claude Code session की attack surface बढ़ाता है. MCP server vulnerability checklist 24-point evaluation framework cover करती है. Tutorials के लिए short version:

• सिर्फ़ वो servers install कीजिए जिनके पास active organizational maintainer हो या backing company हो
• Install करने से पहले source में tool descriptions पढ़िए — tool metadata में embedded malicious instructions एक documented attack vector हैं (arXiv 2603.22489)
• Minimum credential scope use कीजिए — एक repo पढ़ने वाले GitHub token को सभी repos पर write access नहीं होना चाहिए
• अगर .claude/settings.json में credentials हैं, तो उसे git से बाहर रखिए

चलाने लायक servers की पूरी curated list — हर एक के साथ उसकी security caveat — best MCP servers 2026 post में है.