gotoHuman

officiel

Plateforme d'intervention humaine - Permet aux agents IA et aux automatisations d'envoyer des demandes d'approbation vers votre boîte de réception gotoHuman.

GitHub
53

Que pouvez-vous faire avec Goto Human MCP ?

  • Liste des modèles de révision disponibles — Récupérez tous les modèles de révision de votre compte avec list-forms pour voir leurs identifiants et résumés de champs.
  • Obtenir le schéma d’un modèle de révision — Récupérez la structure exacte des champs et la configuration requises pour soumettre une révision via get-form-schema.
  • Demander une révision humaine — Soumettez du contenu généré par IA pour approbation en utilisant request-human-review-with-form, avec la possibilité d’assigner des réviseurs ou de lier des étapes dans un workflow multi-étapes.
  • Enchaîner les révisions dans un workflow — Passez un objet workflow avec runId et prevSteps pour connecter plusieurs étapes de révision humaine en une seule exécution suivie.

Documentation

Serveur MCP gotoHuman

gotoHuman facilite l'ajout d'approbations humaines aux agents IA et aux flux de travail agentiques.
Un flux de travail asynchrone entièrement géré avec une boucle humaine, doté d'une interface d'approbation personnalisable.
Bénéficiez de l'authentification intégrée, des webhooks, des notifications, des fonctionnalités d'équipe et d'un jeu de données d'entraînement évolutif.

Utilisez notre serveur MCP pour demander des approbations humaines depuis vos flux de travail IA via MCP, ou ajoutez-le à votre IDE pour faciliter l'intégration.

Installation

npx @gotohuman/mcp-server

Utilisation avec Cursor / Claude / Windsurf

{
  "mcpServers": {
    "gotoHuman": {
      "command": "npx",
      "args": ["-y", "@gotohuman/mcp-server"],
      "env": {
        "GOTOHUMAN_API_KEY": "your-api-key"
      }
    }
  }
}

Install MCP Server

Obtenez votre clé API et configurez une étape d'approbation sur app.gotohuman.com

Démo

Voici Cursor à gauche, mais cela pourrait être un agent en arrière-plan qui réagit également au webhook d'approbation.

https://github.com/user-attachments/assets/380a4223-ea77-4e24-90a5-52669b77f56f

Outils

list-forms

Liste tous les modèles de révision disponibles.

  • Renvoie une liste de tous les modèles de révision disponibles dans votre compte, incluant des informations générales sur les champs ajoutés

get-form-schema

Obtient le schéma à utiliser lors de la demande d'une révision humaine pour un modèle de révision donné.

  • Paramètres
    • formId : L'identifiant du modèle de révision pour lequel récupérer le schéma
  • Renvoie le schéma, en tenant compte des champs inclus et de leur configuration

request-human-review-with-form

Demande une révision humaine. Celle-ci apparaîtra dans votre boîte de réception gotoHuman.

  • Paramètres
    • formId : L'identifiant du modèle de révision à utiliser
    • fieldData : Contenu (sortie IA à réviser, contexte, etc.) et configuration des champs du modèle de révision.
      Le schéma correspondant doit être récupéré avec get-form-schema
    • config : Configuration du modèle de révision. Optionnel. Le schéma correspondant doit être récupéré avec get-form-schema
    • title : Titre optionnel affiché dans la boîte de réception et les notifications
    • webhookUrl : URL de webhook optionnelle pour cette demande (lorsque le modèle de révision n'a pas de webhook par défaut)
    • workflow : Objet optionnel liant cette révision à un flux de travail agentique à plusieurs étapes :
      • runId : Identifiant unique pour l'exécution actuelle du flux de travail. Utilisez le même runId pour chaque révision de la même exécution. Si workflow est envoyé sans runId (même {}), ou pour les déclenchements manuels, gotoHuman crée un runId et le renvoie en tant que workflowRunId pour les requêtes suivantes.
      • runName : Nom d'affichage optionnel pour l'exécution (peut être défini ou mis à jour à n'importe quelle étape)
      • prevSteps : Tableau d'reviewId provenant des étapes de révision gotoHuman précédentes (omettre lors de la première étape)
    • metadata : Données supplémentaires optionnelles qui seront incluses dans la réponse du webhook après la soumission du modèle de révision
    • assignToUsers : Liste optionnelle d'adresses e-mail d'utilisateurs à qui assigner la révision
  • Renvoie reviewId, reviewLink, et optionnellement workflowRunId lorsque gotoHuman a assigné une nouvelle exécution de flux de travail

Développement

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Exécuter localement dans un client MCP (par ex. Cursor / Claude / Windsurf)

{
"mcpServers": {
  "gotoHuman": {
    "command": "node",
    "args": ["/<absolute-path>/build/index.js"],
    "env": {
      "GOTOHUMAN_API_KEY": "your-api-key",
      "GOTOHUMAN_AGENT_ID": "your-agent-id"
    }
  }
}
}

[!NOTE] Pour Windows, le chemin args doit être C:\\<absolute-path>\\build\\index.js