← ContentsClaude Code · advanced

MCP server configuration in Claude Code

MCP (Model Context Protocol) is an open-source standard that lets Claude Code connect to external systems — databases, APIs, file systems, browsers, and other tools — through a consistent interface. When you configure an MCP server in Claude Code, you're telling Claude how to launch or connect to a process that exposes external capabilities as callable tools. Claude can then invoke those tools during a session to read files, query databases, open pull requests, or retrieve live metrics without the developer switching context. MCP servers can run in three ways: as local processes communicating over standard input/output (stdio), as remote services reachable over HTTP (using the streamable-http transport, formerly called SSE), or embedded directly in SDK applications. Each server definition lives in a configuration file — either a project-level .mcp.json committed to version control, or a personal ~/.claude.json entry scoped to your machine. Claude Code reads these files on startup and makes each server's tools available in the session. Configuration is managed through either the CLI command `claude mcp add` or by hand-editing the relevant JSON file. Active connections can be inspected at any time with the `/mcp` slash command inside a Claude Code session. Administrators on Team and Enterprise plans can also push and enforce MCP configurations org-wide through managed policy settings.

When you’d use it

  • Codebase-aware file navigationA developer wants Claude to understand the full project layout before suggesting refactors. By pointing the filesystem MCP server at the project directory, Claude can list and read files directly, producing suggestions that reference real paths and actual code rather than hypothetical snippets.
  • Issue tracker integrationAn engineering team uses Linear or Jira. By connecting Claude Code to the Linear MCP server, developers can say 'implement issue LIN-42' and Claude pulls the issue title, description, and acceptance criteria from Linear automatically, writes the code, and links back to the ticket.
  • Error tracking and live debuggingA backend engineer integrates the Sentry MCP server. When a production error fires, they ask Claude to investigate; Claude fetches the stack trace, breadcrumbs, and affected release directly from Sentry and proposes a fix — all without leaving the terminal.
  • Database querying during bug investigationA developer connects a read-only PostgreSQL MCP server to a staging database. When investigating a data corruption bug, Claude writes and executes SQL queries against the live staging data, cross-references results with the application logic, and identifies the root cause in one session.
  • Browser automation for UI testingA frontend developer connects the Playwright MCP server. Claude spins up a headless browser, navigates the local dev server, synthesizes the accessibility tree, and generates accurate end-to-end test files based on natural language descriptions of desired behavior.

What changed recently

  • 2025-11Remote MCP server support added to Claude Code. Developers can now connect to vendor-hosted HTTP MCP endpoints without managing local server processes. Configuration uses the 'http' type in .mcp.json or --transport http in the CLI.
  • 2025-11Claude Code plugins launched: installable bundles that can include MCP server configurations, slash commands, agents, and hooks, deployable with a single command.
  • 2025-11Desktop Extensions (.mcpb format) introduced for Claude Desktop, replacing the earlier .dxt format. Existing .dxt files continue to work but new extensions should use .mcpb.
  • 2026-03-16Claude Desktop extension installation locked to the in-app sanctioned registry — users can no longer drag-and-drop or click to install arbitrary .mcpb files from outside the registry. Version update support added: existing extensions can be updated in-place without removal and reinstallation.
This is the short version

The full chapter has three worked examples, the common pitfalls, and the workflow that makes it pay — plus the other 84 features, kept current.

Get Claude Master — $97
CLAUDEMASTER
An independent publication.
Independent product. Not affiliated with or endorsed by Anthropic. “Claude” is a trademark of Anthropic, used here only to describe the subject of this manual.
© 2026 Claude Master — All rights reserved.