Upside MCP Setup

⚠️

Requires Admin-level access to ChatGPT Pro, Team, Enterprise, or Edu.

1. Open **ChatGPT.com** → click your profile icon in the bottom left → Settings
2. Click the Apps tab
3. Scroll to the bottom of the app list and find "Advanced settings"
4. Make sure Developer mode is enabled, then click "Create app"
   1. If you do not see an option for Developer Mode, you do not have sufficient privileges. Reach out to your administrator for help.

5. Fill in the app details:

   • Name: Upside

   • Description: Query Upside for Marketing Insights and Metrics

   • MCP Server URL: https://app.upside.tech/mcp

   • Authentication: OAuth (no need to add Client ID or Client Secret)

   • Check the box "I understand and want to continue"

   • Click Create

   • You will be redirected to log in to Upside (you do not need to do this at this stage and you can simply click back on your browser window)

   ⚠️

   Is Upside safe? Since OpenAI hasn't yet reviewed this MCP configuration, you will encounter several warnings. Rest assured, Upside has been approved for use at your organization and has already passed relevant compliance/security measures. If you have any questions about this, please ask your Upside admin or the team at Upside.

6. In Apps, you'll have a section for Drafts which will list the newly created Upside app → Click Upside

7. Click the 3 dots in the top right, and select Publish

8. Click Publish to approve this app for your team
   • Note: you will see additional warnings about potential risks such as unauthorized data access and malicious apps.
9. Check the acknowledgment boxes, then click Publish.
10. Assign the app to the appropriate users or groups:
    • Navigate to Workspace Settings → Settings & Permissions → Custom Roles
    • Select or create a role, and enable access to the Upside app for that role
    • Go to the Groups tab and assign the role to the relevant group(s), or assign it directly to individual users
    • Users will inherit access to the Upside app through their assigned role
11. You're done! Upside is now an app that can be used by the users and groups you assigned it to.

⚠️

Requires Admin or Owner-level access to Claude.

1. Open Claude at https://claude.ai or open Claude Desktop
2. Click your profile icon on the bottom left to go to Organization Settings
   1. In Claude Desktop, you may need to expand the sidebar first
3. Under the section labeled Libraries, click Connectors
4. Click the button below the list for Add Custom Connector

5. Enter Upside as the name and set the Remote MCP server URL to:

https://app.upside.tech/mcp

6. Click Add to finalize setup.
   1. Note: this will also enable the connector in Claude Desktop.

1. Run this command in your terminal:

claude mcp add upside --transport http https://app.upside.tech/mcp

2. Run claude in your terminal to launch Claude Code
3. Type /mcp to view MCP servers and authenticate Upside

As of early 2026, Gemini Chat (gemini.google.com) does not yet support MCP connectors. If available, you may try Gemini CLI as an alternative).

1. Run this command in your terminal:

gemini mcp add --transport http upside https://app.upside.tech/mcp

2. Run gemini in your terminal to launch Gemini CLI
3. Type /mcp to view MCP servers and authenticate Upside

1. Click this link to configure Cursor in one click
2. Click Install in Cursor when prompted.

3. In the MCP settings, click Connect and log in with your Upside credentials

   

   • Alternatively, if you'd like to set it up manually, you can add this to your .cursor/mcp.json:

     JSON

     {
       "mcpServers": {
         "upside": {
           "url": "https://app.upside.tech/mcp"
         }
       }
     }

4. Ensure the MCP toggle is enabled.

1. Open Craft Agents → Sources / MCPs
2. Click Add Source
3. Paste the URL:

https://app.upside.tech/mcp

4. Craft will detect the OAuth requirement and ask you to log in one time to complete authentication

5. Upside tools will now be available across all your sessions.

⚠️

Requires Codex CLI or Codex Desktop with an active OpenAI plan.

Codex CLI

1. Run the following command to add the Upside MCP server and configure the required User-Agent header:

macOS

codex mcp add upside --url https://app.upside.tech/mcp && printf '\n[mcp_servers.upside.http_headers]\nUser-Agent = "codex-mcp/1.0"\n' >> ~/.codex/config.toml

Windows

codex mcp add upside --url https://app.upside.tech/mcp; Add-Content "$HOME\.codex\config.toml" "`n[mcp_servers.upside.http_headers]`nUser-Agent = `"codex-mcp/1.0`"`n"

📘

The User-Agent header is required. Without it, the connection will be blocked with a 403 error — this is currently a known Codex bug.

2. Authenticate by running:

codex mcp login upside

3. Complete the OAuth flow in the browser window that opens, then return to your terminal.
4. Start a new chat thread to begin using Upside. Note that new MCP connections are not available in existing threads.

Codex Desktop

You can also add the MCP server in Codex Desktop via the settings menu. Enter https://app.upside.tech/mcp as the server URL. OAuth is used by default, even though the UI does not explicitly show it as an option.

⚠️

After adding the MCP server in Desktop, you must fully restart Codex for the changes to take effect. You will also need to start a new chat thread to use Upside.

Codex CLI and Desktop share the same configuration (~/.codex/config.toml), so setting it up in one works for both.

1. Follow steps in documentation: https://docs.dust.tt/docs/remote-mcp-server
2. Use https://app.upside.tech/mcp as the remote MCP server when prompted.

1. Follow steps in documentation: https://www.notion.com/help/mcp-connections-for-custom-agents
2. Use https://app.upside.tech/mcp as the remote MCP server when prompted.

1. Follow steps in documentation: https://docs.glean.com/administration/actions/connect-remote-mcp-servers-to-glean
2. Use https://app.upside.tech/mcp as the remote MCP server when prompted.

1. Follow steps in documentation: https://docs.lovable.dev/integrations/mcp-servers#how-to-connect-a-custom-mcp-server
2. Use https://app.upside.tech/mcp as the remote MCP server when prompted.