gotoHuman MCP Server

gotoHuman MCP 서버

gotoHuman은 AI 에이전트와 에이전트 워크플로우에 사람 승인을 쉽게 추가할 수 있게 해줍니다.
완전 관리형 비동기 휴먼인더루프 워크플로우와 커스터마이즈 가능한 승인 UI를 제공합니다.
내장 인증, 웹훅, 알림, 팀 기능, 그리고 지속적으로 발전하는 학습 데이터셋을 누려보세요.

MCP 서버를 사용하여 AI 워크플로우에서 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"
      }
    }
  }
}

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: 검토 템플릿 필드에 대한 콘텐츠(검토할 AI 출력, 컨텍스트 등) 및 구성.
    이에 대한 스키마는 get-form-schema로 가져와야 합니다.
  • config: 검토 템플릿에 대한 구성. 선택 사항. 이에 대한 스키마는 get-form-schema로 가져와야 합니다.
  • title: 받은 편지함과 알림에 표시될 선택적 제목
  • webhookUrl: 이 요청에 대한 선택적 웹훅 URL (검토 템플릿에 기본 웹훅이 없는 경우)
  • workflow: 이 검토를 다단계 에이전트 워크플로우에 연결하는 선택적 객체:
    • runId: 현재 워크플로우 실행에 대한 고유 ID. 동일한 실행 내 모든 검토에 동일한 runId를 사용하세요. runId 없이 workflow이 전송되거나(심지어 {}인 경우에도), 또는 수동 트리거의 경우, gotoHuman은 runId를 생성하고 후속 요청을 위해 workflowRunId로 반환합니다.
    • runName: 실행에 대한 선택적 표시 이름 (어느 단계에서든 설정 또는 업데이트 가능)
    • prevSteps: 이전 gotoHuman 검토 단계의 reviewId 배열 (첫 번째 단계에서는 생략)
  • metadata: 검토 템플릿 제출 후 웹훅 응답에 포함될 선택적 추가 데이터
  • assignToUsers: 검토를 할당할 사용자 이메일의 선택적 목록
• 반환값: reviewId, reviewLink, 그리고 gotoHuman이 새 워크플로우 실행을 할당한 경우 선택적으로 workflowRunId

개발

# 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이어야 합니다.