How do I connect an agent app to WorkHub?

Add WorkHub as a custom connector in your agent app using the Connector URL from Settings → Agent Access. Then sign in to WorkHub as an Admin and click Approve.

Steps

1. In WorkHub, go to Settings → Agent Access and copy the Connector URL (it ends in /mcp).
2. Make sure the status says “On: agents can work in WorkHub”.
3. In your agent app, add a custom connector (MCP server), paste the URL and start the connection.
4. You’re sent to WorkHub. Sign in if asked. If you belong to several companies, switch to the right company first, because the connection is tied to the company you’re working in.
5. On the Connect [app] to WorkHub page, check what the app will be able to do, then click Approve.
6. You’re sent back to your agent app. The connection now appears under Connected agents in Agent Access.

Good to know

• If the approval page shows a red message instead of an Approve button:
  • “Only an admin of this company can connect an agent.” Ask an Admin to approve, or check you’re in the right company.
  • “The agent user has not been set up yet.” Click Create Henry in Agent Access first.
  • “Agent access is turned off.” Click Turn on in Agent Access.
• If you see “This approval form expired”, start the connection again from your agent app.
• The app gets the agent’s Instructions automatically each time it connects.
• A connection that isn’t used for 90 days expires and must be approved again.
• If the admin who approved a connection stops being an Admin, that connection stops working.