AiHummer
Монгол▾
НэвтрэхБүртгэл
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Зах зээл ба нэмэлт програмууд/Шууд кодгүй интеграцчилал

Шууд кодгүй интеграцчилал

v1.2.x · шинэчилсэн 2026-07-05

Түгээмэл гурван түвшний нэмэлт программууд нь тэг-код: та аливаа интеграцийн код бичих эсвэл байрлуулалгүйгээр буй үйлчилгээний боломжийг агентуудад нээж өгдөг. Хоёр төрлийн эх үүсвэр байдаг — OpenAPI болон MCP — ба хоёр нь нууц бичигтэй агууднаас нууцаа оруулж шийддэг, нээлттэй тохиргооноос биш.

OpenAPI: үйлдэл бүрийн нэг хэрэгсэл

AiHummer-ийг ямар ч зүйлд зааж бай OpenAPI 3.x түүний SPEC-ийн дагуу spec_url мөн платформ нэг үйлдэлд нэг багажийг нийлэгжүүлдэг спецификацид. Тус бүр үйлдэл нь агент функц дуудалтын ээлжинд ашиглаж болох дуудах боломжтой хэрэгсэл болж хувирна — ямар ч наалтын кодгүй, ямар ч төгсгөл цэгийн холболтгүй.

{
  "version": "1.0.0",
  "kind": "openapi",
  "scope": "shared",
  "openapi": {
    "spec_url": "https://api.acme.example/openapi.json"
  }
}

Манифест нь залгаасны slug буюу нэрийг агуулдаггүй — эдгээр нь суулгах үед каталог/багцаас ирдэг (харна уу Плагин SDK).

Зааврын securityScheme-аар баталгаажуулах

Нэвтрэлт нь specification-оос шууд авсан. 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"
  }
}

Нууц үгс хадгалах сангаас → орчин

MCP серверүүдэд нууцууд урсдаг түрмээс орчныг чиглүүлэн сервер ажиллуулж байна. Та нууцыг нэг удаа хадгалах газарт хадгална; AiHummer серверийг эхлүүлэх эсвэл холбогдох үед үүнийг орчны хувьсагч болгон шахдаг, ингэснээр нууц материал нь бүртгэлээс болон загварын контекcтээс гадуур үлддэг.

OpenAPI ба MCP-ийг нэг харандаа

OpenAPI MCP
Оролт Нээлттэй API 3.x spec_url MCP сервер (stdio эсвэл http)
Үйлдвэрлэсэн багаж хэрэгсэл Үйлчилгээ бүрт нэг ширхэг Юун ч байсан tools/list буцаана
Нэвтрэлт Үзүүлэлтүүдийн securityScheme → сан Vault → серверийн орчны хувьсагч
Код шаардлагатай Юу ч үгүй Юу ч үгүй

Хэзээ ямарийг ашиглах вэ

  • Өргөхөд хүрэх OpenAPI хэрэв үйлчилгээ аль хэдийн OpenAPI баримт бичгийг нийтэлсэн бол — Та үүний бүх үйлдлийн багцыг багаж хэрэгсэл болгон автоматаар авдаг.
  • Өргөхөд хүрэх MCP өндөрлөгдсөн MCP сервертэй холбогдохыг хүсэх үед, эсвэл ажиллуулахыг орчин нутгийн хэрэгслийн сервер stdio-оор дамжуулан.

[!TIP] Хоёр эх үүсвэрийн төрлийг нэгэн файлаар тодорхойлсон байдаг manifest.json үгүйсгэх болгоныг бусад залгаас — үзнэ үү Плагин SDK өгсөн openapi болон mcp төрөлүүд ба aihummer plugin validate.

Дараа хаашаа явах вэ