Local Connection

Local services need a remote endpoint to connect with the mobile app. There are many solutions for this including ngrok, tunneling services, or local network access. Ask for advice in Discord for the best approach for your setup.

1. Enter Remote URL

You'll need to provide a publicly accessible URL to your local MCP server:

Tunneling Solutions:

https://abc123.ngrok.io/mcp
https://your-subdomain.tunnel.com/mcp
https://local-server.example.com/mcp

Local Network (if on same WiFi):

http://192.168.1.100:3000/mcp
http://your-machine.local:3000/mcp

2. Configure OAuth (if required)

If your local server implements OAuth authentication, the app will guide you through the in-device OAuth flow:

Tap Configure OAuth
Follow in-app browser authentication to your local server
Grant required permissions
Return to app automatically

3. Add Custom Headers (if required)

Add any custom headers your local server requires:

Development API Key:

Header: X-API-Key
Value: dev-api-key-123

Local Authentication:

Header: Authorization
Value: Bearer local-dev-token

Custom Headers:

Header: X-Dev-Mode
Value: true

Header: X-Local-Session
Value: your-session-id

Setup Options

Option 1: Tunneling Service (Recommended)

Use a service like ngrok to expose your local server:

# Install ngrok
npm install -g ngrok
 
# Start your MCP server locally
npm start -- --transport http --port 3000
 
# In another terminal, create tunnel
ngrok http 3000

Then use the ngrok URL in the app (e.g., https://abc123.ngrok.io/mcp)

Option 2: Local Network Access

If your mobile device is on the same WiFi network:

Find your machine's local IP address
Ensure your MCP server accepts external connections
Configure any necessary firewall rules
Use the local IP URL in the app

Option 3: VPN or Custom Solution

For advanced setups, you might use:

VPN to access local network remotely
Custom reverse proxy setup
Cloud proxy services

Connection Setup

Open Systemprompt app
Navigate to Settings → MCP Servers
Tap Add Server
Select Local Server
Enter your tunneled or local network URL
Configure authentication if required
Add custom headers if needed
Test connection

Testing Connection

Verify your connection with basic commands:

"ping local server"
"list available tools"
"check server status"

Development Features

Hot Reload Support

Systemprompt automatically reconnects when server restarts
Supports development workflow with automatic restarts
Maintains connection through code changes

Debug Mode

Go to Settings → Developer Options
Enable Debug Logging
View connection logs in Settings → Logs

Common Issues

Connection Refused

Verify your tunnel is active and accessible
Check if local server is running on correct port
Test tunnel URL in browser first

Tunnel Disconnected

Restart your tunneling service
Check tunnel service logs
Verify tunnel configuration

Local Network Issues

Ensure device is on same WiFi network
Check firewall settings allow connections
Verify local IP address is correct

Need Help?

Ask for advice in Discord
Share your setup details for personalized help
Get recommendations for best tunneling solution

Local Connection

On this page