Help: For agent builders
Connect an agent
An agent reaches funwatcher through the MCP connector at this address:
https://funwatcher.com/mcp
The connector is hosted with funwatcher. There is nothing to install: your MCP client connects to it over the internet and sends the agent's key with every request. This page shows how to get a key and what to enter in each client. If your agent makes HTTP calls instead of speaking MCP, see API overview.
Register the agent and copy its key
Only an owner of the account can register an agent.
- Select "Agents" in the top bar and select "Register an agent".
- Enter "Agent name" and "Vendor label".
- Select "Register and create key".
- On the page that says the agent is registered, select "Reveal" to see the key or "Copy" to copy it.
- Put the key into your client as described below, then select "Done, go to the agent".
- The key is shown only on that one page and cannot be recovered. If you leave the page without copying it, create a new one: see Rotate or revoke an agent key.
- When you register your first agent right after signing up, the setup screen shows the same instructions as this page with your key already filled in.
- Register one agent for each client you connect. Every client that sends the same key acts as the same agent.
In the examples below, replace YOUR_AGENT_KEY with the key.
Claude Code
Run this once in a terminal:
claude mcp add --transport http funwatcher https://funwatcher.com/mcp \
--header "Authorization: Bearer YOUR_AGENT_KEY"Check it with claude mcp list, or /mcp inside Claude Code: funwatcher shows as connected with three tools.
Claude (claude.ai and the desktop app)
Add funwatcher as a custom connector. A connector belongs to your Claude account, so one added on claude.ai is the same one the desktop app uses.
1. In Claude, open Customize, then Connectors. Select "+ Add", then "Add custom connector".
2. Enter the name funwatcher and this address as the remote MCP server URL, then select "Continue":
https://funwatcher.com/mcp3. Under "Authentication" choose "No sign in". The agent key takes the place of a sign-in.
4. Under "Request headers" choose the header name authorization and enter this value, the word Bearer and a space included (Claude sends the value exactly as typed):
Bearer YOUR_AGENT_KEY5. Select "Add", then start a new conversation. The three tools appear under the connector.
Things to know about the Claude apps:
- If the dialog shows everything on one screen, "Request headers" is under "Advanced".
- Claude does not show the key again and a connector's headers cannot be edited. After rotating the agent's key, remove the connector and add it again with the new key.
- On a Team or Enterprise plan an Owner adds the connector under Organization settings, Connectors, and everyone who uses it acts as the same agent. Register an agent for that purpose.
- "Request headers" is a beta feature that Anthropic has switched on for some accounts only. If your dialog has no such section, the connector cannot send the key. In the desktop app use the bridge below; claude.ai has no alternative until the section appears.
Desktop app without "Request headers". The desktop app can start a small bridge program, mcp-remote, that sends the key for it. It needs Node.js 18 or later on the computer. In the desktop app open Settings, Developer, "Edit Config", add this to claude_desktop_config.json and restart the app completely:
{
"mcpServers": {
"funwatcher": {
"command": "npx",
"args": ["mcp-remote", "https://funwatcher.com/mcp", "--transport", "http-only", "--header", "Authorization:${AUTH_HEADER}"],
"env": {
"AUTH_HEADER": "Bearer YOUR_AGENT_KEY"
}
}
}
}Cursor, VS Code and other clients
Any MCP client that supports streamable HTTP with a custom header works. Give it the address and the header:
URL: https://funwatcher.com/mcp
Header: Authorization: Bearer YOUR_AGENT_KEYMost clients take them as JSON. Cursor (~/.cursor/mcp.json) and clients with the same format:
{
"mcpServers": {
"funwatcher": {
"url": "https://funwatcher.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_AGENT_KEY"
}
}
}
}VS Code (.vscode/mcp.json) uses "servers" in place of "mcpServers" and adds "type": "http" to the entry. Keep a file that contains the key out of version control.
Check that the agent is connected
- Ask the agent to list its tools, or look at the connector in your client. It shows 3 tools:
request_approval,report_result,check_policy. - Have the agent propose an action, so that it calls
request_approval. - Select "Agents" in the top bar, select the agent's name and read "Last used" next to its key. "never" means no call has arrived.
If the client cannot connect or reports that authentication is needed, see Troubleshooting.
What connecting does and does not do
- Connecting gives the agent the tools. It cannot make the agent call them. An agent that does not call
request_approval, or ignores the answer, is not stopped by funwatcher. Tell the agent in its own instructions to ask before every action with effects outside the conversation. - funwatcher never carries out an action and never receives the agent's credentials for your bank, mail or other systems. The key only proves which agent is asking.
- Anyone who holds the key can submit requests as the agent. Keep a file that contains it out of version control, and revoke the key the moment it may have been seen by someone else.
For what each tool takes and returns, see MCP tools.
Previous: Closing an account
Next: API overview
All help pages
Inbox
- Read a request
- Approve, deny or edit a request
- Held actions
- Expired requests and history
- Request statuses
Rules
- How rules work
- The default rules
- Write a rule in plain English
- Build a rule with the form
- Reorder, enable and disable rules
- Suggested rules
- Set a default policy for an agent
- Export your rules
Teams
Ledger
- What the ledger is
- Browse and filter the ledger
- Export and verify the ledger
- Payload retention
- Monthly statements
Billing
Account and security
- Change your password
- Two-factor authentication and recovery codes
- Rotate or revoke an agent key
- How your data is protected
- Closing an account