gotoHuman

gotoHuman MCP 서버

gotoHuman은 AI 에이전트 및 에이전틱 워크플로우에 인간 승인을 쉽게 추가할 수 있게 해줍니다.
완전 관리형 비동기 인간-인-더-루프 워크플로우와 사용자 정의 가능한 승인 UI를 제공합니다.
내장 인증, 웹훅, 알림, 팀 기능, 그리고 진화하는 학습 데이터셋을 즐기세요.

MCP 서버를 사용하여 AI 워크플로우에서 인간 승인을 요청하거나 통합을 지원하는 데 사용하세요.

사용법

npm에서 다음과 같이 사용할 수 있습니다:

@gotohuman/mcp-server

Cursor / Claude 등에서 설정

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

app.gotohuman.com에서 API 키를 받고 승인 단계를 설정하세요.

도구

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 (정적 URL은 gotoHuman의 리뷰 유형 또는 에이전트에 설정할 수 있습니다)
  • workflow: 이 리뷰를 다단계 에이전틱 워크플로우에 연결하는 선택적 객체:
    • runId: 여러 단계를 연결하기 위한 현재 워크플로우 실행의 고유 ID.
  • metadata: 리뷰 템플릿 제출 후 웹훅 응답에 포함될 선택적 추가 데이터
  • assignToUsers: 리뷰를 할당할 선택적 사용자 이메일 목록
• 반환 reviewId 및 reviewLink

개발

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