Кодсыз интеграциялар — AiHummer Құжаттама

Tier-3 плагиндері кодсыз: сіз бар қызметті агенттерге ешбір интеграция кодын жазбай немесе орналастырмай қолжетімді етесіз. Екі көз түрі бар — OpenAPI және MCP — және екеуі де өздерінің құпияларын ашық конфигурациядан емес, шифрланған қоймадан шешеді.

OpenAPI: әр операцияға бір құрал

AiHummer-ді spec_url арқылы кез келген OpenAPI 3.x спецификациясына бағыттаңыз, платформа спецификациядағы әр операцияға бір құрал синтездейді. Әр операция агент функция-шақыру кезеңінде пайдалана алатын шақырылатын құралға айналады — желімдеуші код жоқ, әр соңғы нүктеге жалғау жоқ.

{
  "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
Кіріс	OpenAPI 3.x `spec_url`	MCP сервері (stdio немесе http)
Шығарылатын құралдар	Спецификациядағы әр операцияға біреу	`tools/list` қайтарған кез келгені
Аутентификация	Спецификацияның `securityScheme`-і → қойма	Қойма → сервер үшін env
Қажет код	Жоқ	Жоқ

Қайсысын қашан пайдалану керек

Қызмет OpenAPI құжатын әлдеқашан жариялаған кезде OpenAPI-ге жүгініңіз — оның толық операциялар жиынтығын құралдар ретінде автоматты түрде аласыз.
Бар MCP серверін жалғағыңыз немесе жергілікті құрал серверін stdio арқылы іске қосқыңыз келгенде MCP-ге жүгініңіз.

[!TIP] Екі көз түрі де кез келген басқа плагин сияқты бір файлды дәл сол manifest.json-мен анықталады — openapi және mcp түрлері мен aihummer plugin validate үшін Плагин SDK бөлімін қараңыз.

Әрі қарай қайда

Плагин SDK — openapi және mcp үшін манифест өрістері.
Маркетплейс шолуы және дәрежелері — кодсыз (Tier 3) қайда орналасады.
Жеке мен ортақ тіркелгі деректері — бұл құралдар пайдаланатын қойма құпиялары қалай ауқымдалады.