AiHummer
Norsk▾
Logg påKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Markedsplass og plugins/Ingen-kode-integrasjoner

Ingen-kode-integrasjoner

v1.2.x · oppdatert 2026-07-05

Tier-3-pluginene er null-kode: du gjør en eksisterende tjeneste tilgjengelig for agenter uten å skrive eller distribuere noen integrasjonskode. Det finnes to kildetyper — OpenAPI og MCP — og begge henter sine hemmeligheter fra det krypterte hvelvet i stedet for fra konfigurasjon i klartekst.

OpenAPI: ett verktøy per operasjon

Pek AiHummer på hvilken som helst OpenAPI 3.x spesifikasjon via dens spec_url og plattformen syntetiserer ett verktøy per operasjon i spesifikasjonen. Hver operasjon blir et kallbart verktøy agenten kan bruke under en funksjonsanropsrunde — ingen limkode, ingen tilkobling per endepunkt.

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

Manifestet inneholder ikke plug-inens slug eller navn — de kommer fra katalogen/pakken ved installasjonstidspunktet (se Plugin SDK).

Autentisering via spesifikasjonens sikkerhetsordning

Autentisering er hentet rett fra spesifikasjonen. AiHummer leser OpenAPI securityScheme, og den faktiske hemmeligheten hentes fra hvelv ved samtaletidspunkt — slik at legitimasjonen aldri blir innlagt i manifestet, meldingen eller loggene.

[!NOTE] De syntetiserte verktøyene følger spesifikasjonens egne operasjoner og sikkerhet. Hold din OpenAPI-dokument nøyaktig: operasjonene det erklærer er akkurat de verktøyene agent vil se.

Ferdige personlige integrasjoner (per-bruker OAuth)

Denne samme OpenAPI-mekanismen støtter et stort sett med ferdiglagde personlige integrasjoner: hver er en per-bruker OAuth-integrasjon som en person kobler til sin egen konto, hvoretter verktøyene handler på deres vegne. Allerede tilgjengelig er Gmail, Google Kalender, Google Kontakter, Google Oppgaver, Google Disk, YouTube, Outlook Mail, Outlook Kalender, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings og mer. Tilkobling av en personlig konto dekkes i per-bruker Tilkoblinger.

MCP: koble til hvilken som helst server

Den andre kildetypen kobler til enhver MCP-server. AiHummer snakker med den over en stdio eller http transport, kaller sitt tools/list, og eksponerer de returnerte verktøyene til agenten. Som med OpenAPI, krever dette ingen integrasjonskode.

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

En stdio-transportserver konfigureres av kommandoen som starter den i stedet for en URL:

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

Hemmeligheter via hvelv → env

For MCP-servere flyter hemmeligheter fra hvelvet ut i miljøet serveren kjører med. Du lagrer hemmeligheten én gang i hvelvet; AiHummer injiserer den som en miljøvariabel når du starter eller kobler til serveren, slik at hemmelighetsmaterialet holder seg ute av manifestet og ute av modellkonteksten.

OpenAPI vs MCP ved et blikk

OpenAPI MCP
Inndata En OpenAPI 3.x spec_url En MCP-server (stdio eller http)
Produserte verktøy Én per operasjon i spesifikasjonen Uansett tools/list returnerer
Autentisering Spesifikasjonen securityScheme → hvelv Vault → miljø for serveren
Kode kreves Ingen Ingen

Når man skal bruke hvilken

  • Rekke etter OpenAPI når tjenesten allerede publiserer et OpenAPI-dokument — du får hele driftssettet som verktøy automatisk.
  • Rekke etter MCP når du vil koble til en eksisterende MCP-server, eller kjøre en lokal verktøyserver over stdio.

[!TIP] Begge kildetypene defineres av samme én-fil manifest.json som hver annen plugin — se Plugin SDK for openapi og mcp typer og aihummer plugin validate.

Hvor til neste