Кодсуз интеграциялар

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

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

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

3-деңгээлдеги плагиндер **кодсуз**: учурдагы кызматты агенттерге эч кандай интеграция кодун жазбай же деплой кылбай жеткиликтүү кыласыз. Эки булак түрү бар — **OpenAPI** жана **MCP** — экөө тең сырларын ачык конфигурациядан эмес, шифрленген сейфтен чечет. ## OpenAPI: ар бир операцияга бирден курал AiHummerди каалаган **OpenAPI 3.x** спецификациясына анын `spec_url`и аркылуу көрсөтүңүз, платформа спецификациядагы **ар бир операцияга бирден курал синтездейт**. Ар бир операция функция-чакыруу кезеги учурунда агент колдоно турган чакырылуучу куралга айланат — жабыштыруучу код жок, ар бир акыр боюнча туташтыруу жок. ```json { "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 жана башкалар. Жеке аккаунтту туташтыруу [колдонуучу боюнча Туташуулар](/ky/v1.0/access/connections-oauth2) бөлүмүндө каралат. ## MCP: каалаган серверди туташтыруу Экинчи булак түрү каалаган **MCP серверин** туташтырат. AiHummer аны менен **stdio же http транспорту** аркылуу сүйлөшөт, анын `tools/list`ин чакырат жана кайтарылган куралдарды агентке ачат. OpenAPI сыяктуу эле, бул эч кандай интеграция кодун талап кылбайт. ```json { "slug": "acme-mcp", "name": "Acme MCP", "version": "1.0.0", "kind": "mcp", "transport": "http", "url": "https://mcp.acme.example/" } ``` stdio-транспорттук сервер URLдин ордуна аны иштеткен буйрук менен конфигурацияланат: ```json { "slug": "local-mcp", "name": "Local MCP", "version": "1.0.0", "kind": "mcp", "transport": "stdio", "command": "my-mcp-server" } ``` ### Сейф → env аркылуу сырлар MCP серверлери үчүн сырлар **сейфтен сервер иштеген чөйрөгө** агат. Сырды сейфке бир жолу сактайсыз; AiHummer аны серверди иштеткенде же ага туташканда чөйрө өзгөрмөсү катары инжекциялайт, ошондуктан сыр материалы манифесттен жана модель контекстинен сырткары калат. ## OpenAPI vs 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](/ky/v1.0/marketplace/sdk) бөлүмүн караңыз. ## Эми кайда - [Плагин SDK](/ky/v1.0/marketplace/sdk) — `openapi` жана `mcp` үчүн манифест талаалары. - [Маркетплейстин обзору жана деңгээлдери](/ky/v1.0/marketplace/overview-tiers) — кодсуз (3-деңгээл) кайда турат. - [Жеке vs жалпы эсептик дайындар](/ky/v1.0/access/personal-vs-shared) — бул куралдар колдонгон сейф сырлары кантип масштабталат.