AiHummer
Svenska
Logga inKonto
v1.1.x
{ }Swagger

Integrationer utan kod

v1.1.x · uppdaterad 2026-07-05

Tier-3-pluginsen är nollkod: du gör en befintlig tjänst tillgänglig för agenter utan att skriva eller distribuera någon integrationskod. Det finns två källtyper — OpenAPI och MCP — och båda hämtar sina hemligheter från det krypterade valvet snarare än från konfigurationen i klartext.

OpenAPI: ett verktyg per operation

Peka AiHummer på vilken som helst OpenAPI 3.x spec via dess spec_url och plattformen syntetiserar ett verktyg per operation i specifikationen. Varje operation blir ett anropbart verktyg som agenten kan använda under en funktionsanropssväng — ingen limkod, ingen per-endpoint koppling.

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

Manifestet innehåller inte pluginets slug eller namn — de kommer från katalogen/paketet vid installationstillfället (se Plugin-SDK).

Autentisering via specifikationens securityScheme

Autentisering tas direkt från specifikationen. AiHummer läser OpenAPI. securityScheme, och det faktiska hemligheten hämtas från valv vid samtalstid — så att autentiseringsuppgiften aldrig inlines i manifestet, prompten eller loggarna.

[!NOTE] De syntetiserade verktygen följer specifikationens egna operationer och säkerhet. Behåll din OpenAPI-dokument korrekt: de operationer som det deklarerar är exakt de verktyg som agenten kommer att se.

Färdiga personliga integrationer (per-användare OAuth)

Denna samma OpenAPI-mekanism stöder ett stort antal färdiga personliga integrationer: varje är en per-användare OAuth-integration som en person kopplar till sitt eget konto, varefter verktygen agerar på deras vägnar. Redan tillgängliga är Gmail, Google Kalender, Google Kontakter, Google Uppgifter, Google Drive, YouTube, Outlook Mail, Outlook Kalender, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings och mer. Att koppla ett personligt konto täcks i per-användaranslutningar.

MCP: anslut vilken server som helst

Den andra källtypen ansluter vilken som helst MCP-server. AiHummer pratar med den över en stdio eller http-transport, kallar sina tools/list, och exponerar de returnerade verktygen för agenten. Som med OpenAPI behövs ingen integrationskod.

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

En stdio-transportserver konfigureras av kommandot som startar den istället för en URL:

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

Hemligheter via valv → env

För MCP-servrar flödar hemligheter från valvet till miljön servern körs med. Du lagrar hemligheten en gång i valvet; AiHummer injicerar den som en miljövariabel när du startar eller ansluter till servern, så att det hemliga materialet hålls utanför manifestet och utanför modellens kontext.

OpenAPI vs MCP vid en snabb blick

OpenAPI MCP
Inmatning En OpenAPI 3.x spec_url En MCP-server (stdio eller http)
Verktyg producerade En per operation i specifikationen Vad som helst tools/list returnerar
Autentisering Specifikationen securityScheme → valv Vault → env för servern
Kod krävs Ingen Ingen

När man ska använda vilken

  • Sträcka sig efter OpenAPI när tjänsten redan publicerar ett OpenAPI-dokument — du får dess fulla uppsättning av funktioner som verktyg automatiskt.
  • Sträcka sig efter MCP när du vill ansluta en befintlig MCP-server, eller köra en lokal verktygsserver över stdio.

[!TIP] Båda källtyperna definieras av samma ensam-fil manifest.json som varje annan plugin — se den Plugin-SDK för den openapi och mcp typer och aihummer plugin validate.

Vart härnäst