AiHummer
Русский▾
ВойтиЛичный кабинет
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплейс и плагины/Инструменты из OpenAPI и MCP без разработки

Инструменты из OpenAPI и MCP без разработки

v1.1.x · обновлено 2026-07-21

Плагины уровня 3 — интеграции без разработки: вы делаете существующий сервис доступным агентам без написания и развёртывания интеграционного кода. Есть два типа источников — OpenAPI и MCP — и оба берут свои секреты из зашифрованного хранилища секретов, а не из открытой конфигурации.

OpenAPI: по инструменту на операцию

Укажите AiHummer спецификацию OpenAPI 3.x, совместимую с перечисленными ниже ограничениями, через её spec_url — и платформа синтезирует по одному инструменту на каждую операцию спецификации. Каждая операция становится вызываемым инструментом, который агент может использовать во время обработки запроса с вызовом функций — без связующего кода и без ручной привязки каждого endpoint.

{
  "version": "1.0.0",
  "kind": "openapi",
  "scope": "shared",
  "openapi": {
    "spec_url": "https://api.acme.example/openapi.json"
  }
}

Системный идентификатор (slug) и имя плагина манифест не задаёт — они берутся из каталога/пакета при установке (см. Plugin SDK).

Авторизация через securityScheme спецификации

Авторизация берётся прямо из спецификации. AiHummer читает securityScheme OpenAPI, а сам секрет подтягивается из хранилища секретов во время вызова — поэтому доступ не вшивается в манифест, промпт или журналы.

[!NOTE] Синтезированные инструменты следуют собственным операциям и безопасности спецификации. Держите свой документ OpenAPI точным: объявленные в нём операции — это ровно те инструменты, которые увидит агент.

Готовые персональные интеграции (OAuth на пользователя)

Этот же механизм OpenAPI обеспечивает большой набор готовых персональных интеграций: каждая — это интеграция с OAuth на пользователя, которую человек подключает к своему аккаунту, после чего инструменты действуют от его имени. Уже доступны Gmail, Google Calendar, Google Contacts, Google Tasks, Google Drive, YouTube, Outlook Mail, Outlook Calendar, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings и другие. Подключение личных аккаунтов описано в Подключениях пользователей.

MCP: подключите любой сервер

Второй тип источника подключает любой MCP-сервер. AiHummer общается с ним по транспорту stdio или http, вызывает его tools/list и выставляет возвращённые инструменты агенту. Как и в случае OpenAPI, это не требует интеграционного кода.

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.acme.example/"
  }
}

Сервер на транспорте stdio настраивается командой запуска вместо URL:

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "stdio",
    "command": "my-mcp-server"
  }
}

Секреты через хранилище → окружение

Для MCP-серверов секреты идут из хранилища секретов в окружение, с которым запускается сервер. Вы храните секрет один раз в хранилище; AiHummer пробрасывает его как переменную окружения при запуске или подключении к серверу, поэтому ключевой материал остаётся вне манифеста и вне контекста модели.

OpenAPI и MCP кратко

OpenAPI MCP
Вход spec_url OpenAPI 3.x MCP-сервер (stdio или http)
Получаемые инструменты По одному на операцию спецификации То, что вернёт tools/list
Авторизация securityScheme спецификации → хранилище секретов Хранилище секретов → окружение сервера
Нужен код Нет Нет

Что когда выбирать

  • Берите OpenAPI, когда сервис уже публикует документ OpenAPI — вы автоматически получаете весь его набор операций как инструменты.
  • Берите MCP, когда хотите подключить существующий MCP-сервер или запустить локальный сервер инструментов по stdio.

[!TIP] Оба типа источников описываются тем же однофайловым manifest.json, что и любой другой плагин — см. Plugin SDK про виды openapi и mcp и aihummer plugin validate.

Куда дальше