MCP Server Card — /.well-known/ai-catalog.json

Hai tệp (SEP-2127 + AI Catalog 1.0):

GET /.well-known/ai-catalog.json
Content-Type: application/ai-catalog+json

{"specVersion": "1.0",
 "entries": [
  {"identifier": "urn:air:example.com:mcp:weather",
   "type": "application/mcp-server-card+json",
   "url": "https://example.com/mcp/server-card"}
 ]}

GET https://example.com/mcp/server-card
Accept: application/mcp-server-card+json

{"$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
 "name": "com.example/weather",
 "version": "1.0.0",
 "description": "Weather forecasts for any city.",
 "remotes": [{"type": "streamable-http", "url": "https://example.com/mcp"}]}

Các quy tắc chính: - Khám phá theo tên miền đi qua AI Catalog: có specVersion và mảng entries; mục MCP có type là application/mcp-server-card+json, một identifier, và đúng một trong hai: url (card nằm nơi khác — host nào cũng được) hoặc data (card nằm ngay trong catalog). - Card cần $schema (đúng URL schema server-card /v1/), name dạng namespace/name có một dấu gạch chéo, version (một phiên bản, không phải khoảng như ^1.2.0) và description (1-100 ký tự). - remotes liệt kê các endpoint: type là streamable-http hoặc sse, kèm url. Card không có remotes vẫn hợp lệ nhưng không cho client biết kết nối vào đâu. - Không có tools, resources hay prompts: chúng có thể khác nhau theo người dùng và phiên, nên client lấy qua tools/list sau khi kết nối. - Vị trí mặc định dành riêng cho card là <URL MCP của bạn>/server-card, ví dụ https://example.com/mcp/server-card.

Không phải định dạng chính thức: /.well-known/mcp.json (SEP-1649, đã đóng) và /.well-known/mcp/server-card.json (một bản nháp trước của SEP-2127, thường có object serverInfo và danh sách tools) là bản nháp cũ. Client theo SEP-2127 chỉ đọc AI Catalog.