
HITL (Human in the Loop)
io.github.hitl-sh由 GitHub 账号 hitl-sh 发布v1.0.0更新于 Nov 19, 2026
Let AI agents ask a real person for a decision on their phone and wait for the answer.
发布方自己的服务:TAP
概览
让 AI 助手运行 HITL 工作流,在手机上向真人请求决策并等待其答复。
- 可以做什么
- 列出、查看并构建工作流,包括步骤、连接、输入字段和示例输入体
- 运行、重试、测试、启用和暂停工作流,并列出或等待运行结果
- 通过实时更新链接跟踪运行,并查看已发布版本
- 查看工作流的审核人,并通过电子邮件邀请审核人
- 创建、轮换、校验工作流加入码并用其加入
- 检查 API 密钥并处理代理注册状态
- 适用场景
- 当智能体在任务中途需要真人判断(例如批准、选择或确认某事),并且应阻塞等待有人在 HITL 手机应用上作答时使用。适合已有 HITL 工作流、或希望由助手构建和管理这些工作流的场景。
- 运行要求
- 远程端点 mcp.hitl.sh;主端点要求 OAuth 登录,简化端点使用 HITL API 密钥作为 Bearer 令牌。审核人需要 HITL 账户和专用 HITL 手机应用才能接收并完成任务。另有本地 stdio 版本,通过 npx 运行并在环境变量中提供 HITL API 密钥。
安装
在 SourceWeft 中
- 打开 控制台中的 HITL (Human in the Loop),将其添加到工作区。
- 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
交给智能体安装
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.hitl-sh%2Fhitl/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。
{
"mcpServers": {
"hitl-human-in-the-loop": {
"type": "http",
"url": "https://mcp.hitl.sh/mcp"
}
}
}README
HITL.sh MCP Server
HITL.sh is a mobile-powered Human-in-the-Loop platform designed to give AI systems instant access to real human judgment. The entire system is built around our dedicated mobile app, which is required for the product to function and enables human reviewers to receive and complete tasks in real time.
🚀 Quick Start for Users
Choose the endpoint that matches your platform:
For ChatGPT Users (OAuth):
URL: https://mcp.hitl.sh/mcp
- Add MCP Connector in ChatGPT with URL above
- Sign up through the OAuth flow
- (Optional) Add your personal HITL API key at:
https://mcp.hitl.sh/setup-api-key - Start using HITL tools!
For OpenAI Agent Builder / Zapier / Make.com (Direct API Key):
URL: https://mcp.hitl.sh/mcp-simple
- Add MCP Server with URL above
- Authentication: Bearer Token
- Token: Your HITL API key (e.g.,
hitl_live_abc123...) - Start using HITL tools!
📚 Full OpenAI Agent Builder Guide
🛠️ For Developers
Features
- OAuth 2.1 Authentication - Secure OAuth flow with Auth0 integration
- Per-User API Keys - Users can configure their own HITL.sh API keys
- Workflow tools - Find, run, build and manage HITL workflows, and choose who reviews them
- ChatGPT Compatible - Works as a connector in ChatGPT
- Claude Desktop Support - Standalone stdio server for local use
- Production Ready - Deployed on Vercel with proper error handling
🛠️ Available Tools
HITL is workflows: an agent runs a workflow, the workflow asks your humans, and the run finishes with their answer.
Loops, requests, images, sessions, people, organizations, teams, webhooks and uploads are no longer tools (the API still serves them). The workflow routes are live on dev.api.hitl.sh and answer 404 on api.hitl.sh until they ship there; set HITL_API_BASE=https://dev.api.hitl.sh/v1 to use them now.
Both endpoints (/mcp and /mcp-simple) register these tools from @hitl-sh/core, the same package behind the stdio server @hitl-sh/mcp, so the remote and local servers expose identical tools.
📋 Prerequisites
- Node.js 18+ (download)
- HITL.sh API key (get one here)
- Auth0 account (sign up)
- Vercel account for deployment (sign up)
🔧 Environment Variables
Required for Production
Optional
🚀 Quick Start
1. Clone and Install
2. Set Up Auth0
Follow the setup guide in PER_USER_API_KEY_SETUP.md to:
- Create an Auth0 account and tenant
- Create an API with audience
https://mcp.hitl.sh - Create M2M applications for testing and management
- Configure Auth0 Action for per-user API keys
3. Configure Environment Variables
Create .env.local:
4. Run Locally
Server runs on http://localhost:3000
5. Test OAuth Flow
🌐 Deploy to Vercel
1. Push to GitHub
2. Deploy to Vercel
- Go to vercel.com/new
- Import your GitHub repository
- Add all environment variables from
.env.local - Click Deploy
3. Configure Auth0 with Vercel URL
Update your Auth0 applications with your Vercel URL:
For ChatGPT OAuth Client (SPA):
- Allowed Callback URLs:
https://chatgpt.com/connector_platform_oauth_redirect - Allowed Web Origins:
https://chatgpt.com, https://chat.openai.com - Allowed Logout URLs:
https://chatgpt.com, https://chat.openai.com
🤖 Using with ChatGPT
1. Create Auth0 SPA Client
- Auth0 Dashboard → Applications → Create Application
- Name:
ChatGPT MCP Connector - Type: Single Page Application
- Configure callback URLs (see above)
- Enable Connections → Username-Password-Authentication
2. Connect in ChatGPT
- ChatGPT → Settings → MCP Connectors
- Add connector with your Vercel URL:
(Note: Use base URL, not
/mcpendpoint) - Authentication: OAuth
- Complete login flow
3. Set Your HITL API Key
Visit https://your-app.vercel.app/setup-api-key to configure your personal HITL.sh API key.
💻 Using with Claude Desktop
For local Claude Desktop integration, use the published stdio server @hitl-sh/mcp:
1. Configure Claude Desktop
Add to ~/Library/Application Support/Claude/config.json:
From a clone of this repo, node scripts/claude-desktop-server.mjs runs the same server.
2. Restart Claude Desktop
The HITL tools will appear in Claude Desktop!
See CLAUDE_DESKTOP_SETUP.md for detailed instructions.
🧪 Testing
Test OAuth Flow
Test All Tools
📁 Project Structure
🔐 Security
- OAuth 2.1 with PKCE for secure authentication
- JWT verification using Auth0 JWKS
- Per-user API keys stored securely in Auth0 user metadata
- Environment variable fallback for shared API key
- CORS properly configured for ChatGPT
📚 Documentation
- CLAUDE.md - For future Claude Code sessions
- PER_USER_API_KEY_SETUP.md - Complete Auth0 setup guide
- CLAUDE_DESKTOP_SETUP.md - Local Claude Desktop integration
🐛 Troubleshooting
"Invalid token" errors
- Check that
AUTH0_ISSUER_URLmatches your Auth0 tenant - Verify token hasn't expired
- Ensure
AUTH0_AUDIENCEishttps://mcp.hitl.sh
ChatGPT connection fails
- Verify Auth0 SPA client has connections enabled
- Check callback URLs are configured correctly
- Ensure dynamic client registration is disabled
Per-user API keys not working
- Verify Auth0 Action is deployed and in Login flow
- Check user has
hitl_api_keyin user_metadata - User must log out/in to get new token with API key
🤝 Contributing
Contributions welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
📄 License
MIT License - see LICENSE file for details
🔗 Links
- HITL.sh - Human-in-the-Loop platform
- MCP Specification - Model Context Protocol
- Auth0 Documentation - OAuth provider
- Vercel Documentation - Deployment platform
✨ Credits
Built with:
来源:README.md,提交 348de77
工具
0版本历史
1- v1.0.0最新Nov 19, 2026
评分
已满足适用检查项的 85%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通必需25 分
- 已声明认证方式必需10 分
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Human 集成

TAP
tech.human官方发布者
TAP 是一个托管式远程 MCP 端点,通过占位密钥、策略校验和可选的人工审批,为 AI 代理隔离凭据。
UGC, the Human Ad Network
africa.ugc官方发布者
UGC(“Human Ad Network”)的远程 MCP 端点,让助手在对话中处理广告活动、剪辑与 Clip Studio。
Human Use
dev.humanuse
把真人变成 MCP 工具:智能体调用 photo、errand 等工具后,卡片出现在对方手机上,回答以 JSON 返回。
Coordination Game — Staked 1v1 Human or AI Turing Test MCP
由 GitHub 账号 corsur 发布
远程 MCP 服务器,用于带质押的 1v1 社交推理游戏:助手被匿名匹配、与对手聊天,并猜测对方是人类还是 AI。

Human Creative AI Workflow & Eval Lab
由 GitHub 账号 jdurey 发布
远程 MCP 服务器,提供多模型 AI 工作流诊断、智能体评测沙箱、护栏审计、评审量表校准以及 SOP 转 SCORM/QTI 编译。