AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Markkinapaikka ja lisäosat/Nollakoodin integraatiot

Nollakoodin integraatiot

v1.0.x · päivitetty 2026-07-05

Tier-3-lisäosat ovat nollakoodinen: teet olemassa olevan palvelun saataville agenteille kirjoittamatta tai ottamatta käyttöön mitään integraatiokoodia. On kaksi lähdetyyppiä — OpenAPI ja MCP — ja molemmat ratkaisevat salaisuutensa salatusta holvista sen sijaan, että ne olisi määritetty selväkielisenä.

OpenAPI: yksi työkalu per toimenpide

Kohdista AiHummer mihin tahansa OpenAPI 3.x erityisesti sen kautta spec_url ja alusta yhdistää yhden työkalun per toimenpide erityksessä. Jokaisesta operaatiosta tulee kutsuttava työkalu, jota agentti voi käyttää funktion kutsumisen vuorolla — ei liimakoodia, ei yksittäisen päätepisteen kytkentää.

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

Manifesti ei sisällä pluginin tunnistetta tai nimeä — ne tulevat luettelosta/paketista asennushetkellä (katso Liitännäisen SDK).

Autentikointi spesifikaation securityScheme:n kautta

Todennus on otettu suoraan spesifikaatiosta. AiHummer lukee OpenAPI:n securityScheme, ja todellinen salaisuus otetaan esiin holvi kutsun aikana — joten tunnistetietoja ei koskaan upoteta suoraan manifestiin, kehotteeseen tai lokiin.

[!NOTE] Syntetisoidut työkalut noudattavat spesifikaation omia toimintoja ja turvallisuutta. Pidä omasi OpenAPI-dokumentti tarkka: sen ilmoittamat toiminnot ovat täsmälleen ne työkalut, joita agentti näkee.

Valmiit henkilökohtaiset integraatiot (käyttäjäkohtaista OAuthia)

Tätä samaa OpenAPI-mekanismia tukee suuri joukko valmiita henkilökohtaiset integraatiot: jokainen on käyttäjäkohtaista OAuth-integraatiota, jonka henkilö liittää omaan tiliinsä, minkä jälkeen työkalut toimivat hänen puolestaan. Jo saatavilla ovat 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 ja muita. Henkilökohtaisen tilin liittäminen käsitellään yhteydet käyttäjäkohtaisesti.

MCP: yhdistä mihin tahansa palvelimeen

Toinen lähdetyyppi yhdistää minkä tahansa MCP-palvelin. AiHummer puhuu sille yli stdio- tai http-siirto, kutsuu sen tools/list, ja paljastaa palautetut työkalut agentille. Kuten OpenAPI:n kanssa, tähän ei tarvita integraatiokoodia.

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

Stdio-siirtopalvelin konfiguroidaan sitä käynnistävällä komennolla URL-osoitteen sijaan:

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

Salaisuudet holvin kautta → env

MCP-palvelimilla salaisuudet virtaavat holvista ympäristöön palvelin toimii. Tallennat salaisuuden kerralla holviin; AiHummer syöttää sen ympäristömuuttujana, kun käynnistät tai yhdistät palvelimeen, joten salainen aineisto pysyy poissa manifestista ja mallin kontekstista.

OpenAPI vs MCP yhdellä silmäyksellä

OpenAPI MCP
Syöte OpenAPI 3.x spec_url MCP-palvelin (stdio tai http)
Valmistetut työkalut Yksi per toiminto eritelmässä Mitä tahansa tools/list palauttaa
Todennus Speksin securityScheme → holvi Vault → palvelimen ympäristö
Koodi vaaditaan Ei mitään Ei mitään

Milloin käyttää mitäkin

  • Kurkottaa kohti OpenAPI kun palvelu jo julkaisee OpenAPI-dokumentin — saat sen täydellisen toimintojoukon työkaluina automaattisesti.
  • Kurkottaa kohti MCP kun haluat yhdistää olemassa olevaan MCP-palvelimeen tai suorittaa paikallinen työkalupalvelin over stdio.

[!TIP] Molemmat lähdetyypit määritellään saman yksittäisen tiedoston avulla manifest.json kuten jokainen muu lisäosa — katso Liitännäisen SDK varten openapi ja mcp lajit ja aihummer plugin validate.

Minne seuraavaksi