# Как опубликовать

> Чтобы сервисы обнаружения нашли ваши MCP-серверы, навыки, агентов и API: создайте манифест ard.json, разместите его на домене и при желании добавьте запись DNS.

Страница: https://agenticresourcediscovery.ru/how_to_publish/
Оригинал на английском: https://agenticresourcediscovery.org/how_to_publish/
Указатель сайта: https://agenticresourcediscovery.ru/llms.txt

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

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

---

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

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

```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. Разместите манифест

Загрузите манифест на свой домен:
```text
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` |