MCP: connecting tools and data to any agent
Your agent can read files and run commands. But your work also lives in GitHub, Jira, Sentry, databases and internal APIs. The Model Context Protocol (MCP) is the open standard that plugs those systems into any AI tool, so one integration works in all five tools in this track.
1. The idea
MCP has three roles:
- The host is the AI app you use: Claude Code, Cursor, and so on.
- An MCP server is a small program that exposes one system (GitHub, Postgres, your inventory API) in the standard format.
- A client inside the host connects to each server.
A server can offer three kinds of things:
Tools
Actions the model can call, exactly like Module 06's tools: create_issue, run_query. Most servers are mainly tools.
Resources
Data to read: a file, a table schema, a document. In Claude Code you can reference them with @server:resource.
Prompts
Ready-made instructions or workflows the server provides, which you can pick in the host.
Servers connect in one of two ways: stdio (the host starts the server as a local program) or Streamable HTTP (a remote server at a URL, usually with sign-in). The current specification (version 2026-07-28) also defines optional extensions, such as long-running tasks and interactive "MCP Apps".
2. How it works
Step through what happens when you ask an agent to look at a production error, with a Sentry MCP server connected.
3. Try it yourself: one server, five config files
The server is the same everywhere; only the config file differs. Describe a server and get the setup for each tool. Secrets always come from environment variables, never typed into the file.
4. Why it matters at work
Pick integrations by the job, and start small:
| Job | Typical server | Tip |
|---|---|---|
| Issues and pull requests | GitHub, GitLab | A command-line tool the agent already runs (gh) is often simpler and cheaper than a server. |
| Tickets and planning | Jira, Linear | Read and comment first; create and transition later. |
| Production errors | Sentry, Datadog | Read-only; great for "find the cause of this error". |
| Databases | Postgres, MySQL | A read-only user on a non-production copy. Never production write access. |
| UI checks | Playwright and browser servers | Lets the agent look at its own UI work. |
| Documentation | Docs search servers | Grounding (Module 03) that cuts invented APIs. |
| Your own systems | Your MCP server (Module 16) | Start with two or three read-only tools. |
- Prefer official servers from the vendor of the system, found through the official MCP registry or the vendor's docs.
- Every server costs context. Its tool descriptions ride along on every request (Module 02). Connect what this repository needs.
- Least privilege. Scoped tokens, read-only database users, one repository rather than the whole organisation.
- Approve writes deliberately. Keep create, merge, delete and send tools on "ask".
- A server is code you run. Review it like a dependency, pin its version, and test it outside the agent with the MCP Inspector first.
- Server output is untrusted. An issue, web page or error message returned by a server can contain prompt-injection text (Module 18).
5. In your five tools
Same servers, different config files. Checked October 2026.
| Tool | Add a server | Shared with the team | Manage |
|---|---|---|---|
| Claude Code | claude mcp add NAME -- COMMAND or claude mcp add --transport http NAME URL | --scope project writes .mcp.json (commit it); local and user scopes stay private | /mcp: status, sign-in, tools |
| Antigravity CLI | Edit mcp_config.json | .agents/mcp_config.json in the workspace; ~/.gemini/config/mcp_config.json for you | /mcp |
| GitHub Copilot (VS Code) | Add to mcp.json (key servers; each needs a type) | .vscode/mcp.json in the workspace | The MCP servers view and the tools picker |
| Cursor | Edit mcp.json (key mcpServers), or install from the marketplace | .cursor/mcp.json in the project | Cursor settings: Tools & MCP |
| Codex CLI | codex mcp add NAME -- COMMAND or codex mcp add NAME --url URL | [mcp_servers.NAME] in config.toml | /mcp |
6. Remember it
How this hook works: what “USB-C for AI tools” means
What the slogan means, phrase by phrase
- “USB-C”
- A single standard connector that replaced dozens of special ones. MCP is that standard for connecting systems to AI apps: one protocol instead of a custom integration per tool.
- “for AI tools”
- The laptop is the host (Claude Code, Cursor…); the devices are MCP servers (GitHub, Postgres, Sentry). Any device fits any laptop.
- Implied: check before you plug in
- A USB stick from a stranger can be dangerous. A server is code running with your permissions: install from trusted sources, scope its access, approve its writes.
Why this picture fits: it captures both the value (portability: build once, use everywhere) and the risk (anything you plug in runs with your access), the two ideas you need when you decide which servers to connect.
The story → the concept
| USB | MCP |
|---|---|
| The laptop | The host: Claude Code, Antigravity, Copilot, Cursor, Codex |
| The port and protocol | MCP, over stdio or Streamable HTTP |
| A device (printer, drive) | An MCP server for one system |
| What the device can do | Its tools, resources and prompts |
| The device shows up automatically | The host lists the server's tools and gives them to the model |
| A suspicious USB stick | An unreviewed server with broad tokens |
Watch it on an example
- Your team adds the official Sentry server to
.mcp.json(Claude Code) and the same server to.cursor/mcp.jsonand.vscode/mcp.json. - Everyone, in any of the three tools, can ask "find the cause of yesterday's top error" and the agent reads real stack traces.
- The token is read-only and comes from an environment variable, so the agent can't resolve or delete issues, and nothing secret is committed.
The trap it saves you from
Two opposite ones: writing a custom integration per tool (MCP makes that unnecessary), and plugging in every server you find (each one adds context cost and attack surface).
It still works when…
You build your own server for an internal API (Module 16): the same USB-C plug, so your whole team gets it in whatever tool they prefer.
7. Common mistakes
${TOKEN}, bearer_token_env_var, or VS Code's prompted inputs). Config files get committed.8. Hands-on lab (roadmap week 10)
- Pick three servers your work needs (for example GitHub, your issue tracker, a docs server) from the official registry or the vendors' docs.
- Connect them at project scope in tool A using the generator above, and the same three in tool B.
- Check the context cost: compare
/context(or your tool's equivalent) before and after. - Use them on a real task, such as "summarise the open bugs labelled checkout and find the related code".
- Lock it down: make sure write tools ask first, and no token is in a committed file.
9. Self-check quiz
What is MCP's main benefit?
Which MCP feature lets the model perform actions like creating an issue?
Connecting a database server for your agent. Which credentials?
Why not connect every server you might need?
10. Go deeper
| Resource | Time | Why |
|---|---|---|
| modelcontextprotocol.io | 30 min | The official introduction, specification and SDKs. |
| MCP Course (Hugging Face) | Self-paced | Free, hands-on, from concepts to building servers. |
| The MCP registry | 10 min | Where to find servers, starting with official ones. |
| MCP in Claude Code and MCP servers in VS Code | 20 min | Scopes, sign-in and secrets in two tools. |