MCP server cho AI agent: chúng là gì và cách kết nối một cái

Model Context Protocol (MCP) là chuẩn để AI agent gọi tool và resource bên ngoài trên một giao diện chung, thay vì mỗi agent tự viết glue cho mỗi dịch vụ. Client — Claude Desktop, Claude Code, Cursor, OpenCode, hoặc agent tùy chỉnh — kết nối MCP server và nhận catalog tool gọi được, mỗi cái có tên, mô tả, và schema. Agent quyết định khi nào gọi; server làm việc và trả kết quả.

AnyRouter chạy một server như vậy, lộ workspace — model, key, preset, credit, hội thoại, và trạng thái hệ thống — thành tool JSON-RPC. Thay vì script kiểm số dư hay liệt kê model, assistant gọi tool trực tiếp trên một endpoint ổn định:

https://anyrouter.dev/api/v1/mcp

Nó nói JSON-RPC 2.0 trên transport Streamable HTTP, nên MCP client chuẩn chỉ vào đó, không cần code tùy biến.

Server lộ catalog tool nhỏ, có scope — đủ để agent quản workspace thay bạn mà không thấy mật khẩu tài khoản hay toàn bộ bề mặt API:

Không có chat tool trong catalog là cố ý — inference ở Chat Completions, Messages, hoặc Responses, nên agent gọi MCP và agent gọi model chia cùng tài khoản mà MCP không nằm trên đường token.

Chỉ MCP client vào endpoint và xác thực một lần. Hầu hết client desktop đọc một khối JSON nhỏ; hình dưới chạy với client kiểu Claude Desktop hỗ trợ Streamable HTTP:

{
  "mcpServers": {
    "anyrouter": {
      "url": "https://anyrouter.dev/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ak_your_management_key"
      }
    }
  }
}

Xác thực là OAuth 2.1 bearer token, hoặc key tĩnh: LLM key (sk-ar-v1-…, chỉ cấp list_models) hoặc management key (ak_…) mang scope mà tool bạn gọi cần. Setup từng client cho Claude Desktop, Claude Code, Cursor và OpenCode nằm ở /docs/api-reference/mcp.

Trên màn hình OAuth consent, user chọn một gói scope — Read-only, Standard, hoặc Full — và có thể hạ thấp hơn client yêu cầu; lời gọi tool ngoài gói đã cấp trả lỗi permission-denied thay vì thành công im lặng. Tab MCP Gateway trên dashboard là nơi quản lý hàng ngày: kết nối client, xem tool nào lộ cho client nào, và đọc cùng audit trail bạn đã dùng cho inference — thêm hoặc thu hồi tool không nghĩa là sửa tay mọi file config client.

Agent đã nối MCP server để quản tài khoản vẫn gọi model qua bề mặt chuẩn tương thích OpenAI — cùng key, cùng base URL:

from openai import OpenAI

client = OpenAI(
  base_url="https://anyrouter.dev/api/v1",
  api_key="sk-ar-v1-...",
)
resp = client.chat.completions.create(
  model="anthropic/claude-opus-4-8",
  messages=[{"role": "user", "content": "Hello"}],
)

Tách biệt đó là cố ý: MCP tool để quản workspace agent vận hành, không để route token thêm một hop.