AiHummer
Беларуская▾
Увайсці
v1.0.x▾
v1.0.xstable
{ }Swagger
Маркетплэйс і плагіны/Інтэграцыі без кода

Інтэграцыі без кода

v1.0.x · абноўлена 2026-06-26

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

OpenAPI: адзін інструмент на аперацыю

Пакажыце AiHummer на любую спецыфікацыю OpenAPI 3.x праз яе spec_url, і платформа сінтэзуе адзін інструмент на аперацыю ў спецыфікацыі. Кожная аперацыя становіцца выклікальным інструментам, які агент можа выкарыстоўваць падчас ходу з выклікам функцый — без склейваючага кода, без падключэння для кожнага эндпойнта.

{
  "slug": "acme-api",
  "name": "Acme API",
  "version": "1.0.0",
  "kind": "openapi",
  "spec_url": "https://api.acme.example/openapi.json"
}

Аўтэнтыфікацыя праз 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, гэта не патрабуе ніякага інтэграцыйнага кода.

{
  "slug": "acme-mcp",
  "name": "Acme MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "http",
  "url": "https://mcp.acme.example/"
}

Сервер з транспартам stdio наладжваецца камандай, якая яго запускае, замест URL:

{
  "slug": "local-mcp",
  "name": "Local MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "stdio",
  "command": "my-mcp-server"
}

Сакрэты праз сховішча → env

Для сервераў MCP сакрэты ідуць са сховішча ў асяроддзе, з якім запускаецца сервер. Вы захоўваеце сакрэт адзін раз у сховішчы; AiHummer ін’екцыруе яго як зменную асяроддзя пры запуску або падключэнні да сервера, таму матэрыял сакрэту застаецца па-за маніфестам і па-за кантэкстам мадэлі.

OpenAPI супраць MCP з аднаго погляду

OpenAPI MCP
Уваход spec_url OpenAPI 3.x Сервер MCP (stdio або http)
Створаныя інструменты Адзін на аперацыю ў спецыфікацыі Тое, што вяртае tools/list
Аўтэнтыфікацыя securityScheme спецыфікацыі → сховішча Сховішча → env для сервера
Патрэбны код Няма Няма

Калі што выкарыстоўваць

  • Звяртайцеся да OpenAPI, калі сэрвіс ужо публікуе дакумент OpenAPI — вы аўтаматычна атрымліваеце яго поўны набор аперацый як інструменты.
  • Звяртайцеся да MCP, калі вы хочаце падключыць існуючы сервер MCP або запусціць лакальны сервер інструментаў праз stdio.

[!TIP] Абодва тыпы крыніц вызначаюцца тым самым аднафайлавым manifest.json, што і кожны іншы плагін — гл. Plugin SDK для відаў openapi і mcp і aihummer plugin validate.

Куды далей