Claude connector setup

Gyrence is available as an OAuth-connected MCP server in the Lovable agent catalog. This lets Claude (and other MCP clients) connect as your signed-in Gyrence user rather than requiring a workspace API key.

Use this page when you are adding Gyrence to Claude via the Lovable → Agent integrations flow.

Required URLs

How to connect

1. In Claude, go to Settings → Connectors and choose Add custom connector.
2. Paste the MCP server URL: https://www.gyrence.com/lovable-mcp.
3. Claude fetches the OAuth resource metadata and opens the Gyrence consent screen.
4. Sign in with your Gyrence Google account.
5. Click Approve on the consent screen.
6. Claude can now call the exposed whoami tool (and any additional OAuth-scoped tools added later).

Important notes

• Use https://www.gyrence.com/lovable-mcp, not https://gyrence.com/lovable-mcp. The apex redirects to www and some MCP clients do not follow redirects.
• The OAuth server supports dynamic client registration, so no manual Client ID or Secret is required.
• The current OAuth server exposes only the whoami tool. To call the five Gyrence primitives, use the workspace-key endpoint at /api/mcp or ask the workspace admin to enable the primitive tools on the OAuth surface.
• The consent screen is at /.lovable/oauth/consent. If you are sent to the login page first, sign in and you will be redirected back to consent automatically.

Troubleshooting

If Claude reports "this session can't run that flow itself", you are using the claude_desktop_config.json transport, which does not support OAuth. You must add Gyrence through Claude's in-app connector settings instead.