gotoHuman MCP Server

Servidor MCP de gotoHuman

gotoHuman facilita la incorporación de aprobaciones humanas a agentes de IA y flujos de trabajo agentivos.
Un flujo de trabajo asíncrono completamente gestionado con un humano en el circuito y una interfaz de aprobación personalizable.
Disfruta de autenticación integrada, webhooks, notificaciones, funciones para equipos y un conjunto de datos de entrenamiento en evolución.

Usa nuestro servidor MCP para solicitar aprobaciones humanas desde tus flujos de trabajo de IA a través de MCP o agrégalo a tu IDE para facilitar la integración.

Instalación

npx @gotohuman/mcp-server

Uso con Cursor / Claude / Windsurf

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

Obtén tu clave de API y configura un paso de aprobación en app.gotohuman.com

Demostración

Esto es Cursor a la izquierda, pero podría ser un agente en segundo plano que también reacciona al webhook de aprobación.

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

Herramientas

list-forms

Enumera todas las plantillas de revisión disponibles.

• Devuelve una lista de todas las plantillas de revisión disponibles en tu cuenta, incluyendo información de alto nivel sobre los campos añadidos

get-form-schema

Obtén el esquema que se debe usar al solicitar una revisión humana para una plantilla de revisión determinada.

• Parámetros
  • formId: El ID de la plantilla de revisión para la cual obtener el esquema
• Devuelve el esquema, considerando los campos incluidos y su configuración

request-human-review-with-form

Solicita una revisión humana. Aparecerá en tu bandeja de entrada de gotoHuman.

• Parámetros
  • formId: El ID de la plantilla de revisión a usar
  • fieldData: Contenido (salida de IA a revisar, contexto, ...) y configuración para los campos de la plantilla de revisión.
    El esquema para esto debe obtenerse con get-form-schema
  • config: Configuración para la plantilla de revisión. Opcional. El esquema para esto debe obtenerse con get-form-schema
  • title: Título opcional que se muestra en la bandeja de entrada y notificaciones
  • webhookUrl: URL de webhook opcional para esta solicitud (cuando la plantilla de revisión no tiene un webhook predeterminado)
  • workflow: Objeto opcional que vincula esta revisión a un flujo de trabajo agentivo de varios pasos:
    • runId: ID único para la ejecución actual del flujo de trabajo. Usa el mismo runId en cada revisión de la misma ejecución. Si se envía workflow sin runId (incluso {}), o para activadores manuales, gotoHuman crea un runId y lo devuelve como workflowRunId para solicitudes posteriores.
    • runName: Nombre opcional para mostrar de la ejecución (se puede establecer o actualizar en cualquier paso)
    • prevSteps: Array de reviewIds de pasos de revisión de gotoHuman anteriores (omitir en el primer paso)
  • metadata: Datos adicionales opcionales que se incluirán en la respuesta del webhook después del envío de la plantilla de revisión
  • assignToUsers: Lista opcional de correos electrónicos de usuarios a quienes asignar la revisión
• Devuelve reviewId, reviewLink, y opcionalmente workflowRunId cuando gotoHuman asignó una nueva ejecución de flujo de trabajo

Desarrollo

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Ejecutar localmente en un Cliente MCP (p. ej., 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] Para Windows, la ruta de args debe ser C:\\<absolute-path>\\build\\index.js