8.1 Why Agents Need Hands¶
Your agent already has hands, technically — it reads files and runs commands in your project. But think about where your actual work lives: the calendar, the store dashboard, the database, the analytics, the design file, the CRM. This lesson is about the gap between the agent's world and yours — and why closing it is the single biggest capability jump since you installed Claude Code.
What you will learn
- See the gap: what an agent without connections can't do, no matter how smart.
- Understand tools as the third kind of context — live, queryable, current.
- Preview the two connection paths — MCP servers and CLIs — before going deep.
Builder principle
An agent's intelligence sets its ceiling; its connections set its floor. Most "the AI can't do X" complaints are missing hands, not missing brains.
The gap, concretely¶
Ask your current setup these perfectly reasonable requests:
- "What were my top-selling products last month?" — can't see your store.
- "Schedule the launch posts for Thursday morning." — can't touch your socials.
- "Which invoices are overdue?" — can't read your books.
- "Does the staging database have the new column?" — can't query it.
The model may be able to reason about these tasks, but it still needs authorized, correctly scoped access to the relevant systems. Without that reach, you manually transfer inputs and outputs. Connections can reduce that transfer work, but only when their security, reliability, and review costs are acceptable.
Tools are context — the live kind¶
Here's the frame that connects this chapter to everything since Chapter 5. You know three ways to get truth in front of the model: put it in the brief, put it in files, let it gather from the project. All three share a weakness — they're snapshots, current as of when someone wrote them down.
A tool is the fourth way: the agent queries the source at the moment of need.
| Context source | Freshness | Who does the work |
|---|---|---|
| Brief | When you wrote it | You |
| CLAUDE.md / second brain | Last update | You + agent |
| Project gathering | Now, but project-only | Agent |
| Tools | Now, any connected system | Agent |
This is why tool-connected agents feel like a different species. "What's overdue?" stops being a stale-data guess and becomes a fresh query. And it composes with everything you've built: a Skill whose process steps include tool calls is packaged expertise operating on live reality. (The invoice-chasing Skill that checks the actual books before drafting reminders — that's the combination, and you're two lessons from building things like it.)
The loop gets sharper too, at both ends: gather now includes querying real systems, and verify now includes checking real outcomes — "the event exists on the calendar" beats "I've drafted an event for you to create."
Two kinds of hands¶
Next lessons go deep; here's the map so you know where you're heading:
MCP servers (8.2–8.3) — programs that speak the Model Context Protocol, each offering a menu of tools for one system: a Postgres server offers query tools, a browser server offers navigate-and-click tools, a Figma server offers design-reading tools. The ecosystem is large and growing — official servers from major companies, community servers for everything else.
CLIs (8.4) — ordinary command-line programs (git, gh, curl, the AWS CLI…) that your agent can simply run, because it lives in a terminal and running commands is its native motion. No protocol, no setup beyond installing the tool. Often the simpler answer — knowing when each path wins is 8.4's whole job.
Both paths end the same place: your agent stops describing work in other systems and starts doing it — with your permissions gating every touch, which is 8.5's territory and the chapter's real graduation exam.
Try it now¶
Map your personal gap (paper exercise — connections start next lesson):
- List every system your real work touches weekly — calendar, store, socials, bank, database, design tool, all of it.
- For each: what's the task you'd delegate today if the agent could reach it?
- Mark each READ (agent needs to look) or WRITE (agent needs to act). Notice how many are read-only — that matters enormously for 8.5.
- Star the one with the best value-to-risk ratio: high usefulness, read-only, nothing catastrophic if misread. That star is your first connection, next lesson.
Check your understanding¶
- What's the "you're the glue again" problem, and which chapter first named it?
- Explain tools as the fourth context source — what makes them different from the other three?
- How do tools change the gather phase? The verify phase?
- Why does the READ vs. WRITE distinction matter before you've even learned the mechanics?