Connect Cursor to Guard.ch
Set up browser access once. Then ask Cursor to work in a browser or continue a session you already opened.
What you need
A Guard.ch account with MCP access enabled and an app key from that account. Your agent can access your own sessions.
Install Cursor and sign in to use Agent mode.
1. Create an app key
Open the Agents page in your dashboard and choose Create a key. Give it a name, such as your agent name. Copy the key before closing the window. It is only shown once.
Create a key2. Add Guard.ch to Cursor
Open Cursor Settings > Tools & MCP and add a global MCP server. Paste the configuration into ~/.cursor/mcp.json and save.
{
"mcpServers": {
"guardch": {
"url": "https://api.guard.ch/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Swap YOUR_API_KEY for your own key before you save this.
For JSON configuration: if you already use other MCP servers, only add the guardch entry inside mcpServers. Keep your other entries.
3. Check the connection
Check that guardch is enabled in Tools & MCP. Open an Agent chat, send the task below and approve the browser tools when asked.
Open example.com in a Guard.ch browser and tell me what the page says.The connection works when your agent opens a Guard.ch browser and returns the page content. Find the session under Agents in your dashboard to watch it live.
Continue an open session
In your Guard.ch viewer, choose Hand to an agent. Copy the prepared prompt into your connected agent chat. It includes the session ID so your agent continues in that exact browser. Use a key from the same account.
If something goes wrong
If the server stays disconnected, check the key in the global configuration and reload Cursor. Use Agent mode with the Guard.ch tools enabled.
For an authentication error, check that your app key is still valid. For an access error, check MCP access in your dashboard. Verify the connection in your agent; Guard.ch cannot automatically detect its configuration.
Your app key grants access to your sessions. Only add it to your agent settings, never to a chat or shared file. You can revoke it under Apps.