gotoHuman

официальный

Платформа с участием человека — позволяет AI-агентам и автоматизациям отправлять запросы на утверждение в ваш inbox gotoHuman.

GitHub
53

Что можно делать с Goto Human MCP?

  • Список доступных шаблонов рецензирования — Получите все шаблоны рецензирования в вашей учетной записи с помощью list-forms, чтобы увидеть их идентификаторы и сводки полей.
  • Получение схемы шаблона рецензирования — Получите точную структуру полей и конфигурацию, необходимую для отправки рецензии через get-form-schema.
  • Запрос на рецензирование человеком — Отправьте сгенерированный ИИ контент на утверждение с помощью request-human-review-with-form, при необходимости назначая рецензентов или связывая шаги в многоэтапный рабочий процесс.
  • Объединение рецензий в рабочий процесс — Передайте объект workflow с runId и prevSteps, чтобы соединить несколько этапов рецензирования человеком в один отслеживаемый запуск.

Документация

gotoHuman MCP-сервер

gotoHuman упрощает добавление подтверждений человеком в ИИ-агентов и агентные рабочие процессы.
Полностью управляемый асинхронный процесс с участием человека и настраиваемым интерфейсом подтверждения.
Встроенная аутентификация, вебхуки, уведомления, командные функции и пополняемый набор обучающих данных.

Используйте наш MCP-сервер для запроса подтверждений человеком из ваших ИИ-процессов через MCP или добавьте его в вашу IDE для помощи в интеграции.

Установка

npx @gotohuman/mcp-server

Использование с Cursor / Claude / Windsurf

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

Install MCP Server

Получите API-ключ и настройте шаг подтверждения на app.gotohuman.com

Демонстрация

Слева показан Cursor, но это может быть и фоновый агент, который также реагирует на вебхук подтверждения.

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

Инструменты

list-forms

Выводит список всех доступных шаблонов проверки.

  • Возвращает список всех доступных шаблонов проверки в вашем аккаунте, включая общую информацию о добавленных полях

get-form-schema

Получает схему для использования при запросе проверки человеком для заданного шаблона проверки.

  • Параметры
    • formId: ID шаблона проверки, для которого нужно получить схему
  • Возвращает схему с учётом включённых полей и их конфигурации

request-human-review-with-form

Запрашивает проверку человеком. Появится в вашем почтовом ящике gotoHuman.

  • Параметры
    • formId: ID используемого шаблона проверки
    • fieldData: Контент (вывод ИИ для проверки, контекст и т.д.) и конфигурация полей шаблона проверки.
      Схему для этого необходимо получить с помощью get-form-schema
    • config: Конфигурация шаблона проверки. Необязательно. Схему для этого необходимо получить с помощью get-form-schema
    • title: Необязательный заголовок, отображаемый в почтовом ящике и уведомлениях
    • webhookUrl: Необязательный URL вебхука для этого запроса (если в шаблоне проверки не задан вебхук по умолчанию)
    • workflow: Необязательный объект, связывающий эту проверку с многошаговым агентным процессом:
      • runId: Уникальный ID текущего запуска процесса. Используйте один и тот же runId для всех проверок в рамках одного запуска. Если workflow отправлен без runId (даже {}) или для ручных триггеров, gotoHuman создаёт runId и возвращает его как workflowRunId для последующих запросов.
      • runName: Необязательное отображаемое имя запуска (можно задать или обновить на любом шаге)
      • prevSteps: Массив reviewId из предыдущих шагов проверки gotoHuman (не указывайте на первом шаге)
    • metadata: Необязательные дополнительные данные, которые будут включены в ответ вебхука после отправки шаблона проверки
    • assignToUsers: Необязательный список email-адресов пользователей, которым нужно назначить проверку
  • Возвращает reviewId, reviewLink и, опционально, workflowRunId, если gotoHuman назначил новый запуск процесса

Разработка

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Локальный запуск в MCP-клиенте (например, 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] Для Windows путь args должен быть C:\\<absolute-path>\\build\\index.js