Зеро-код аинтеграциақәа

{
  "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"
}

Tier-3 аплагинцәа **зеро-кодуп**: шәара иҟоу сервисык аагентцәа изыцшоу шәҟанаҵоит, аинтеграциа код аҩра ма адеплои ада. Ҩба источниктә ыҟоуп — **OpenAPI** насгьы **MCP** — нас урҭ ҩыџьагьы рсекретқәа аашифрхоу авольт аахьынтә ршьахьоит, ииаартны иҟоу аиҿкаара аахьынтә акәымкәа. ## OpenAPI: аоперациа-аоперациала инструмент Иарбна **OpenAPI 3.x** спек `spec_url` ала AiHummer ахь шәахьрыхәа, нас аплатформа **аоперациа-аоперациала инструмент синтез наулоит** аспек аҿы. Аоперациа-аоперациала аагент ифункциа-ааԥхьаратә шьаҟ аан ихархәо инструменткахьы иҟалоит — глеи-код ада, аендпоинт-аендпоинт ала аиԥшьра ада. ```json { "slug": "acme-api", "name": "Acme API", "version": "1.0.0", "kind": "openapi", "spec_url": "https://api.acme.example/openapi.json" } ``` ### Аутентификациа аспек ahaтә securityScheme ала Аутентификациа аспек аахьынтә иаахуп ииашаны. AiHummer ддырԥхьоит OpenAPI `securityScheme`, насгьы аиашатә секрет **авольт** аахьынтә иаахоит ааԥхьара аамҭазы — убри аҟынтә акредит манифест, апромпт ма алог аҩныҵҟа изланым. > [!NOTE] > Асинтезу инструментқәа аспек ahaтә аоперациақәеи ашәарҭадареи ирылагало. Шәара > шә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 насгьы уаҳа. Хаҭалатә аккаунт аидҳәалара иазааҭгылоуп [хархәаҩ-хархәаҩла Аидҳәалақәа](/en/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** азы шәахьрыхәа иҟоу MCP-серверк аидҳәалара ишәҭахзар, ма атыԥ инструмент сервер stdio ала ныҟәгара. > [!TIP] > Ҩба источниктә ауп иарбоу даҽа аплагинк ала еиԥш иҟоу зкоу акала `manifest.json` > ала иарбоу — шәахәаԥш [Аплагин SDK](/en/v1.0/marketplace/sdk) `openapi` насгьы > `mcp` тыԥқәа азы насгьы `aihummer plugin validate`. ## Аҩаҟа уаҳа - [Аплагин SDK](/en/v1.0/marketplace/sdk) — манифест афырҭқәа `openapi` насгьы `mcp` рзы. - [Амаркетплеис ахцәажәареи атиерқәеи](/en/v1.0/marketplace/overview-tiers) — зеро-код (Tier 3) ахьыҟоу. - [Хаҭалатә vs еицырзеиҟоу акредитқәа](/en/v1.0/access/personal-vs-shared) — ари инструментқәа ирхархәо авольт асекретқәа ишьахьоу.