Module 3 · Day 19

MCP Servers: Connecting External Tools to Claude Code

Day 18-এ Claude Code extend করার তিনটা হাতিয়ার শিখেছিলে, শেষ হয়েছিল “বাইরের tool/data → MCP” দিয়ে। আজ সেই চতুর্থ হাতিয়ার — MCP দিয়ে GitHub, database, Sentry-র সাথে যোগ। Tab থেকে tab-এ copy-paste বন্ধ — Claude নিজেই উৎস থেকে পড়বে।

~150 min read6 learning objectives

What you'll learn

•MCP কী বুঝা — বাইরের tool/data Claude-এ যোগ করার open standard (“AI-এর জন্য USB-C”)।
•কেন MCP — M×N আলাদা integration-এর জট থেকে একটা standard-এ (M+N) আসার গল্প।
•Host → client → server মডেল, আর local (stdio) বনাম remote (HTTP) server-এর পার্থক্য।
•একটা server তিনটা জিনিস দেয় — tools (action), resources (`@`-data), prompts (`/`-command)।
•নিজে server যোগ করা — `claude mcp add`, তিন scope (local/project/user), `/mcp` (এই lesson-এর হাতে-কলমে অংশ)।
•Trust ও lethal trifecta — কোন server লাগানো নিরাপদ, কোনটা বিপজ্জনক, কেন।

Before this

•Day 15 — tool use (Claude একটা function call করে; MCP সেই ধারণার বড় রূপ)।
•Day 16 — Claude Code-এর agentic loop ও permission।
•Day 18 — extend করার চার হাতিয়ার; শেষ হয়েছিল “বাইরের tool/data → MCP” দিয়ে।

Why MCP — the Integration Explosion

বারবার copy-paste করা — সেই ব্যথাটাই MCP সমাধান করে।

একটা চেনা দৃশ্য ভাবো — একটা GitHub issue-র লেখা copy করে Claude Code-এ paste করছো, একটু পর একটা log copy করছো, তারপর একটা query result। Day 15-এ tool use শিখেছিলে — Claude তোমার লেখা একটা function call করে। Day 18 শেষ হয়েছিল একটা লাইনে — বাইরের tool আর data-র জন্য আলাদা হাতিয়ার লাগে: MCP। আজ সেটাই — কীভাবে Claude Code সরাসরি বাইরের উৎস থেকে পড়ে, copy-paste ছাড়াই।

MCPModel Context Protocol

MCP হলো বাইরের tool আর data Claude-এর সাথে যোগ করার একটা open standard। ভাবো একটা USB-C port — একটাই socket, যেকোনো device (GitHub, তোমার database, Sentry, Notion) লাগিয়ে দাও। Claude Code তখন ওই tool সরাসরি পড়তে আর তাতে কাজ করতে পারে — তোমাকে আর tab থেকে tab-এ copy-paste করতে হয় না।

Why it matters

এই এক লাইনটা মাথায় রাখো: যখনই দেখবে অন্য একটা tool থেকে বারবার লেখা copy করে Claude-এ আনছ — issue, log, query result — তখনই একটা MCP server লাগানোর সময়। copy-paste বন্ধ, Claude নিজেই উৎস থেকে পড়বে।

M×N → M+Nকেন MCP দরকার হলো

MCP-র আগে প্রতিটা AI অ্যাপকে প্রতিটা tool-এর জন্য আলাদা connector লিখতে হতো। M অ্যাপ × N tool = M×N বেস্পোক জোড়া — জট, আর scale করানো কঠিন। MCP একটা common protocol দেয়: প্রতিটা অ্যাপ একবার শেখে, প্রতিটা tool একবার বলে → M+N। ঠিক যেমন এক USB-C cable দিয়ে ফোন, ল্যাপটপ, হেডফোন সব চার্জ হয়।

Why it matters

এই কারণেই আজ শত শত ready-made MCP server আছে (GitHub, Slack, Postgres, Figma…)। তুমি বানাও না, শুধু plug করো। standard থাকার এটাই সুবিধা — একজনের বানানো server সবাই use করতে পারে।

Interactive · কেন MCP

জট থেকে hub — M×N থেকে M+N

USB-C for AI

বাঁয়ে কয়েকটা AI অ্যাপ, ডানে কয়েকটা tool। দুটো mode চেপে দেখো — MCP ছাড়া কতগুলো আলাদা সংযোগ লাগে, আর MCP দিয়ে কত কমে যায়।

3×4 = 12

আলাদা bespoke connector

3+4 = 7

একটা standard, সবাই মানে

MCP আসার আগে: প্রতিটা AI অ্যাপকে প্রতিটা tool-এর জন্য আলাদা connector বানাতে হতো। ৩টা অ্যাপ × ৪টা tool = ১২টা আলাদা জোড়া। এক tool বদলালে সব অ্যাপে আবার কাজ। এটাই M×N জট।

মনে রেখো: মূল কথা: MCP নতুন কোনো model না, কোনো magic না — একটা common plug। একবার মানলে যেকোনো tool যেকোনো অ্যাপে লাগে।

Architecture — Host, Client, Server

তুমি host; প্রতি server-এর একটা client; server local বা remote।

MCP-র ধারণা বুঝলে, এবার টুকরোগুলো চেনো। তিনটা শব্দ — host, client, server — আর একটা প্র্যাক্টিক্যাল ফারাক: server তোমার নিজের মেশিনে চলছে, না কোথাও cloud-এ।

Host/client/serverটুকরোগুলো কীভাবে বসে

তিনটা শব্দ। Host = তুমি যে অ্যাপে আছো (Claude Code)। Server = আসল tool বা data উৎস (GitHub, তোমার DB)। আর প্রতিটা server-এর জন্য Claude একটা client খোলে — একটা server, একটা ডেডিকেটেড client। Server দু'ভাবে চলতে পারে: local (stdio — তোমার নিজের মেশিনে একটা process) বা remote (HTTP — cloud-এ, কেউ চালাচ্ছে)।

Why it matters

local বনাম remote ফারাকটা practical। Local stdio server তোমার ফাইল/DB-তে সরাসরি ঢোকে, নেটওয়ার্ক লাগে না — কিন্তু কোডটা তোমার মেশিনে চলে। Remote HTTP server cloud-এ, OAuth/token দিয়ে auth — সুবিধা, কিন্তু তোমার data বাইরের একটা service দেখছে। কোনটা use করছ, জেনে করো।

Interactive · টুকরোগুলো

Host → client → server

একটা server বাছো — দেখো Claude Code (host) কীভাবে ওর জন্য একটা client খুলে যোগ দেয়, আর server-টা তোমার মেশিনে (local) না cloud-এ (remote) চলছে।

Claude Code

host — তুমি এখানে

client

filesystem-এর জন্য একটা ডেডিকেটেড client

filesystem

local · stdio

কোথায় চলে: তোমার নিজের ল্যাপটপেnpx server-filesystem

Local server — তোমার মেশিনে একটা process হিসেবে চলে (stdio)। নেটওয়ার্ক লাগে না, সরাসরি ফাইল পড়ে।

এক লাইনে: তুমি (Claude Code) হলে host। প্রতিটা server-এর জন্য Claude একটা আলাদা client খোলে — একটা server, একটা client। server-টা তোমার মেশিনে (local/stdio) বা cloud-এ (remote/http) চলতে পারে — দু'টোকেই "server" বলে।

What a Server Exposes

শুধু tool না — পড়ার data আর তৈরি command-ও।

একটা ভুল ধারণা সবচেয়ে বেশি হয় — MCP মানে শুধু নতুন tool। আসলে একটা server তিন ধরনের জিনিস দিতে পারে। GitHub server-টাই উদাহরণ হিসেবে ভেঙে দেখা যাক।

Server primitivesএকটা server যা যা দেয়

একটা MCP server Claude-কে তিন ধরনের জিনিস দিতে পারে। Tools = action (নতুন PR বানাও, DB query করো)। Resources = পড়ার data, ঠিক file-এর মতো `@` দিয়ে টানো (`@github:issue://123`)। Prompts = তৈরি command, `/` দিয়ে চালাও (`/mcp__github__pr_review 456`)। সব server তিনটাই দেয় না — যেটা যা দেয়, `/mcp` দেখালে বোঝা যায়।

Why it matters

“MCP = বেশি tool” — এই অর্ধেক ছবিটা ভাঙা দরকার। Resources মানে তুমি বাইরের data file-এর মতো prompt-এ attach করতে পারো; prompts মানে server-ই তোমাকে ready-made command দেয়। action + data + command — তিনটাই।

Interactive · একটা server যা দেয়

github server তিন রকম জিনিস দেয়

অনেকে ভাবে MCP মানে শুধু নতুন tool (action)। আসলে server তিনটা জিনিস দেয়: tools (কাজ করে), resources (পড়ার data — file-এর মতো `@` দিয়ে টানো), আর prompts (তৈরি `/` command)।

create_pull_request

নতুন একটা PR বানায়।

list_issues

open issue-র লিস্ট এনে দেয়।

add_issue_comment

একটা issue-তে comment লেখে।

খেয়াল করো: resources file-এর মতো — prompt-এ @ দিয়ে টানো। prompts হলো server-এর তৈরি / command। শুধু tool না, তিনটাই।

Adding a Server — the Commands

একটা command, তিন scope — আজ থেকেই কাজে লাগবে।

ধারণা আর গঠন বোঝা হলো — এবার হাতে-কলমে। একটা server যোগ করার command একটাই প্যাটার্নে চলে; কোথায় থাকবে সেটা ঠিক করে scope।

claude mcp addযোগ করা + scope

যোগ করার command: `claude mcp add`। Remote হলে `--transport http <name> <url>` (দরকারে `--header` দিয়ে token), local হলে `--transport stdio <name> -- <command>`। কোথায় থাকবে সেটা scope ঠিক করে: local (শুধু তুমি, এই project — default) · project (পুরো টিম, git-এ `.mcp.json`) · user (তুমি, সব project)। ভিতরে `/mcp` দিয়ে status দেখো ও OAuth login করো।

Why it matters

scope-টা টিমওয়ার্কের চাবি। নিজের secret-ওয়ালা server → local (git-এ যাবে না)। পুরো টিমের দরকারি tool → project (`.mcp.json` commit করো, সবাই পায়)। এই command আর তিনটা scope — আজ থেকেই কাজে টাইপ করবে।

Interactive · নিজে যোগ করো

একটা server যোগ করার তিন ধাপ

রাফি তিনটা tool যোগ করবে। একটা বাছো — দেখো ঠিক কোন command টাইপ করবে, কীভাবে auth হবে, তারপর কী plain English-এ জিজ্ঞেস করবে। এই command গুলোই কাজে লাগবে।

remote (HTTP) — GitHub-এর cloud server

1যোগ করো — terminal-এ

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

2auth

GitHub থেকে একটা PAT (personal access token) বানিয়ে header-এ দাও।

3এবার শুধু English-এ জিজ্ঞেস করো

Review PR #456 and suggest improvements

রাফি issue/PR-র লেখা আর copy করে আনবে না — Claude সরাসরি GitHub থেকে পড়বে।

কোথায় থাকবে? — তিনটা scope

--scope local

Local (default)

Share: না — শুধু তুমি · ~/.claude.json

নিজের পরীক্ষামূলক server বা credential-ওয়ালা server — যেটা git-এ যেতে দিতে চাও না।

--scope project

Project

Share: হ্যাঁ — git-এ `.mcp.json` · .mcp.json (repo root)

পুরো টিম একই tool পাক চাইলে। `.mcp.json` commit করো — সবাই ক্লোন করলেই পেয়ে যায়। (security-র জন্য প্রথমবার approval চায়)।

--scope user

User

Share: না — শুধু তুমি, সব জায়গায় · ~/.claude.json

তোমার প্রিয় utility server — যেটা প্রতিটা project-এ লাগে।

যোগ করার পর manage:

claude mcp listযোগ করা সব server দেখো।

claude mcp get githubএকটা server-এর details।

claude mcp remove githubএকটা server সরাও।

/mcp(Claude Code-এর ভিতরে) status দেখা + OAuth login।

Trust & the Lethal Trifecta

যোগ করার আগে দুটো প্রশ্ন — উৎস চেনো, ঝুঁকি মাপো।

MCP যত সহজে tool যোগ করতে দেয়, ততটাই একটা দায়িত্ব দেয়। একটা server কোড চালায়, credential রাখতে পারে। যোগ করার আগে যাচাই না করলে বিপদ ডেকে আনতে পারো।

Lethal trifectaকোন server নিরাপদ

প্রতিটা server যোগ করার আগে দুটো প্রশ্ন। এক — কে বানিয়েছে, trust করো? (অচেনা gist-এর server = তোমার মেশিনে অচেনা কোড + তোমার data পাচারের পথ।) দুই — তোমার connected server-গুলো মিলে কি “lethal trifecta” সম্পূর্ণ করছে: private data পড়া + untrusted content ঢোকা + বাইরে পাঠানোর ক্ষমতা? তিনটা একসাথে হলে একটা বিষমাখা issue/web page তোমার secret বের করে নিতে পারে। তাই Claude Code project-scoped server চালানোর আগে approval চায়।

Why it matters

এটা ভয় দেখানোর জন্য না — শক্তির সাথে দায়িত্ব। MCP যত সহজে tool যোগ করতে দেয়, তত সহজে এই তিনটা ক্ষমতা অজান্তে এক জায়গায় জড়ো হয়। নিয়ম: শুধু বিশ্বস্ত server লাগাও, যা লাগে শুধু তাই, আর read-only রাখো যেখানে পারো। (পরের কোনো module-এ পুরো injection defense।)

Interactive · trust করার আগে

Lethal trifecta — কোন server লাগাবে?

রাফি তিনটা server ভাবছে। প্রতিটা চালু/বন্ধ করো — নিচের তিনটা আলো দেখো। তিনটাই জ্বললে lethal trifecta সম্পূর্ণ: একটা বিষমাখা issue তোমার secret পাচার করাতে পারে।

তোমার read-only Postgresনিরাপদ

তুমি নিজে বানিয়েছ · local stdio · read-only user

Private data

তুমি source-টা চেনো, read-only, আর local — বাইরে কিছু যায় না। private data ছোঁয় ঠিকই, কিন্তু তিনটার মধ্যে একটাই জ্বলছে।

GitHub (official)সাবধানে

GitHub নিজে প্রকাশ করেছে · remote HTTP

Private dataUntrusted content

Source বিশ্বস্ত, কিন্তু issue/PR-র লেখা অচেনা লোকে লেখে — তাই untrusted content ঢোকে। private data + untrusted content দুটো জ্বলে গেল। শুধু external comms বাকি।

FreeAnalytics-Proলাগিও না

অচেনা — এক random gist থেকে npx

External comms

এখানেই থামো। অচেনা কোড তোমার মেশিনে চলবে, আর "analytics"-এর নামে data বাইরে পাঠায়। source-ই trust করার মতো না — যোগই কোরো না।

connected server-গুলো মিলে কী জ্বলছে2 / 3

Private data

তোমার গোপন data পড়তে পারে (repo, DB, secret)।

Untrusted content

বাইরের অচেনা লেখা ঢোকে (issue body, web page, অন্যের PR)।

External comms

data বাইরে পাঠাতে পারে (request, link, message)।

তিনটার কম জ্বলছে — ঝুঁকি কম। তবু নিয়ম: শুধু বিশ্বস্ত server, যা লাগে শুধু তাই, যেখানে পারো read-only।

একটা established security framing: তিনটা ক্ষমতা একসাথে থাকলে বিপদ — (১) private data পড়া, (২) untrusted content ঢোকা, (৩) data বাইরে পাঠানো। তিনটা জ্বললে একটা poisoned issue বা web page Claude-কে দিয়ে তোমার secret পাচার করাতে পারে — Claude "বিগড়ে" গিয়ে না, শুধু নির্দেশ মেনে। MCP-তে আলাদা আলাদা source থেকে server মেশানো সহজ, তাই trifecta অজান্তেই সম্পূর্ণ হয়ে যায়।

Check Your Understanding

ভুল হলে সমস্যা নেই — প্রতিটার ব্যাখ্যা আছে।

Misconception check

MCP মানে নতুন, আরও স্মার্ট একটা AI model

Misconception check

MCP server মানেই cloud-এ চলা কোনো service

Misconception check

MCP শুধু নতুন tool (action) যোগ করে, আর কিছু না

Misconception check

অনলাইনে পাওয়া যেকোনো MCP server লাগানো নিরাপদ

Misconception check

MCP আর Day 15-র tool use একদম আলাদা দুই জিনিস

Quick check