Custom MCP servers are available on every Lovable plan. If your workspace is on Enterprise, an admin needs to enable Third-party MCP clients first under Workspace settings → Security → Privacy & security — it’s on by default for Free, Pro, and Business.
Generate your Bearer token
The Bearer value Lovable needs is a PerfAI Token (id_token which is a JWT)id_tokens are short-lived. If Lovable later reports “could not connect” after previously working, your token has likely expired — generate a fresh one with either method below and update the connector.
- macOS / Linux
- Windows (PowerShell)
read -s masks the password prompt so it never lands in your shell history. Copy the printed id_token value in full.Installation
- Open the Connectors dashboard in Lovable and click the + button (top right).
- Select MCP server.
- Fill in:
- Server name:
Perfai Cloud - Connection type: Direct connection (default — “Lovable static IPs” is Enterprise-only and not needed here)
- Server URL:
https://mcp-server.perfai.ai/mcp - Authentication: Bearer token or API key
- Token: paste the
id_tokenfrom above
- Server name:
- Click Add & authorize.
Verify the server is connected
- Reopen the Connectors dashboard and find Perfai Cloud in your connector list.
- It should show as connected with 19 tools discovered.
- If it fails, re-check the token value for trailing whitespace, confirm Bearer token or API key was selected, and make sure the token hasn’t expired (generate a fresh
id_tokenif it has).
Login
The prompts below run inside Lovable’s project chat, not your terminal. The only setup step outside the chat is adding the connector above.
login with no arguments. Confirm the session with:

