Intégrations sans code

v1.1.x · mis à jour 2026-07-05

Les plugins de niveau 3 sont zéro-code: vous rendez un service existant disponible aux agents sans écrire ni déployer de code d’intégration. Il existe deux types de sources — OpenAPI et MCP — et tous deux résolvent leurs secrets à partir du coffre-fort chiffré plutôt qu’à partir de la configuration en clair.

OpenAPI : un outil par opération

Pointez AiHummer sur n’importe quoi OpenAPI 3.x spécification via son spec_url et la plateforme synthétise un outil par opération dans la spécification. Chaque opération devient un outil appelable que l’agent peut utiliser lors d’un tour d’appel de fonction — pas de code de liaison, pas de câblage par point de terminaison.

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

Le manifeste ne contient pas le slug ou le nom du plugin — ils proviennent du catalogue/du bundle au moment de l’installation (voir le SDK de plugin).

Authentification via le schéma de sécurité de la spécification

L’authentification est directement tirée de la spécification. AiHummer lit l’OpenAPI securityScheme, et le secret réel est extrait de coffre au moment de l’appel — ainsi, l’identifiant n’est jamais intégré dans le manifeste, l’invite ou les journaux.

[!NOTE] Les outils synthétisés suivent les opérations et la sécurité propres aux spécifications. Gardez vos Document OpenAPI précis : les opérations qu’il déclare sont exactement les outils que l’agent verra.

Intégrations personnelles prêtes à l’emploi (OAuth par utilisateur)

Ce même mécanisme OpenAPI soutient un grand ensemble de solutions prêtes à l’emploi intégrations personnelles: chacun est une intégration OAuth par utilisateur qu’une personne connecte à son propre compte, après quoi les outils agissent en son nom. Sont déjà disponibles 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 et plus encore. La connexion d’un compte personnel est couverte dans Connexions par utilisateur.

MCP : connecter n’importe quel serveur

Le deuxième type de source connecte n’importe quel Serveur MCP. AiHummer lui parle par-dessus transport stdio ou http, appelle son tools/list, et expose les outils retournés à l’agent. Comme avec OpenAPI, cela ne nécessite aucun code d’intégration.

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

Un serveur de transport stdio est configuré par la commande qui le lance au lieu d’une URL :

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

Secrets via coffre → env

Pour les serveurs MCP, les secrets circulent du coffre dans l’environnement Le serveur fonctionne avec. Vous stockez le secret une fois dans le coffre ; AiHummer l’injecte comme variable d’environnement lors du lancement ou de la connexion au serveur, de sorte que le matériel secret reste hors du manifeste et hors du contexte du modèle.

OpenAPI vs MCP en un coup d’œil

	OpenAPI	MCP
Entrée	Un OpenAPI 3.x `spec_url`	Un serveur MCP (stdio ou http)
Outils produits	Un par opération dans la spécification	Peu importe `tools/list` retours
Auth	Les spécifications `securityScheme` → salle des coffres	Vault → env pour le serveur
Code requis	aucune	aucune

Quand utiliser lequel

Atteindre pour OpenAPI lorsque le service publie déjà un document OpenAPI — vous obtenez automatiquement son ensemble complet d’opérations en tant qu’outils.
Atteindre pour MCP lorsque vous souhaitez connecter un serveur MCP existant, ou en exécuter un serveur d’outil local via stdio.

[!TIP] Les deux types de source sont définis par le même fichier unique manifest.json comme chaque autre plugin — voir le SDK de plugin pour le openapi et mcp types et aihummer plugin validate.

Où aller ensuite

SDK de plugin — champs de manifeste pour openapi et mcp.
Aperçu du marché et niveaux — où zero-code (Niveau 3) se situe.
Identifiants personnels vs partagés — comment le Les secrets du coffre-fort que ces outils utilisent sont limités.