AiHummer
Română▾
Autentificare
v1.0.x▾
v1.0.xstable
{ }Swagger
Marketplace și pluginuri/Integrări fără cod

Integrări fără cod

v1.0.x · actualizat 2026-06-26

Plugin-urile de nivel 3 sunt fără cod: faci disponibil un serviciu existent pentru agenți fără să scrii sau să implementezi vreun cod de integrare. Există două tipuri de sursă — OpenAPI și MCP — și ambele își rezolvă secretele din seiful criptat, nu din configurația în clar.

OpenAPI: un instrument per operație

Indică AiHummer către orice specificație OpenAPI 3.x prin spec_url-ul său, iar platforma sintetizează câte un instrument per operație din specificație. Fiecare operație devine un instrument apelabil pe care agentul îl poate folosi în timpul unei ture cu apel de funcție — fără cod de legătură, fără cablare per endpoint.

{
  "slug": "acme-api",
  "name": "Acme API",
  "version": "1.0.0",
  "kind": "openapi",
  "spec_url": "https://api.acme.example/openapi.json"
}

Autentificare prin securityScheme-ul specificației

Autentificarea este preluată direct din specificație. AiHummer citește securityScheme-ul OpenAPI, iar secretul propriu-zis este extras din seif la momentul apelului — astfel, acreditarea nu este niciodată inclusă în manifest, în prompt sau în jurnale.

[!NOTE] Instrumentele sintetizate urmează operațiile și securitatea proprii ale specificației. Păstrează documentul OpenAPI exact: operațiile pe care le declară sunt exact instrumentele pe care agentul le va vedea.

Integrări personale gata făcute (OAuth per utilizator)

Același mecanism OpenAPI susține un set mare de integrări personale gata făcute: fiecare este o integrare OAuth per utilizator pe care o persoană o conectează la propriul cont, după care instrumentele acționează în numele său. Deja disponibile sunt 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 și altele. Conectarea unui cont personal este descrisă în Conexiuni per utilizator.

MCP: conectează orice server

Al doilea tip de sursă conectează orice server MCP. AiHummer comunică cu acesta printr-un transport stdio sau http, apelează tools/list-ul său și expune agentului instrumentele returnate. La fel ca în cazul OpenAPI, acest lucru nu necesită niciun cod de integrare.

{
  "slug": "acme-mcp",
  "name": "Acme MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "http",
  "url": "https://mcp.acme.example/"
}

Un server cu transport stdio este configurat prin comanda care îl lansează, în loc de un URL:

{
  "slug": "local-mcp",
  "name": "Local MCP",
  "version": "1.0.0",
  "kind": "mcp",
  "transport": "stdio",
  "command": "my-mcp-server"
}

Secrete prin seif → mediu

Pentru serverele MCP, secretele circulă din seif în mediul în care rulează serverul. Stochezi secretul o singură dată în seif; AiHummer îl injectează ca variabilă de mediu la lansarea sau conectarea la server, astfel încât materialul secret rămâne în afara manifestului și în afara contextului modelului.

OpenAPI vs MCP pe scurt

OpenAPI MCP
Intrare Un spec_url OpenAPI 3.x Un server MCP (stdio sau http)
Instrumente produse Unul per operație din specificație Orice returnează tools/list
Autentificare securityScheme-ul specificației → seif Seif → mediu pentru server
Cod necesar Niciunul Niciunul

Când folosești care

  • Apelează la OpenAPI când serviciul publică deja un document OpenAPI — obții automat întregul său set de operații ca instrumente.
  • Apelează la MCP când vrei să conectezi un server MCP existent sau să rulezi un server de instrumente local prin stdio.

[!TIP] Ambele tipuri de sursă sunt definite de același manifest.json cu un singur fișier ca orice alt plugin — consultă SDK-ul pentru plugin-uri pentru tipurile openapi și mcp și aihummer plugin validate.

Unde mergi mai departe