gotoHuman MCP Server

gotoHuman MCP Sunucusu

gotoHuman, yapay zeka ajanlarına ve ajan tabanlı iş akışlarına insan onayları eklemeyi kolaylaştırır.
Özelleştirilebilir bir onay kullanıcı arayüzüne sahip, tamamen yönetilen, asenkron bir döngüde-insan iş akışı.
Yerleşik kimlik doğrulama, web kancaları, bildirimler, ekip özellikleri ve gelişen bir eğitim veri kümesinin keyfini çıkarın.

MCP sunucumuzu, MCP aracılığıyla yapay zeka iş akışlarınızdan insan onayları talep etmek için kullanın veya entegrasyona yardımcı olması için IDE'nize ekleyin.

Kurulum

npx @gotohuman/mcp-server

Cursor / Claude / Windsurf ile Kullanım

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

API anahtarınızı alın ve app.gotohuman.com adresinde bir onay adımı oluşturun

Demo

Soldaki Cursor, ancak bu aynı zamanda onay web kancasına tepki veren bir arka plan ajanı da olabilir.

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

Araçlar

list-forms

Mevcut tüm inceleme şablonlarını listeler.

• Döndürür hesabınızdaki tüm mevcut inceleme şablonlarının bir listesini, eklenen alanlar hakkında üst düzey bilgilerle birlikte

get-form-schema

Belirli bir inceleme şablonu için insan incelemesi talep ederken kullanılacak şemayı alır.

• Parametreler
  • formId: Şeması alınacak inceleme şablonu kimliği
• Döndürür dahil edilen alanları ve yapılandırmalarını dikkate alan şemayı

request-human-review-with-form

Bir insan incelemesi talep eder. gotoHuman gelen kutunuzda görünecektir.

• Parametreler
  • formId: Kullanılacak inceleme şablonunun kimliği
  • fieldData: İnceleme şablonunun alanları için içerik (incelenecek yapay zeka çıktısı, bağlam,...) ve yapılandırma.
    Bunun şeması get-form-schema ile alınmalıdır
  • config: İnceleme şablonu için yapılandırma. İsteğe bağlı. Bunun şeması get-form-schema ile alınmalıdır
  • title: Gelen kutusunda ve bildirimlerde gösterilen isteğe bağlı başlık
  • webhookUrl: Bu istek için isteğe bağlı web kancası URL'si (inceleme şablonunun varsayılan bir web kancası olmadığında)
  • workflow: Bu incelemeyi çok adımlı bir ajan tabanlı iş akışına bağlayan isteğe bağlı nesne:
    • runId: Mevcut iş akışı çalıştırması için benzersiz kimlik. Aynı çalıştırmadaki her incelemede aynı runId kullanın. Eğer workflow, runId olmadan (hatta {}) gönderilirse veya manuel tetikleyiciler için, gotoHuman bir runId oluşturur ve sonraki istekler için workflowRunId olarak döndürür.
    • runName: Çalıştırma için isteğe bağlı görünen ad (herhangi bir adımda ayarlanabilir veya güncellenebilir)
    • prevSteps: Önceki gotoHuman inceleme adımlarından gelen reviewId dizisi (ilk adımda atlayın)
  • metadata: İnceleme şablonu gönderildikten sonra web kancası yanıtına dahil edilecek isteğe bağlı ek veriler
  • assignToUsers: İncelemenin atanacağı isteğe bağlı kullanıcı e-posta listesi
• Döndürür reviewId, reviewLink ve isteğe bağlı olarak gotoHuman yeni bir iş akışı çalıştırması atadığında workflowRunId

Geliştirme

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

MCP İstemcisinde Yerel Olarak Çalıştırma (örn. 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 için, args yolu C:\\<absolute-path>\\build\\index.js olmalıdır