To connect an MCP client to Genezio, add the Genezio MCP server URL to the client, and then sign in to Genezio in your browser. Each client keeps its list of MCP servers in a different place. This page gives the procedure for the most frequent clients. The URL of the server is:
Each client uses OAuth: you do not copy a token or an API key. After you add the server, the client opens Genezio, and you approve the access. Refer to Authentication and scopes.

​
Claude (web and desktop)

1

Open the connectors

In Claude, open Settings, then Connectors.
2

Add a custom connector

Click Add custom connector. Enter the name Genezio and the MCP server URL.
3

Connect

Click Connect. Sign in to Genezio, and click Allow access.
On a Team or Enterprise plan of Claude, an owner of the organization can add the connector for all the members.

​
Claude Code

Add the server from the terminal:
Then start Claude Code, enter /mcp, select genezio, and authenticate in the browser.

​
ChatGPT

1

Open the connectors

In ChatGPT, open Settings, then the settings of the apps and connectors. A custom MCP connector can need the developer mode.
2

Create the connector

Create a new connector. Enter the name Genezio and the MCP server URL, and select OAuth as the authentication.
3

Connect

Sign in to Genezio, and click Allow access.

​
Cursor

Add the server to ~/.cursor/mcp.json for all your projects, or to .cursor/mcp.json for one project:
Open the settings of Cursor, find the genezio server in the MCP section, and click the button that connects it.

​
VS Code

Add the server to .vscode/mcp.json in your project:
Start the server from the file, and authenticate in the browser when VS Code asks.

​
Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json:

​
Other MCP clients

A client can connect to Genezio when it supports these items:
  • A remote MCP server with the Streamable HTTP transport.
  • OAuth 2.1 with PKCE and dynamic client registration.
The client finds the OAuth endpoints by itself, from the 401 answer of the server and from /.well-known/oauth-protected-resource. You only give it the MCP server URL.

​
Troubleshooting the connection

Genezio gives the MCP access only to a user who has an active subscription on at least one account. Ask the owner of your account to check the subscription.
The assistant sees only the brands that your Genezio user can open. Open the dashboard with the same user, and check that you can see the brand.
The client has only the Read permission. Remove the server from the client, add it again, and select Write on the page of the permissions.
An access token is valid for 12 hours, and the client gets a new one by itself. If the client does not use the server for 30 days, you must sign in again.