Անկոդ ինտեգրացիաներ

v1.2.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"
  }
}

Մանիֆեստը չի պարունակում նիշանիշ կամ հավելվածի անուն — դրանք վերցվում են կատալոգից/փաթեթից տեղադրման ժամանակ (տես։ Պլագինների զարգացման բազա).

Ավտենտիֆիկացիա 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"
  }
}

Գաղտնիքները պահոցով → env

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 ինչպես յուրաքանչյուրը այլ plugin — դիտեք Պլագինների զարգացման բազա համար openapi և mcp տարբեր տեսակներ եւ aihummer plugin validate.

Որտեղից հետո

Պլագինների զարգացման բազա — ցուցաբերել դաշտերը openapi և mcp.
Առևտրային հարթակի վերանայումը և մակարդակները — որտեղ zero-code (3-րդ մակարդակ) գտնվում է։
Անձնական և հանրային հավատարմագրման տեղեկություններ — ինչպես պահոցի գաղտնիքները, որոնց օգտվում են այս գործիքները, ունեն կիրառման ոլորտ։