ydc-claude-agent-sdk-integration

# Integrate Claude Agent SDK with You.com MCP

Interactive workflow to set up Claude Agent SDK with You.com's HTTP MCP server.

## Workflow

1. **Ask: Language Choice**
   * Python or TypeScript?

2. **If TypeScript - Ask: SDK Version**
   * v1 (stable, generator-based) or v2 (preview, send/receive pattern)?
   * Note: v2 requires TypeScript 5.2+ for `await using` support

3. **Install Package**
   * Python: `pip install claude-agent-sdk`
   * TypeScript: `npm install @anthropic-ai/claude-agent-sdk`

4. **Ask: Environment Variables**
   * Using standard `YDC_API_KEY` and `ANTHROPIC_API_KEY`?
   * Or custom names?
   * Have they set them?
   * If NO: Guide to get keys:
     - YDC_API_KEY: https://you.com/platform/api-keys
     - ANTHROPIC_API_KEY: https://console.anthropic.com/settings/keys

5. **Ask: File Location**
   * NEW file: Ask where to create and what to name
   * EXISTING file: Ask which file to integrate into (add HTTP MCP config)

6. **Create/Update File**

   **For NEW files:**
   * Use the complete template code from the "Complete Templates" section below
   * User can run immediately with their API keys set

   **For EXISTING files:**
   * Add HTTP MCP server configuration to their existing code
   * Python configuration block:
     ```python
     from claude_agent_sdk import query, ClaudeAgentOptions

     options = ClaudeAgentOptions(
         mcp_servers={
             "ydc": {
                 "type": "http",
                 "url": "https://api.you.com/mcp",
                 "headers": {
                     "Authorization": f"Bearer {os.getenv('YDC_API_KEY')}"
                 }
             }
         },
         allowed_tools=[
             "mcp__ydc__you_search",
             "mcp__ydc__you_express",
             "mcp__ydc__you_contents"
         ]
     )
     ```

   * TypeScript configuration block:
     ```typescript
     const options = {
       mcpServers: {
         ydc: {
           type: 'http' as const,
           url: 'https://api.yo...