gotoHuman

offiziell

Human-in-the-loop-Plattform – Erlauben Sie KI-Agenten und Automatisierungen, Genehmigungsanfragen an Ihr gotoHuman-Postfach zu senden.

GitHub
53

Was kann man mit Goto Human MCP machen?

  • List available review templates — Rufen Sie alle Bewertungsvorlagen in Ihrem Konto mit list-forms ab, um deren IDs und Feldzusammenfassungen zu sehen.
  • Get the schema for a review template — Rufen Sie die genaue Feldstruktur und Konfiguration ab, die zum Einreichen einer Bewertung über get-form-schema erforderlich ist.
  • Request a human review — Reichen Sie KI-generierte Inhalte zur Genehmigung mit request-human-review-with-form ein, wobei Sie optional Prüfer zuweisen oder Schritte in einen mehrstufigen Workflow-Ablauf verknüpfen können.
  • Chain reviews into a workflow — Übergeben Sie ein workflow-Objekt mit runId und prevSteps, um mehrere manuelle Überprüfungsschritte in einem einzigen verfolgten Durchlauf zu verbinden.

Dokumentation

gotoHuman MCP Server

gotoHuman macht es einfach, menschliche Genehmigungen zu KI-Agenten und agentischen Workflows hinzuzufügen.
Ein vollständig verwalteter asynchroner Human-in-the-Loop-Workflow mit einer anpassbaren Genehmigungs-UI.
Profitieren Sie von integrierter Authentifizierung, Webhooks, Benachrichtigungen, Teamfunktionen und einem wachsenden Trainingsdatensatz.

Verwenden Sie unseren MCP-Server, um menschliche Genehmigungen aus Ihren KI-Workflows über MCP anzufordern, oder fügen Sie ihn Ihrer IDE hinzu, um die Integration zu erleichtern.

Installation

npx @gotohuman/mcp-server

Verwendung mit Cursor / Claude / Windsurf

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

Install MCP Server

Holen Sie sich Ihren API-Schlüssel und richten Sie einen Genehmigungsschritt unter app.gotohuman.com ein.

Demo

Links ist Cursor zu sehen, aber dies könnte auch ein Hintergrundagent sein, der ebenfalls auf den Genehmigungs-Webhook reagiert.

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

Werkzeuge

list-forms

Listet alle verfügbaren Überprüfungsvorlagen auf.

  • Gibt zurück eine Liste aller verfügbaren Überprüfungsvorlagen in Ihrem Konto, inkl. allgemeiner Informationen zu den hinzugefügten Feldern

get-form-schema

Ruft das Schema ab, das bei der Anforderung einer menschlichen Überprüfung für eine bestimmte Überprüfungsvorlage verwendet werden soll.

  • Parameter
    • formId: Die ID der Überprüfungsvorlage, für die das Schema abgerufen werden soll
  • Gibt zurück das Schema unter Berücksichtigung der enthaltenen Felder und ihrer Konfiguration

request-human-review-with-form

Fordert eine menschliche Überprüfung an. Erscheint in Ihrem gotoHuman-Posteingang.

  • Parameter
    • formId: Die ID der zu verwendenden Überprüfungsvorlage
    • fieldData: Inhalt (KI-Ausgabe zur Überprüfung, Kontext, ...) und Konfiguration für die Felder der Überprüfungsvorlage.
      Das Schema hierfür muss mit get-form-schema abgerufen werden
    • config: Konfiguration für die Überprüfungsvorlage. Optional. Das Schema hierfür muss mit get-form-schema abgerufen werden
    • title: Optionaler Titel, der im Posteingang und in Benachrichtigungen angezeigt wird
    • webhookUrl: Optionale Webhook-URL für diese Anfrage (wenn die Überprüfungsvorlage keinen Standard-Webhook hat)
    • workflow: Optionales Objekt, das diese Überprüfung mit einem mehrstufigen agentischen Workflow verknüpft:
      • runId: Eindeutige ID für den aktuellen Workflow-Durchlauf. Verwenden Sie dieselbe runId für jede Überprüfung im selben Durchlauf. Wenn workflow ohne runId gesendet wird (auch {}) oder bei manuellen Auslösern, erstellt gotoHuman eine runId und gibt sie als workflowRunId für nachfolgende Anfragen zurück.
      • runName: Optionaler Anzeigename für den Durchlauf (kann in jedem Schritt festgelegt oder aktualisiert werden)
      • prevSteps: Array von reviewIds aus vorherigen gotoHuman-Überprüfungsschritten (beim ersten Schritt weglassen)
    • metadata: Optionale zusätzliche Daten, die in die Webhook-Antwort nach dem Absenden der Überprüfungsvorlage aufgenommen werden
    • assignToUsers: Optionale Liste von Benutzer-E-Mails, denen die Überprüfung zugewiesen werden soll
  • Gibt zurück reviewId, reviewLink und optional workflowRunId, wenn gotoHuman einen neuen Workflow-Durchlauf zugewiesen hat

Entwicklung

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Lokal im MCP-Client ausführen (z. B. 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] Unter Windows muss der args-Pfad C:\\<absolute-path>\\build\\index.js sein