Теги

Тег — это категория, которая группирует связанные эндпоинты внутри коллекции. Теги могут присутствовать или отсутствовать — не все коллекции их имеют, и коллекция может содержать любое количество тегов.

Теги берутся из самого файла OpenAPI/Swagger/Postman. В YAML-конфиге нет настроек для тегов — вы не можете создавать, переименовывать или удалять теги в swag2mcp.yaml. Единственный способ изменить теги — отредактировать исходный файл спецификации.

Иерархия

Спецификация (domain, например "meteo")
  └── Коллекция (файл спецификации, например forecast.yml)
        └── Тег "weather"
              └── GET /forecast
              └── GET /forecast/hourly
        └── Тег "alerts"
              └── GET /alerts

Как создаются теги

Теги извлекаются из документа спецификации во время разбора:

OpenAPI 3.x / Swagger 2.0 — список tags каждой операции становится тегами:

paths:
  /pet:
    get:
      tags: ["pets"]
      summary: "Найти питомца по ID"
    post:
      tags: ["pets"]
      summary: "Добавить нового питомца"
  /pet/{petId}/uploadImage:
    post:
      tags: ["pet_images"]
      summary: "Загрузить изображение"

Postman — каждая папка верхнего уровня становится тегом. Вложенные папки используют имя последней папки.

Если у эндпоинта нет тегов, он помещается в тег "default".

Назначение

Теги помогают LLM находить группы связанных эндпоинтов. Вместо поиска по всем эндпоинтам коллекции LLM может сначала найти нужный тег, а затем вывести только эндпоинты внутри него.

MCP-инструменты для тегов

Инструмент	Описание
tag_by_spec	Все теги во всей спецификации
tag_by_collection	Теги в конкретной коллекции
tag_by_id	Детали тега (название, количество методов)
endpoint_by_tag	Эндпоинты, сгруппированные под тегом

Пример

Запрос: "Покажи все теги в коллекции pet"
→ tag_by_collection(collectionId: "...")
→ Результат: pets (5 методов), pet_images (1 метод)

Ограничения

• Теги доступны только для чтения с точки зрения конфига. Чтобы добавить, переименовать или удалить теги, отредактируйте исходный файл OpenAPI/Swagger/Postman и выполните swag2mcp update.
• Теги нельзя фильтровать или отключать для отдельных коллекций в YAML-конфиге.