Chapter 14 – Connecting Systems with the Model Context Protocol (MCP)

This post is part of a series walking through key ideas from my book, Master Claude Chat, Cowork and Code. In the previous chapter we explored Agent Skills — reusable knowledge capsules that give Claude domain expertise. Today we zoom out to the connective tissue that lets Claude actually reach into the systems your team already uses.


The Problem: AI in a Silo

You can write the most brilliant prompt in the world, but if Claude can't read your Slack threads, pull your GitHub diffs, or check your Jira board, it's still operating with one hand tied behind its back. Chapter 14 tackles this head-on by introducing the Model Context Protocol (MCP) — a standardized, open interface that turns Claude from a smart chatbot into a connected participant in your actual workflow.

Think of MCP as a universal adapter. Instead of building bespoke integrations for every tool, MCP provides a single protocol layer through which Claude can discover, authenticate with, and interact with external services. The book walks through exactly how this works under the hood — the handshake, the capability negotiation, the security model — in a way that I won't spoil here.

Key idea: MCP is not another API wrapper. It's a protocol — a shared contract between Claude and any service that implements it. One integration pattern to learn, unlimited services to connect.

Four Integrations, One Pattern

The chapter doesn't stay theoretical for long. I walk through four concrete MCP configurations that cover the tools most teams live inside every day:

Slack — Claude reads channels, searches message history, and posts updates. The book shows the exact MCP server configuration, how scopes map to permissions, and the subtle difference between reading a thread versus reading a channel. If you've ever wished someone would just summarize what happened in #engineering while you were in back-to-back meetings, this is how you make that real.

GitHub — Pull requests, issues, code search, repository browsing. The integration lets Claude review diffs, comment on PRs, and cross-reference issues — all through the same MCP pattern. The book details how to scope permissions so Claude can read without accidentally merging your feature branch.

Jira — Sprint boards, ticket details, status transitions. Claude can pull the current sprint state, summarize blockers, and even draft ticket descriptions. The configuration walkthrough covers authentication tokens, project scoping, and how to keep Claude's access read-heavy until you're comfortable.

Google Drive — Documents, spreadsheets, shared folders. Claude gains the ability to read and reference files your team is already collaborating on, without anyone needing to copy-paste content into a chat window.

What I appreciated about writing this chapter was how uniform the setup feels. Once you understand one MCP configuration, the others follow naturally. The details differ — different auth tokens, different capability sets — but the mental model stays the same.

Important: MCP configurations involve authentication tokens and permission scopes. The book dedicates careful attention to the principle of least privilege — giving Claude exactly the access it needs and nothing more. I won't reproduce those security guidelines here, but they're essential reading before you connect production systems.

When Skills Meet MCP: The Compound Effect

Chapter 13 gave Claude knowledge through Skills. Chapter 14 gives Claude reach through MCP. The real magic happens when you combine both.

The book walks through a compelling example: automated sprint summary generation. Imagine a Skill that knows your team's reporting format, combined with MCP connections to Jira (for ticket status), GitHub (for merged PRs), and Slack (for posting the result). Claude doesn't just generate text — it gathers live data, structures it according to your team's conventions, and delivers it where people will actually see it.

This is the pattern that separates "AI assistant" from "AI teammate." The assistant answers when asked. The teammate participates in the workflow. MCP is what makes the teammate possible.

Key idea: Skills define what Claude knows. MCP defines what Claude can touch. Together, they create agents that don't just think well — they act effectively within the systems your team already depends on.

What I'm Holding Back

I will not spoil the full MCP configuration examples, the step-by-step security hardening process, or the detailed architecture diagrams that show how the protocol negotiation works. The book also covers edge cases — what happens when an MCP server is unreachable, how to handle token rotation, and how to test integrations safely in a staging environment before pointing Claude at production data. These are the details that separate a weekend experiment from a production-ready setup.

Want the full picture? Grab the book here for complete MCP configurations, security best practices, and the Skills+MCP compound workflow examples that turn Claude into a genuine integration point for your team's tools.

Next up — Chapter 15: Managing Context Rot and Entropy. As your Claude sessions grow longer and your integrations multiply, how do you keep context clean, relevant, and accurate? We'll explore the silent failure mode that catches even experienced users off guard.

2026-03-15

Sho Shimoda

I share and organize what I’ve learned and experienced.