From 0af2dd6fa4ba9b8839b7da7491f9e917f42d04a9 Mon Sep 17 00:00:00 2001 From: rodrigo olivares Date: Fri, 12 Sep 2025 16:31:25 -0400 Subject: [PATCH] Enhance MCP and Docker setup instructions in SDK tutorial MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- .../02_The_observability_agent.ipynb | 18 +++--------------- claude_code_sdk/README.md | 4 ++-- 2 files changed, 5 insertions(+), 17 deletions(-) diff --git a/claude_code_sdk/02_The_observability_agent.ipynb b/claude_code_sdk/02_The_observability_agent.ipynb index c3b97dc..8ea3a9c 100644 --- a/claude_code_sdk/02_The_observability_agent.ipynb +++ b/claude_code_sdk/02_The_observability_agent.ipynb @@ -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=\"\"```\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=\"\"```\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", @@ -462,4 +450,4 @@ }, "nbformat": 4, "nbformat_minor": 5 -} +} \ No newline at end of file diff --git a/claude_code_sdk/README.md b/claude_code_sdk/README.md index 3bf5107..705a32f 100644 --- a/claude_code_sdk/README.md +++ b/claude_code_sdk/README.md @@ -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 ```