AiHummer
Türkmençe
GirmekŞahsy kabinet
v1.0.x
{ }Swagger

Kodsyz integrasiýalar

v1.0.x · täzelendi 2026-07-05

3-nji derejeli goşundylary kodezsyz: siz bar bolan hyzmaty agentlere hiç hili birleşdirme koduny ýazman ýa-da goýbermezden elýeterli edýärsiňiz. Iki sany çeşme görnüşi bar — OpenAPI we MCP — we ikisi-de öz syrlaryny açyk konfigurasiýadan däl-de, şifrlenen gapytdan çözýärler.

OpenAPI: her amala bir gural

AiHummer-i islendik birine gönükdürüň OpenAPI 3.x spes öz üsti bilen spec_url we platforma her operasiýa üçin bir gurjagy düzýär spesifikasiýada. Her bir amalyyyat agentiň funksiýalary çagyrmak nobatynda ulanyp biljek çagyrlyp bilinýän guralyna öwrülýär — hoz däl kody, hiç hili aýratyn nokada baglanyşyk ýok.

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

Manifest pluginiň slugyny ýa-da adyny daşamaýar — olar gurnama wagty katalogdan/bülekden gelýär (garaň) Plugin SDK).

Spec-iň howpsuzlyk diagrammasy arkaly şahsyýet barlamak

Tassyklama göni spesifikasiýadan alynýar. AiHummer OpenAPI-i okaýar securityScheme, we hakyky syr çekilýär guşak jaň wagtynda — şonuň üçin şahadatnama hiç haçan manifest, çagyryş ýa-da ýazgylara göni girizilmeýär.

[!NOTE] Sintezlenen gurallar spesifikasiýanyň öz operasiýalaryna we howpsuzlygyna eýerýär. Saklaň OpenAPI resminamasy takyk: onuň yglan edýän operasiýalary anyk guraldyr agent görecek.

Täze taýýarlanan şahsy integrasiýalar (ulanyjy boýunça OAuth)

Şu birmeňzeş OpenAPI mehanizmi uly taýýarlanmış toplumy goldaýar şahsy birleşmeler: her biri ulanyjynyň öz hasabyna birikdirýän per-ulat OAuth integrasiýa bolup, şol hasaba birikdirenden soň enjamlar şahsy adyna hereket edýär. Indi elýeterli bolanlar 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 we başga many. Şahsy hasaby birikdirmek bu ýerde düşündürilýär ulanyjy boýunça aragatnaşyklar.

MCP: islendik serwere birikdiriň

Ikinji çeşme görnüşi islendik bilen baglanýar MCP serveri. AiHummer onuň bilen bir wagtyň içinde gürleşýär stdio ýa-da http transport, çagyrýar tools/list, we gaýtarylan enjamlar agentiň eline berýär. OpenAPI ýaly, munuň üçin hem kody birleşdirmek gerek däl.

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.acme.example/"
  }
}

stdio-transport serveri ony işledýän buýrugy arkaly URL-iň ýerine sazlanýar:

{
  "version": "1.0.0",
  "kind": "mcp",
  "scope": "shared",
  "mcp": {
    "transport": "stdio",
    "command": "my-mcp-server"
  }
}

Siriýetler howuz arkaly → gurşaw

MCP serwerleri üçin, gizlinlikler akýar kameradan daşky ortama Serweriň işleýän prosesi. Siz gizlinliginizi bir gezek howuzda saklaň; AiHummer serwere başlanda ýa-da baglananda ony gurşaw üýtgeýji hökmünde siňdirýär, şonuň üçin gizlin material manifestde hem-de model kontekstinden daşda galýar.

OpenAPI bilen MCP bir seredişde

OpenAPI MCP
Giriş Bir OpenAPI 3.x spec_url Bir MCP serveri (stdio ýa-da http)
Öndürilen gurallar Aýratynlykda her operasiýa üçin biri Haýsydyr biri tools/list gaýdyp gelýär
Tassyklaýyş Spesifikasiýanyň securityScheme → gapy Vault → serwer üçin gurşaw
Kod talap edilýär Hiç biri Hiç biri

Haçan haýsyny ulanmalydygy

  • El uzatmak OpenAPI hizmet öňünden OpenAPI resminamasyny çap edende — siz onuň doly işlemek toplumyny öňünden gural hökmünde alarsyňyz.
  • El uzatmak MCP bar bolan MCP serverine birikdirmek isleýän wagtyňyz ýa-da birini işledýän wagtyňyz ýerli gurallaryň serweri stdio arkaly.

[!TIP] Iň baý çeşme görnüşleriniň ikisi hem bir faýl tarapyndan kesgitlenýär manifest.json her bir ýaly başga goşmaça — gör Plugin SDK üçin openapi we mcp görnüşleri we aihummer plugin validate.

Indi nire?