Открыть свои агентные ресурсы (agentic resources) - MCP-серверы, навыки (Skills), агентов ACP, API - для сервисов обнаружения ARD можно в три простых шага.

Это руководство посвящено публикации в общедоступном интернете, чтобы публичные сервисы обнаружения могли обходить и индексировать ваши ресурсы. Публикация даёт возможность вас обнаружить, но не гарантирует, что какой-либо конкретный сервис, реализующий ARD, найдёт или проиндексирует вас; каждый сервис сам решает, что включать. Внутри предприятия агентные ресурсы часто собирают совсем другими рабочими процессами - через внутренний реестр, курируемый перечень или ленту поставщика, - а не открытым обходом интернета, поэтому уточните, как их собирает ваша организация.

---

Шаг 1. Создайте манифест (ard.json)

Создайте статический манифест ard.json со списком ваших агентных ресурсов. Ниже шаблон, который можно скопировать:

{
  "entries": [
    {
      "identifier": "urn:air:acme.com:server:weather",
      "displayName": "Acme Weather Telemetry Server",
      "type": "application/mcp-server+json",
      "url": "https://api.acme.com/mcp/weather.json",
      "capabilities": ["WeatherTool", "ForecastTool"],
      "description": "An enterprise weather MCP server providing live telemetry.",
      "representativeQueries": [
        "what is the current wind speed in Chicago",
        "get the 5-day forecast for Seattle"
      ]
    }
  ]
}

• identifier: имя должно следовать стандарту URN, привязанного к домену: urn:air:<your-domain>:<namespace>:<agent-name>.
• representativeQueries: укажите 2-5 запросов на естественном языке, чтобы обеспечить точный семантический векторный поиск.

---

Шаг 2. Разместите манифест

Загрузите манифест на свой домен:

https://<your-domain>/.well-known/ard.json

Убедитесь, что ваш веб-сервер отдаёт его со следующими параметрами:

• HTTPS: только защищённое соединение.
• Content-Type: application/json
• Заголовок CORS: Access-Control-Allow-Origin: * (критически важно, чтобы поисковые роботы могли его получить).

---

Шаг 3. Настройте обнаружение через DNS (необязательно)

Если вы не можете разместить файл по стандартному пути .well-known, опубликуйте DNS-запись TXT, указывающую прямо на расположение самого файла JSON (например, S3 или GitHub Pages):

Имя / хост	Тип	Значение
_catalog._agents.yourdomain.com	TXT	"url=https://custom-bucket.s3.amazonaws.com/ard.json"

Для динамических сервисов обнаружения (POST /search) опубликуйте запись SRV:

Имя / сервис	Тип	Порт	Цель
_search._agents.yourdomain.com	SRV	443	search.yourdomain.com