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
52

O que você pode fazer com gotoHuman MCP?

  • Listar tipos de revisão — Peça ao seu assistente para buscar todos os tipos de revisão disponíveis e os detalhes de seus campos via list-forms.
  • Obter esquema do formulário — Solicite o esquema exato de um tipo de revisão específico para preparar solicitações de revisão válidas usando get-form-schema.
  • Solicitar revisão humana — Envie a saída da IA para aprovação humana com dados de campos, título opcional e responsáveis via request-human-review-with-form.
  • Vincular etapas do fluxo de trabalho — Crie solicitações de revisão vinculadas a um fluxo de trabalho agêntico de múltiplas etapas usando o parâmetro workflow com um runId único.
  • Adicionar notificações via webhook — Configure URLs de webhook por solicitação para receber respostas após o envio da revisão.

Documentação

gotoHuman Logo

Servidor MCP gotoHuman

O gotoHuman facilita adicionar aprovações humanas a agentes de IA e fluxos de trabalho agênticos.
Um fluxo de trabalho assíncrono de humano-no-loop totalmente gerenciado, com uma interface de aprovação personalizável.
Aproveite autenticação integrada, webhooks, notificações, recursos de equipe e um conjunto de dados de treinamento em evolução.

Use nosso servidor MCP para solicitar aprovações humanas em seus fluxos de trabalho de IA ou use-o para ajudar na integração.

Uso

Disponível no npm como:

@gotohuman/mcp-server

Configuração no Cursor / Claude / etc.

{
  "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

Ferramentas

list-forms

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

  • Retorna uma lista de todos os tipos de revisão disponíveis na 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 tipo de revisão.

  • Parâmetros
    • formId: O ID do tipo de revisão para 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á na sua caixa de entrada do gotoHuman.

  • Parâmetros
    • formId: O ID do tipo de revisão a ser usado
    • fieldData: Conteúdo (saída de IA para revisão, contexto, ...) e configuração para os campos do tipo de revisão.
      O esquema para isso precisa ser buscado com get-form-schema
    • config: Configuração para o tipo de revisão. Opcional. O esquema para isso precisa ser buscado com get-form-schema
    • title: Título opcional exibido na caixa de entrada e nas notificações
    • webhookUrl: URL de webhook opcional para esta solicitação (URLs estáticas podem ser definidas no tipo de revisão ou no agente no gotoHuman)
    • workflow: Objeto opcional que vincula esta revisão a um fluxo de trabalho agêntico de múltiplas etapas:
      • runId: ID exclusivo para a execução atual do fluxo de trabalho para vincular múltiplas etapas.
    • 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 e reviewLink

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