Quick Start Guide

Get started with Human in the Loop (HITL) in minutes. Connect your mobile device to your AI agents and start making decisions on the go.

1Install & Register Mobile App

Download the HITL mobile app and create your account:

Android

Download HITL from Google Play Store
Open the app and tap "Get Started"
Choose your sign-in method:
- Google Sign-In
- Apple Sign-In
- Email & Password
Complete registration and verify your email if needed
Grant notification permissions when prompted

iOS

Download HITL from Apple App Store
Open the app and tap "Get Started"
Choose your sign-in method:
- Apple Sign-In
- Google Sign-In
- Email & Password
Complete registration and verify your email if needed
Grant notification permissions when prompted

📝 Important: Remember which sign-in method you used. You'll need to use the same email address when connecting your MCP clients.

HITL Mobile Login Screen

2Connect Your MCP Client

Configure your MCP client to connect to HITL Relay. We'll use Claude Code as an example:

Claude Code Configuration

Add the HITL MCP server with this simple command:

claude mcp add --transport http Human-in-the-Loop https://hitlrelay.app/mcp/

That's it! The HITL server is now configured.

For other MCP clients (Cursor, Windsurf, Zed, etc.), see the Client Integration Guide.

3Link Your Phone to MCP Client

The first time you use HITL tools in your MCP client, you'll need to authenticate with the same email address you used in the mobile app:

🔗 Authentication Flow

Authenticate MCP Server

In Claude Code, run: /mcp and select the Human-in-the-Loop server to authenticate

Open Authentication Link

Click the authentication link provided or copy the URL to your browser

Use the same method and email you used in the mobile app:

Google Sign-In on mobile → use Google Sign-In here
Apple Sign-In on mobile → use Apple Sign-In here
Email/Password on mobile → use same email/password here

Grant Permissions

Allow HITL to access your account and send notifications

✓

Success!

You'll receive a test notification on your mobile device confirming the connection

💡

Pro Tip

The authentication only needs to be done once. After linking, all future HITL requests will automatically reach your phone.

4Make Your First HITL Request

Now let's test the connection with a simple task. Give Claude Code these instructions:

Example Task for Claude Code

I need you to help me analyze the README.md file and suggest improvements.

IMPORTANT: Use the human-in-the-loop MCP tool to send me all communications and get my approval before making any changes.

Steps:
1. Read the README.md file
2. Analyze the content and identify areas for improvement
3. Use HITL to send me your analysis and suggestions
4. Wait for my approval via HITL before making changes
5. If I approve, make the improvements
6. Use HITL to notify me when you're done

What happens next:

Claude will analyze your README.md file
You'll receive a push notification on your mobile device
Open the HITL app to see Claude's analysis and suggestions
Review and choose: "Approve", "Request Changes", or "Deny"
Claude receives your response and acts accordingly
You'll get a completion notification when done

More Example Prompts

Code Review with HITL:

Review the changes in src/auth.ts and use HITL to send me a summary of potential issues before I commit.

Deployment Approval:

Run the test suite, and if all tests pass, use HITL to ask for my approval before deploying to production.

API Key Decision:

I need to integrate a payment API. Research Stripe and PayPal, then use HITL to send me a comparison so I can decide which to use.

Troubleshooting

I'm not receiving notifications on my phone

Check the following:

Ensure notifications are enabled in your phone's Settings → HITL app
Verify you're signed in with the same email on both mobile and MCP client
Check your internet connection on both devices
Try signing out and back in on the mobile app

Authentication keeps failing

Make sure you're using the exact same sign-in method:

If you used Google on mobile, use Google for MCP authentication
If you used Apple on mobile, use Apple for MCP authentication
The email addresses must match exactly
Check for typos in email/password if using email authentication

HITL tools are not available in Claude Code

Verify your MCP configuration:

Check that the HITL server is added to your MCP config
Restart Claude Code after adding the configuration
Run claude mcp list to verify the server is listed
Check for any error messages in Claude Code's output