AiHummer
Кыргызча▾
КирүүЖеке кабинет
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Маркетплейс жана плагиндер/Нөл коддуу интеграциялар

Нөл коддуу интеграциялар

v1.1.x · жаңыланды 2026-07-05

Үчүнчү деңгээлдеги плагиндер нөл-код: сиз бар болгон кызматты интеграция кодун жазбастан же жайгаштырбастан агенттерге жеткиликтүү кыласыз. Эки түрдүү булак бар — OpenAPI жана MCP — жана экөө тең ачык конфигурациядан эмес, шифрленген сактагычтан сырларын чечет.

OpenAPI: ар бир операция үчүн бир курал

AiHummerди каалаган нерсеге буруу OpenAPI 3.x спект анын аркылуу spec_url жана платформа Ар бир операция үчүн бир куралды синтездейт спецификацияда. Ар бир операция функция чакыруу кезинде агент колдоно ала турган чакырылышы мүмкүн болгон куралга айланат — эч кандай кошумча код, эч кандай жеке эндпоинт туташтыруу жок.

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

Манифестте плагиндин слагы же аты жок — алар орнотуу учурунда каталогдон/топтомдон келет (караңыз: Плагин SDK).

Спектин securityScheme аркылуу аутентификациялоо

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

[!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
Киргизүү OpenAPI 3.x spec_url MCP сервери (stdio же http)
Өндүрүлгөн аспаптар Спектеги операцияда бирден Эмне болбосун tools/list кайтаруулар
Аутентификация Спектин securityScheme → сейф Vault → сервер үчүн чөйрө
Код керек Жок Жок

Кайсысын кантип колдонуу керек

  • Кол созоо OpenAPI кызмат OpenAPI документин анын өзү жарыялаганда — Сиз анын толук операциялар топтомун куралдар катары автоматтык түрдө аласыз.
  • Кол созоо MCP эгер сиз бар MCP серверине туташкыңыз келсе, же иштеткиңиз келсе жергиликтүү курал сервери stdio аркылуу.

[!TIP] Эки булак түрү бир эле файл менен аныкталат manifest.json ар дайым башка плагин — караңыз Плагин SDK үчүн openapi жана mcp түрлөрү жана aihummer plugin validate.

Келерки кайда