Enhance MCP and Docker setup instructions in SDK tutorial

- Add brief MCP explanation with link to Claude Code MCP docs
- Include Docker quick setup guide with troubleshooting tips
- Fix git clone URL in README to point to anthropic-cookbook repo
- Keep instructions concise while providing helpful context for prerequisites

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
rodrigo olivares
2025-09-12 16:31:25 -04:00
parent 8abf96871d
commit 0af2dd6fa4
2 changed files with 5 additions and 17 deletions

View File

@@ -28,11 +28,7 @@
"cell_type": "markdown",
"id": "08cc95b6",
"metadata": {},
"source": [
"In the previous notebooks we have built a basic research agent and a Chief of Staff multi-agent framework. While the agents we have built are already powerful, they were still limited in what they could do: the web search agent is limited to searching the internet and our Chief of Staff agent was limited to interacting with its own filesystem.\n",
"\n",
"This is a serious constraint: real-world agents often need to interact with other systems like databases, APIs, file systems, and other specialized services. [MCP (Model Context Protocol)](https://modelcontextprotocol.io/docs/getting-started/intro) allows for an easy connection between our agents and these external systems. In this notebook, we will explore how to connect MCP servers to our agent."
]
"source": "In the previous notebooks we have built a basic research agent and a Chief of Staff multi-agent framework. While the agents we have built are already powerful, they were still limited in what they could do: the web search agent is limited to searching the internet and our Chief of Staff agent was limited to interacting with its own filesystem.\n\nThis is a serious constraint: real-world agents often need to interact with other systems like databases, APIs, file systems, and other specialized services. [MCP (Model Context Protocol)](https://modelcontextprotocol.io/docs/getting-started/intro) is an open-source standard for AI-tool integrations that allows for an easy connection between our agents and these external systems. In this notebook, we will explore how to connect MCP servers to our agent.\n\n**Need more details on MCP?** For comprehensive setup instructions, configuration best practices, and troubleshooting tips, see the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp)."
},
{
"cell_type": "markdown",
@@ -137,15 +133,7 @@
"cell_type": "markdown",
"id": "7fdb4aa2",
"metadata": {},
"source": [
"#### Step 1: Set up your GitHub Token\n",
"\n",
"You need a GitHub Personal Access Token. Get one [here](https://github.com/settings/personal-access-tokens/new) and put in the .env file as ```GITHUB_TOKEN=\"<token>\"```\n",
"> Note: When getting your token, select \"Fine-grained\" token with the default options (i.e., public repos, no account permissions), that'll be the easiest way to get this demo working.\n",
"\n",
"Also, for this example you will have to have [Docker](https://www.docker.com/products/docker-desktop/) running on your laptop.\n",
"#### Step 2: Define the mcp server and start the agent loop!"
]
"source": "#### Step 1: Set up your GitHub Token\n\nYou need a GitHub Personal Access Token. Get one [here](https://github.com/settings/personal-access-tokens/new) and put in the .env file as ```GITHUB_TOKEN=\"<token>\"```\n> Note: When getting your token, select \"Fine-grained\" token with the default options (i.e., public repos, no account permissions), that'll be the easiest way to get this demo working.\n\nAlso, for this example you will have to have [Docker](https://www.docker.com/products/docker-desktop/) running on your machine. Docker is required because the GitHub MCP server runs in a containerized environment for security and isolation.\n\n**Docker Quick Setup:**\n- Install Docker Desktop from [docker.com](https://www.docker.com/products/docker-desktop/)\n- Ensure Docker is running (you'll see the Docker icon in your system tray)\n- Verify with `docker --version` in your terminal\n- **Troubleshooting:** If Docker won't start, check that virtualization is enabled in your BIOS. For detailed setup instructions, see the [Docker documentation](https://docs.docker.com/get-docker/)\n\n#### Step 2: Define the mcp server and start the agent loop!"
},
{
"cell_type": "code",

View File

@@ -12,9 +12,9 @@ A tutorial series demonstrating how to build sophisticated general-purpose agent
#### 2. Clone and set up the project
```git clone https://github.com/anthropics/cc-sdk-tutorial.git ```
```git clone https://github.com/anthropics/anthropic-cookbook.git ```
```cd cc-sdk-tutorial ```
```cd anthropic-cookbook/claude_code_sdk```
```uv sync ```