AiHummer
Deutsch▾
AnmeldenKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Marktplatz und Plugins/Zero-Code-Integrationen

Zero-Code-Integrationen

v1.0.x · aktualisiert 2026-07-05

Die Tier-3-Plugins sind Null-Code: Sie machen einen bestehenden Dienst für Agenten verfügbar, ohne Integrationscode zu schreiben oder bereitzustellen. Es gibt zwei Quelltypen — OpenAPI und MCP — und beide lösen ihre Geheimnisse aus dem verschlüsselten Tresor und nicht aus der offenen Konfiguration.

OpenAPI: ein Werkzeug pro Operation

Richte AiHummer auf irgendetwas OpenAPI 3.x Spezifikation über ihr spec_url und die Plattform synthetisiert ein Werkzeug pro Operation in der Spezifikation. Jede Operation wird zu einem aufrufbaren Werkzeug, das der Agent während eines Funktionsaufrufs verwenden kann — kein Bindecode, keine pro-Endpunkt-Vernetzung.

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

Das Manifest enthält weder den Slug noch den Namen des Plugins – diese stammen beim Installationszeitpunkt aus dem Katalog/Bundle (siehe die Plugin-SDK).

Authentifizierung über das SecurityScheme der Spezifikation

Die Authentifizierung wird direkt aus der Spezifikation übernommen. AiHummer liest die OpenAPI. securityScheme, und das tatsächliche Geheimnis wird aus dem Tresor zur Aufrufzeit — sodass die Anmeldeinformationen niemals in das Manifest, die Eingabeaufforderung oder die Protokolle eingebettet werden.

[!NOTE] Die synthetisierten Werkzeuge folgen den eigenen Operationen und der Sicherheit der Spezifikation. Behalte deine OpenAPI-Dokument genau: Die Operationen, die es angibt, sind genau die Werkzeuge, die Agent wird sehen.

Fertige persönliche Integrationen (pro Benutzer OAuth)

Dieses gleiche OpenAPI-Mechanismus unterstützt eine große Menge an gebrauchsfertigen persönliche Integrationen: Jede ist eine pro Benutzer OAuth-Integration, die eine Person mit ihrem eigenen Konto verbindet, woraufhin die Tools in ihrem Namen handeln. Bereits verfügbar sind Gmail, Google Kalender, Google Kontakte, Google Aufgaben, Google Drive, YouTube, Outlook Mail, Outlook Kalender, OneDrive, Microsoft To Do, Todoist, Asana, Jira Cloud, ClickUp, GitLab, Fitbit, Oura Ring, Spotify, Samsung SmartThings und mehr. Das Verbinden eines persönlichen Kontos wird behandelt in pro Benutzer Verbindungen.

MCP: Verbinde jeden Server

Der zweite Quelltyp verbindet beliebige MCP-Server. AiHummer spricht darüber über ein stdio- oder http-Transport, nennt es tools/list, und stellt die zurückgegebenen Werkzeuge dem Agenten zur Verfügung. Wie bei OpenAPI ist dazu kein Integrationscode erforderlich.

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

Ein stdio-Transportserver wird durch den Befehl, der ihn startet, anstatt durch eine URL konfiguriert:

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

Geheimnisse über Tresor → env

Für MCP-Server fließen Geheimnisse aus dem Tresor in die Umwelt Der Server läuft mit. Sie speichern das Geheimnis einmal im Tresor; AiHummer injiziert es als Umgebungsvariable beim Starten oder Verbinden mit dem Server, sodass das geheime Material nicht im Manifest und nicht im Modellkontext erscheint.

OpenAPI vs MCP auf einen Blick

OpenAPI MCP
Eingabe Eine OpenAPI 3.x spec_url Ein MCP-Server (stdio oder http)
Werkzeuge hergestellt Eins pro Operation in der Spezifikation Was auch immer tools/list kehrt zurück
Auth Die Spezifikation securityScheme → Tresor Vault → env für den Server
Code erforderlich Keine Keine

Wann welches zu verwenden ist

  • Reich nach OpenAPI wenn der Dienst bereits ein OpenAPI-Dokument veröffentlicht — Sie erhalten automatisch den vollständigen Satz seiner Operationen als Werkzeuge.
  • Reich nach MCP wenn Sie eine bestehende MCP-Server verbinden möchten oder ein Lokaler Werkzeugserver über stdio.

[!TIP] Beide Quellentypen werden durch dieselbe Einzeldatei definiert. manifest.json wie jedes anderes Plugin — siehe das Plugin-SDK für die openapi und mcp Arten und aihummer plugin validate.

Wohin als Nächstes