Claude Agent SDK: Bộ công cụ Agent MCP-Native của Anthropic

LangGraph, CrewAI và AutoGen đều hỗ trợ MCP như một tính năng có thể plug-in. Claude Agent SDK khác: MCP là nền tảng, không phải add-on.

Framework agent của Anthropic được xây dựng song song với spec MCP. Mọi agent trong SDK này nói MCP native — kết nối tools, đọc resources và quản lý prompts thông qua protocol. Nếu bạn đã theo dõi series MCP và Kiro của blog này, đây là framework được thiết kế từ đầu cho thế giới mà những bài đó mô tả.

Ra mắt đầu năm 2026, Claude Agent SDK nằm dưới Claude Code trong product stack của Anthropic. Claude Code là trải nghiệm IDE đầy đủ. SDK là thứ bạn dùng để xây dựng agent của riêng mình, tự động hóa workflow và nhúng khả năng của Claude vào ứng dụng.

Điều Gì Làm Nó Khác Biệt#

Ba quyết định thiết kế đặt Claude Agent SDK khác mọi framework khác:

1. Kiến Trúc MCP-Native#

Mọi framework khác coi MCP là một tùy chọn tích hợp. Claude Agent SDK không có “MCP adapter” — agent loop tự nó giao tiếp qua MCP.

1
from claude_agent import Agent, MCPConfig
2

3
agent = Agent(
4
    model="claude-sonnet-4",
5
    mcp_servers=[
6
        MCPConfig(command="npx", args=["-y", "@modelcontextprotocol/server-github"]),
7
        MCPConfig(command="node", args=["./my-mcp-server/index.js"]),
8
    ]
9
)

Agent kết nối MCP servers khi khởi động. Tools được tự động phát hiện qua MCP tools/list endpoint. Không cần đăng ký tool thủ công, không decorators, không function wrapping.

2. Tools là Resources, Không phải Functions#

1
# SDK: tool_use trả về MCP resource với structured content
2
agent.use_tool("search_docs", {"query": "authentication flow"})
3
# Trả về: typed content blocks (text, image, JSON)

Tools tạo typed content blocks thay vì raw strings. Agent suy luận về tool outputs chính xác hơn.

3. Computer Use Built In#

SDK bao gồm khả năng Computer — tính năng cho phép Claude nhìn screenshot, di chuyển cursor và tương tác với desktop apps:

1
from claude_agent.tools import Computer
2

3
agent = Agent(
4
    model="claude-sonnet-4",
5
    tools=[Computer()]
6
)

Hữu ích cho:

Testing UI workflows — QA tự động dùng interface thực
Legacy system integration — Tương tác hệ thống không API
Desktop automation — Quản lý file, điều khiển ứng dụng

Kiến Trúc Cốt Lõi#

Agent Loop#

1
agent = Agent(
2
    model="claude-sonnet-4",
3
    mcp_servers=[github_server, db_server, docs_server],
4
    system_prompt="Bạn là DevOps engineer."
5
)
6

7
response = await agent.run("Deploy bản build mới nhất lên staging")

Bạn có thể hook vào loop:

1
agent.on("tool_call", lambda tool, args: log_tool_usage(tool, args))
2
agent.on("tool_result", lambda result: validate_output(result))

Memory#

1
from claude_agent import Agent, FileMemory, PostgresMemory
2

3
agent = Agent(memory=FileMemory(path="./agent_memory"))
4
agent = Agent(memory=PostgresMemory(connection_string=os.getenv("DB_URL")))

Memory lưu: conversation history, preferences, tool output cache, session state.

Thinking Mode#

1
agent = Agent(model="claude-sonnet-4", thinking_budget=16000)
2

3
result = await agent.run_with_thinking(
4
    "Debug connection pool exhaustion",
5
    stream_thinking=True
6
)

Tool Composition#

1
from claude_agent import Tool, compose_tools
2

3
@Tool
4
def search_github_issues(repo: str, query: str): ...
5

6
@Tool
7
def read_issue(issue_url: str): ...
8

9
incident_response = compose_tools(
10
    "incident_response",
11
    tools=[search_github_issues, read_issue],
12
)
13

14
agent.add_tool(incident_response)

Composed tool xuất hiện như một capability đơn lẻ. SDK orchestrate sub-tools.

Claude Agent SDK vs Claude Code#

	Claude Agent SDK	Claude Code
Mục đích	Xây dựng agent tùy chỉnh	Coding tương tác
Interface	Python SDK	Terminal / IDE
MCP	Native	Plugin
Computer Use	Có	Không
Custom logic	Full control	Qua rules files
Triển khai	Infrastructure của bạn	Terminal của Anthropic

Claude Code là sản phẩm shipped. SDK là thứ bạn build với.

Khi Nào Chọn#

Phù hợp#

Kiến trúc MCP-heavy — Nhiều MCP servers, SDK xử lý native
Computer Use workflows — UI testing, desktop automation
Stack chỉ Anthropic — Claude là model provider duy nhất
Custom agent loops — Cần inspect, log, modify decision loop

Tránh khi#

Cần multi-model — SDK chỉ Claude
Team không dùng MCP — SDK assume MCP
Cần cross-repo orchestration — Đó là lãnh thổ Kiro
Team ưa LangChain — SDK không integration với LangChain

Tiếp Theo#

Bài	Framework
1	LangGraph
2	CrewAI
3	AutoGen
4	Claude Agent SDK (bài này)
5	OpenAI Agents SDK
6	So sánh cuối

Series: AI Agent Frameworks 2026 — So sánh Production. Bài 4: Claude Agent SDK. Bài 5: OpenAI Agents SDK → sắp tới.