Interactive workflow to set up Claude Agent SDK with You.com's HTTP MCP server.
await using supportpip install claude-agent-sdknpm install @anthropic-ai/claude-agent-sdkYDC_API_KEY and ANTHROPIC_API_KEY?For NEW files:
For EXISTING files:
```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
const options = {
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: Bearer ${process.env.YDC_API_KEY}
}
}
},
allowedTools: [
'mcp__ydc__you_search',
'mcp__ydc__you_express',
'mcp__ydc__you_contents'
]
};
```
Use these complete templates for new files. Each template is ready to run with your API keys set.
"""
Claude Agent SDK with You.com HTTP MCP Server
Python implementation with async/await pattern
"""
import os
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
# Validate environment variables
ydc_api_key = os.getenv("YDC_API_KEY")
anthropic_api_key = os.getenv("ANTHROPIC_API_KEY")
if not ydc_api_key:
raise ValueError(
"YDC_API_KEY environment variable is required. "
"Get your key at: https://you.com/platform/api-keys"
)
if not anthropic_api_key:
raise ValueError(
"ANTHROPIC_API_KEY environment variable is required. "
"Get your key at: https://console.anthropic.com/settings/keys"
)
async def main():
"""
Example: Search for AI news and get results from You.com MCP server
"""
# Configure Claude Agent with HTTP MCP server
options = ClaudeAgentOptions(
mcp_servers={
"ydc": {
"type": "http",
"url": "https://api.you.com/mcp",
"headers": {"Authorization": f"Bearer {ydc_api_key}"},
}
},
allowed_tools=[
"mcp__ydc__you_search",
"mcp__ydc__you_express",
"mcp__ydc__you_contents",
],
model="claude-sonnet-4-5-20250929",
)
# Query Claude with MCP tools available
async for message in query(
prompt="Search for the latest AI news from this week",
options=options,
):
# Handle different message types
if message.type == "text":
print(message.content)
elif message.type == "tool_use":
print(f"\n[Tool: {message.name}]")
print(f"Input: {message.input}")
elif message.type == "tool_result":
print(f"Result: {message.content}")
if __name__ == "__main__":
asyncio.run(main())
/**
* Claude Agent SDK with You.com HTTP MCP Server
* TypeScript v1 implementation with generator-based pattern
*/
import { query } from '@anthropic-ai/claude-agent-sdk';
// Validate environment variables
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
if (!ydcApiKey) {
throw new Error(
'YDC_API_KEY environment variable is required. ' +
'Get your key at: https://you.com/platform/api-keys'
);
}
if (!anthropicApiKey) {
throw new Error(
'ANTHROPIC_API_KEY environment variable is required. ' +
'Get your key at: https://console.anthropic.com/settings/keys'
);
}
/**
* Example: Search for AI news and get results from You.com MCP server
*/
async function main() {
// Query Claude with HTTP MCP configuration
const result = query({
prompt: 'Search for the latest AI news from this week',
options: {
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: `Bearer ${ydcApiKey}`,
},
},
},
allowedTools: [
'mcp__ydc__you_search',
'mcp__ydc__you_express',
'mcp__ydc__you_contents',
],
model: 'claude-sonnet-4-5-20250929',
},
});
// Process messages as they arrive
for await (const msg of result) {
if (msg.type === 'text') {
console.log(msg.content);
} else if (msg.type === 'tool_use') {
console.log(`\n[Tool: ${msg.name}]`);
console.log(`Input: ${JSON.stringify(msg.input, null, 2)}`);
} else if (msg.type === 'tool_result') {
console.log(`Result: ${msg.content}`);
}
}
}
main().catch(console.error);
/**
* Claude Agent SDK with You.com HTTP MCP Server
* TypeScript v2 implementation with send/receive pattern
* Requires TypeScript 5.2+ for 'await using' support
*/
import { unstable_v2_createSession } from '@anthropic-ai/claude-agent-sdk';
// Validate environment variables
const ydcApiKey = process.env.YDC_API_KEY;
const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
if (!ydcApiKey) {
throw new Error(
'YDC_API_KEY environment variable is required. ' +
'Get your key at: https://you.com/platform/api-keys'
);
}
if (!anthropicApiKey) {
throw new Error(
'ANTHROPIC_API_KEY environment variable is required. ' +
'Get your key at: https://console.anthropic.com/settings/keys'
);
}
/**
* Example: Search for AI news and get results from You.com MCP server
*/
async function main() {
// Create session with HTTP MCP configuration
// 'await using' ensures automatic cleanup when scope exits
await using session = unstable_v2_createSession({
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: `Bearer ${ydcApiKey}`,
},
},
},
allowedTools: [
'mcp__ydc__you_search',
'mcp__ydc__you_express',
'mcp__ydc__you_contents',
],
model: 'claude-sonnet-4-5-20250929',
});
// Send message to Claude
await session.send('Search for the latest AI news from this week');
// Receive and process messages
for await (const msg of session.receive()) {
if (msg.type === 'text') {
console.log(msg.content);
} else if (msg.type === 'tool_use') {
console.log(`\n[Tool: ${msg.name}]`);
console.log(`Input: ${JSON.stringify(msg.input, null, 2)}`);
} else if (msg.type === 'tool_result') {
console.log(`Result: ${msg.content}`);
}
}
}
main().catch(console.error);
All templates use You.com's HTTP MCP server for simplicity:
Python:
mcp_servers={
"ydc": {
"type": "http",
"url": "https://api.you.com/mcp",
"headers": {
"Authorization": f"Bearer {ydc_api_key}"
}
}
}
TypeScript:
mcpServers: {
ydc: {
type: 'http' as const,
url: 'https://api.you.com/mcp',
headers: {
Authorization: `Bearer ${ydcApiKey}`
}
}
}
Benefits of HTTP MCP:
After configuration, Claude can discover and use:
mcp__ydc__you_search - Web and news searchmcp__ydc__you_express - AI-powered answers with web contextmcp__ydc__you_contents - Web page content extractionBoth API keys are required:
# Add to your .env file or shell profile
export YDC_API_KEY="your-you-api-key-here"
export ANTHROPIC_API_KEY="your-anthropic-api-key-here"
Get your API keys:
Before completing:
claude-agent-sdk (Python) or @anthropic-ai/claude-agent-sdk (TypeScript)YDC_API_KEY and ANTHROPIC_API_KEYhttps://api.you.com/mcp)Bearer ${YDC_API_KEY}Python:
python your-file.py
TypeScript:
# With tsx (recommended for quick testing)
npx tsx your-file.ts
# Or compile and run
tsc your-file.ts && node your-file.js
Install the package:
# NPM
npm install @anthropic-ai/claude-agent-sdk
# Bun
bun add @anthropic-ai/claude-agent-sdk
# Yarn
yarn add @anthropic-ai/claude-agent-sdk
# pnpm
pnpm add @anthropic-ai/claude-agent-sdk
Set your You.com API key:
export YDC_API_KEY="your-api-key-here"
Get your key at: https://you.com/platform/api-keys
Set your Anthropic API key:
export ANTHROPIC_API_KEY="your-api-key-here"
Get your key at: https://console.anthropic.com/settings/keys
Verify your YDC_API_KEY is valid:
Bearer ${YDC_API_KEY}Ensure allowedTools includes the correct tool names:
mcp__ydc__you_search (not you_search)mcp__ydc__you_express (not you_express)mcp__ydc__you_contents (not you_contents)Tool names must include the mcp__ydc__ prefix.
The v2 SDK requires TypeScript 5.2+ for await using syntax.
Solution 1: Update TypeScript
npm install -D typescript@latest
Solution 2: Use manual cleanup
const session = unstable_v2_createSession({ /* options */ });
try {
await session.send('Your query');
for await (const msg of session.receive()) {
// Process messages
}
} finally {
session.close();
}
Solution 3: Use v1 SDK instead
Choose v1 during setup for broader TypeScript compatibility.
共 1 个版本