Integrationer utan kod
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.jsonsom varje annan plugin — se den Plugin-SDK för denopenapiochmcptyper ochaihummer plugin validate.
Vart härnäst
- Plugin-SDK — manifestfält för
openapiochmcp. - Marknadsöversikt och nivåer — var zero-code (nivå 3) sitter.
- Personliga vs delade autentiseringsuppgifter — hur Valvhemligheter som dessa verktyg använder är avgränsade.