gotoHuman

oficial

Plataforma humano-no-loop - Permite que agentes de IA e automações enviem solicitações de aprovação para sua caixa de entrada do gotoHuman.

GitHub
53

O que você pode fazer com Goto Human MCP?

  • Listar modelos de revisão disponíveis — Recupere todos os modelos de revisão da sua conta com list-forms para ver seus IDs e resumos de campos.
  • Obter o esquema de um modelo de revisão — Busque a estrutura exata de campos e a configuração necessária para enviar uma revisão via get-form-schema.
  • Solicitar uma revisão humana — Envie conteúdo gerado por IA para aprovação usando request-human-review-with-form, opcionalmente atribuindo revisores ou vinculando etapas a uma execução de fluxo de trabalho com várias etapas.
  • Encadear revisões em um fluxo de trabalho — Passe um objeto workflow com runId e prevSteps para conectar várias etapas de revisão humana em uma única execução rastreada.

Documentação

Servidor MCP gotoHuman

O gotoHuman facilita a adição de aprovações humanas a agentes de IA e fluxos de trabalho agentivos.
Um fluxo de trabalho assíncrono totalmente gerenciado com human-in-the-loop e uma interface de aprovação personalizável.
Desfrute de autenticação integrada, webhooks, notificações, recursos para equipes e um conjunto de dados de treinamento em evolução.

Use nosso servidor MCP para solicitar aprovações humanas a partir de seus fluxos de trabalho de IA via MCP ou adicione-o ao seu IDE para auxiliar na integração.

Instalação

npx @gotohuman/mcp-server

Uso com Cursor / Claude / Windsurf

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

Install MCP Server

Obtenha sua chave de API e configure uma etapa de aprovação em app.gotohuman.com

Demonstração

Este é o Cursor à esquerda, mas poderia ser um agente em segundo plano que também reage ao webhook de aprovação.

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

Ferramentas

list-forms

Lista todos os modelos de revisão disponíveis.

  • Retorna uma lista de todos os modelos de revisão disponíveis em sua conta, incluindo informações de alto nível sobre os campos adicionados

get-form-schema

Obtém o esquema a ser usado ao solicitar uma revisão humana para um determinado modelo de revisão.

  • Parâmetros
    • formId: O ID do modelo de revisão para o qual buscar o esquema
  • Retorna o esquema, considerando os campos incluídos e sua configuração

request-human-review-with-form

Solicita uma revisão humana. Aparecerá em sua caixa de entrada do gotoHuman.

  • Parâmetros
    • formId: O ID do modelo de revisão a ser usado
    • fieldData: Conteúdo (saída da IA a ser revisada, contexto, ...) e configuração para os campos do modelo de revisão.
      O esquema para isso precisa ser obtido com get-form-schema
    • config: Configuração para o modelo de revisão. Opcional. O esquema para isso precisa ser obtido com get-form-schema
    • title: Título opcional exibido na caixa de entrada e notificações
    • webhookUrl: URL de webhook opcional para esta solicitação (quando o modelo de revisão não tem um webhook padrão)
    • workflow: Objeto opcional vinculando esta revisão a um fluxo de trabalho agentivo de várias etapas:
      • runId: ID único para a execução atual do fluxo de trabalho. Use o mesmo runId em cada revisão na mesma execução. Se workflow for enviado sem runId (mesmo {}), ou para acionadores manuais, o gotoHuman cria um runId e o retorna como workflowRunId para solicitações subsequentes.
      • runName: Nome de exibição opcional para a execução (pode ser definido ou atualizado em qualquer etapa)
      • prevSteps: Array de reviewIds de etapas anteriores de revisão do gotoHuman (omitir na primeira etapa)
    • metadata: Dados adicionais opcionais que serão incluídos na resposta do webhook após o envio do modelo de revisão
    • assignToUsers: Lista opcional de e-mails de usuários para atribuir a revisão
  • Retorna reviewId, reviewLink e, opcionalmente, workflowRunId quando o gotoHuman atribuiu uma nova execução de fluxo de trabalho

Desenvolvimento

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Executar localmente no Cliente MCP (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] Para Windows, o caminho args precisa ser C:\\<absolute-path>\\build\\index.js