A practical guide to Claude Code MCP tools in 2025

Kenneth Pangan
Written by

Kenneth Pangan

Last edited September 8, 2026

Expert Verified
A practical guide to Claude Code MCP tools in 2025

Agentic coding isn't just a concept from a sci-fi movie anymore; it’s really happening, and Anthropic's Claude Code is one of the tools leading the charge. It’s an AI coding assistant that works right in your terminal, ready to help with complex tasks. But its real power gets unlocked when you let it talk to the outside world. That’s where the Model Context Protocol (MCP) comes in, acting as a universal bridge to external tools and data sources.

This guide will walk you through what these Claude Code MCP tools are, show you some powerful ways to use them, and get honest about the challenges of setting them up.

What are Claude Code MCP tools?

Before we go too deep, let's get the terminology straight. Think of it like this:

  • Claude Code is the AI assistant itself. It's the brain you chat with in your command-line interface to write, debug, and manage your code.
  • The Model Context Protocol (MCP) is the open-source standard that allows the AI to communicate with other applications. It’s sort of like a USB-C port for AI, creating a standard way to plug in different tools and data sources.
  • Claude Code MCP tools are the actual connectors, or servers, that make this communication happen. They are what allow Claude Code to do more than just generate text, they let it read files, query a database, or check a ticket in your project management app.

Claude Code can already run shell commands and work with local files. MCP adds a standard way to discover and call tools exposed by other systems. An eesel workspace is one example: the eesel CLI generates the details Claude Code needs to connect to it.

So, what can you actually do with Claude Code MCP tools?

When you connect Claude Code to your development environment, you can start automating some pretty complex workflows and move beyond just generating code snippets.

Automate your development lifecycle

Imagine connecting your AI assistant directly to your project management and version control systems. With MCP tools, you can stop switching between a dozen tabs and just issue commands from your terminal.

For example, you could ask Claude to, "implement the feature in Jira issue ENG-4521 and create a PR on GitHub." The AI can then connect to Jira to read the ticket, write the code, and use a GitHub MCP server or the gh CLI to open a pull request. You could also hook it up with tools like Linear to check on project status or update issues without ever leaving your command line.

Use live data and real-time services

One of the main drawbacks of any large language model is that its knowledge is static. MCP tools help solve this by giving Claude Code access to live information.

This opens up a lot of possibilities. You could connect it to your PostgreSQL database and ask questions in plain English, like, “find the emails of the first 10 users who signed up for the new feature.” Or, you could connect it to an error monitoring service like Sentry and ask, “check Sentry to see how often the bug from ENG-4521 is happening in production.” It can even connect to API design platforms like Apidog to grab the latest API specs and generate client code that matches perfectly.

Bridge the gap between design and code

The handoff from design to development can sometimes be a bit of a bottleneck. MCP tools can help smooth this out by connecting your AI directly to design platforms.

With a Figma MCP server, you could give Claude a prompt like, "update our email template using the new designs that were just shared in Figma." The AI can then access the design files, figure out what changed, and generate the right HTML and CSS. This not only saves a bunch of time but also cuts down on the chance of making a manual error during implementation.

How to set up Claude Code MCP tools

Okay, so you see the potential. Now for the practical part: how do you actually get these tools running? This is where things can get a little messy. The setup is powerful, but it's definitely designed for developers who are comfortable working in the terminal and editing config files.

The two paths to configuring

You generally have two ways to configure your Claude Code MCP tools. The standard method is using the claude mcp add command in your terminal. This kicks off a CLI wizard to walk you through the setup, but it’s not very forgiving. A single typo often means you have to kill the process and start all over again.

This gets even more complicated for Windows users, who often need to use a cmd /c wrapper to get Node.js-based servers to run correctly. It’s a known pain point that adds another layer of complexity to an already technical process.

The other option, which a lot of power users prefer, is to skip the CLI and edit the .claude.json configuration file directly. This gives you more control and makes it easier to manage complicated setups with a bunch of environment variables and API keys. Of course, this requires a solid understanding of JSON and the specific file structure Claude Code expects.

There are dozens of MCP servers out there, from official integrations to tools built by the community. Here are a few popular ones to give you an idea of what you can do.

Tool NameCore Use CaseSetup MethodKey Benefit
Atlassian MCPInteract with Jira tickets and Confluence docsRemote SSE Server (URL)Manage project tasks and look up documentation without leaving the terminal.
Sentry MCPMonitor errors and debug production issuesRemote HTTP Server (URL)Ask about application errors and check stack traces in real-time.
Notion MCPRead docs, update pages, and manage tasksRemote HTTP Server (URL)Integrate your project plans and knowledge from Notion into your coding workflow.
Puppeteer MCPAutomate web browser interactionsLocal Server (Requires Git clone & install)Run UI tests, scrape web content, and automate tasks in a browser.
File System MCPRead, write, and edit local filesLocal Server (Requires Git clone & install)Allows Claude to directly change your project's codebase, update READMEs, and manage files.
This video provides an overview of several popular MCP servers you can use to enhance your Claude Code workflow.

Challenges of the Claude Code MCP tools ecosystem

While the potential of MCP is huge, it's important to be realistic about the work involved. This ecosystem is a fantastic playground for developers building agentic workflows, but it has some challenges that make it a tough fit for broader business automation.

The setup and maintenance headache

As we've already touched on, getting started isn't exactly a walk in the park. You're dealing with a command-line interface, editing JSON files by hand, and securely managing all your API keys and environment variables. Each tool has its own setup quirks, and you can easily lose an afternoon to a frustrating debugging session. This all adds up to developer time, both for the initial setup and for ongoing maintenance when tools and APIs change.

Connect an existing eesel teammate through MCP

For support work, Claude Code can connect to an eesel workspace that already holds the teammate's knowledge, instructions, integrations, and activity. You can manage that connection through the eesel CLI, then operate the teammate from Claude Code.

The CLI, MCP connection, and dashboard all work with the same eesel agent and workspace. A support manager can review the instructions in the dashboard while a developer uses Claude Code to inspect the same setup. The coding session is the client; the eesel teammate keeps the company context and performs its configured work.

Set up eesel with the CLI

With Node.js 18.17 or newer, run the commands below. If you have several agents, add --agent <id-or-name> to the token command to select the intended teammate.

Bash
npx @eesel/cli login
npx @eesel/cli mcp token

Login opens your browser. The second command prints the MCP URL, authentication headers, and a ready-to-paste Claude Code connection command. If you have several agents, use npx @eesel/cli mcp token --agent <id-or-name> to generate the details for the intended teammate.

Paste the generated connection command into your terminal, restart Claude Code, and run claude mcp get eesel to check the connection. The eesel tools appear with an mcp__eesel__ prefix. The official MCP guide explains the headers and agent selection.

What Claude Code can do with the connection

Start with a concrete request such as checking which sources are connected or reviewing recent activity. The MCP tools let the client talk to the eesel agent, inspect status and billing, work with files, and manage instructions and automations according to your role.

Knowledge questions go through the teammate's chat tool. The files tool covers uploaded files and artifacts; connected ticket and article content is used by the agent when answering in chat. That distinction helps you choose the right tool when asking Claude Code to investigate a support question.

The connection uses the role captured when you generate the token and follows eesel approval rules. The token lasts 30 days. Generate a new one when it expires or your role changes, and treat it like a password.

When direct CLI commands are useful

You can also operate eesel without adding an MCP connection. Commands such as npx @eesel/cli status, npx @eesel/cli instructions, and npx @eesel/cli activity return JSON that a person, script, or coding agent can inspect. The CLI also supports uploading documents, chatting, connecting integrations, managing automations, and reviewing held actions.

For example, use npx @eesel/cli files upload ./refund-policy.pdf to add a policy and npx @eesel/cli chat "What is the refund policy?" to test an answer. Review the response before relying on it in a customer workflow. The --dry-run flag previews a write's server call without sending it, which is useful when reviewing setup changes.

Try eesel CLI with your Claude Code workflow

Choose a small support task to start: inspect the teammate's instructions, check its connected sources, and ask a question that depends on your own documentation. You can use explicit eesel CLI commands for those steps or generate an MCP connection so Claude Code can use the workspace tools directly.

Start with eesel CLI and review the results in the same dashboard your support team uses. The benefit is a shared teammate you can operate from the tools you already use, with its knowledge and controls kept together.

Frequently asked questions

What's the one big advantage I get from using Claude Code MCP tools compared to just using Claude Code by itself?

The main advantage is enabling Claude Code to interact with the outside world. Claude Code already has local file and shell tools. MCP extends that access to services exposed by compatible servers, including an eesel workspace connected through the eesel CLI.

Are the Claude Code MCP tools something a junior developer can set up, or are they really for senior engineers?

While anyone can try, the setup process is geared toward developers comfortable with the command line, editing JSON config files, and debugging server issues. A junior dev might find it challenging, as the CLI wizard isn't very forgiving and requires technical precision.

How do I securely manage API keys and secrets when I'm configuring different Claude Code MCP tools?

Securely managing credentials is a manual process that requires care. Most developers use environment variables or a dedicated secrets manager and then reference those variables within the `.claude.json` configuration file to avoid hardcoding sensitive information.

If there isn't a pre-built connector for my internal system, how difficult is it to build custom Claude Code MCP tools?

Building your own tool requires creating a server that conforms to the Model Context Protocol (MCP) standard. If you're comfortable building web servers and APIs, it's a feasible but non-trivial engineering task, as it involves handling all the communication between your service and the AI.

How do Claude Code MCP tools differ from the plugin ecosystems I've seen for other AI coding assistants?

The main difference is the open standard. MCP is an open-source protocol aiming for a universal way to connect tools to any compatible AI, whereas many other plugin ecosystems are proprietary and specific to a single platform, which can lead to vendor lock-in.

Are there any hidden costs associated with running Claude Code MCP tools, like server fees or API usage?

Yes, potentially. While many tools are open-source, you are responsible for any costs related to hosting them (if they run as local or remote servers you manage) and any API call costs for the third-party services they connect to, like Sentry or Jira.

Share this article

Kenneth Pangan

Article by

Kenneth Pangan

Writer and marketer for over ten years, Kenneth Pangan splits his time between history, politics, and art with plenty of interruptions from his dogs demanding attention.

Related Posts

All posts →
Illustration of three people reviewing access controls beside the Claude logo
Guides

Claude Code admin controls: a practical guide for IT and DevOps

Configure Claude Code settings, permissions, managed MCP, sandboxing, and server-managed controls without mistaking client policy for a security perimeter.

Rama Adi NugrahaRama Adi NugrahaJun 9, 2026
Illustration of a presenter pointing to a flip chart
Guides

Amazon Bedrock Claude Code: setup, model access, and limits

How to configure Claude Code through Amazon Bedrock, choose a current inference profile, manage IAM access, and validate the setup.

Kenneth PanganKenneth PanganSep 30, 2025
Claude Code lettering beside an illustrated person holding a gear.
Guides

Claude AI Mac apps: what Claude Desktop and Claude Code can do (2026)

A practical guide to Claude Desktop on Mac, Quick Entry, Cowork, Claude Code permissions, and a safe eesel support handoff.

Stevia PutriStevia PutriJan 9, 2026
Illustration of a person using a phone beside Claude Code lettering and raised question-mark signs.
Guides

7 Claude Code best practices for reliable, reviewable work

Seven practical Claude Code habits for scoped changes, clear context, permission review, and meaningful tests, plus a safe handoff when a code finding changes support guidance.

Kenneth PanganKenneth PanganSep 8, 2025
Black-and-white illustration of a person using a laptop, with code on a screen
Guides

A developer's Claude Code CLI reference (2026 guide)

A practical guide to installing Claude Code, using project instructions and hooks, connecting MCP tools, and reviewing work before it changes a codebase.

Rama Adi NugrahaRama Adi NugrahaJun 5, 2026
Claude Code lettering beside a person and a gear illustration
Guides

Claude Code for Desktop: local, cloud, and permission choices

Use Claude Code for Desktop across local, cloud, and SSH sessions. Learn what each environment can access, how permissions differ, and how eesel CLI fits a scoped support review.

Kurnia Kharisma Agung SamiadjieKurnia Kharisma Agung SamiadjieJan 9, 2026
Illustration of a person using a long-handled net beside three small round characters
Guides

Claude Code JetBrains integration: setup, context, and review

Set up Claude Code in JetBrains, understand selection sharing, diagnostics, remote development, and safe review, then compare an approved source snippet with an eesel teammate.

Kenneth PanganKenneth PanganSep 9, 2025
Illustration of a person tapping their wrist beside spokes labeled Opus, Sonnet, and Haiku, with an eesel symbol.
Guides

A practical guide to Claude Code model selection

Choose a Claude Code model by task, runtime, and provider, understand session versus saved defaults, and compare model explanations without changing your support teammate.

Kenneth PanganKenneth PanganSep 9, 2025
Black-and-white illustration of a person holding two telephone receivers, surrounded by speech bubbles, arrows, and a dollar symbol.
Guides

Claude Code Opus: a developer guide to deep reasoning and review

Learn where Claude Code with Opus 5 helps on deep repository work, how provider and permission boundaries shape it, and how to keep its evidence reviewable.

Kenneth PanganKenneth PanganSep 9, 2025

Ready to hire your AI teammate?

Set up in minutes. No credit card required.

Get started free