# Supersonik MCP Server **MCP Server URL:** `https://api.supersonik.ai/mcp` **Authentication:** OAuth. No API key required. --- ## Contents - [Quick install](#quick-install) - [Confirm the connection](#confirm-the-connection) - [What you can ask](#what-you-can-ask) - [Requirements](#requirements) - [How it works](#how-it-works) - [Security and data access](#security-and-data-access) - [Troubleshooting](#troubleshooting) - [Support](#support) --- ## Quick install Add Supersonik as a remote HTTP server, complete the browser sign-in, and enable its tools in your client. There is no package to install and no API key to create. ### ChatGPT #### ChatGPT on the web 1. In ChatGPT, open **Settings → Security and login** and turn on **Developer mode**. 2. Open [ChatGPT Plugins](https://chatgpt.com/plugins), select **+**, and create a developer-mode app named **Supersonik**. 3. Under **Connection**, enter `https://api.supersonik.ai/mcp`, then create the connection and complete the Supersonik sign-in. 4. Start a new conversation, select **+ → Developer mode**, and enable Supersonik for the conversation. Developer mode is available on ChatGPT Pro, Plus, Business, Enterprise, and Education accounts on the web. A workspace administrator may need to allow it. #### ChatGPT desktop app 1. Open **Settings → MCP servers** and select **Add server**. 2. Name it **Supersonik**, choose **Streamable HTTP**, and enter `https://api.supersonik.ai/mcp`. 3. Save the server, restart the app, then select **Authenticate** to sign in. Type `/mcp` in the composer to view the connected server. ### Codex Run these commands in a terminal: ```sh codex mcp add supersonik --url https://api.supersonik.ai/mcp codex mcp login supersonik ``` The second command opens the Supersonik sign-in in your browser. Run `codex mcp list` to confirm the connection, or use `/mcp` inside the Codex terminal UI. Codex CLI, the Codex IDE extension, and the ChatGPT desktop app share this MCP configuration on the same computer. ### Claude Code Run these commands to add Supersonik for every project and start the browser sign-in: ```sh claude mcp add --transport http supersonik --scope user https://api.supersonik.ai/mcp claude mcp login supersonik ``` The second command opens the Supersonik sign-in in your browser. Run `claude mcp list` afterward if you want to confirm the server reports **Connected**. ### Claude and Claude Desktop 1. Open **Customize → Connectors**, select **+**, then choose **Add custom connector**. 2. Name it **Supersonik** and paste `https://api.supersonik.ai/mcp` as the connector URL. 3. Select **Add**, then **Connect**, and sign in to Supersonik. 4. In a conversation, select **+ → Connectors** and enable Supersonik. The connector is stored on your Claude account, so the same connection is available in Claude on the web and in Claude Desktop. On Team and Enterprise plans, an owner must first add it from **Organization settings → Connectors**; members can then find it under **Customize → Connectors** and select **Connect**. ### Cursor Add the server under **Cursor Settings → Tools & MCP**, or add it to your global `~/.cursor/mcp.json` file so it is available in every project: ```json { "mcpServers": { "supersonik": { "url": "https://api.supersonik.ai/mcp" } } } ``` Cursor asks you to authenticate with Supersonik when it first connects. Make sure the server and its tools are enabled under **Tools & MCP** before using it in Agent. ### Other MCP clients Choose your client's option for adding a **remote Streamable HTTP** server and use this URL: ```text https://api.supersonik.ai/mcp ``` Complete the OAuth sign-in when prompted. A compatible client discovers the authentication configuration automatically, so you do not need to provide a client ID, secret, or API key. ## Confirm the connection Ask your assistant: ```text Who am I in Supersonik, and which organizations can I access? ``` The assistant should use Supersonik and return your identity and accessible organizations. If it answers without using a Supersonik tool, open the client's tools or connectors menu and confirm the server is connected and enabled for the current conversation. ## What you can ask Once connected, try prompts such as: - "List the insights configured for my organization." - "What insight results do we have for demo ``?" - "Across recent demos, summarize how our insights are performing." - "Summarize insight coverage, latest results, and quality." Supersonik gives the assistant read-only tools for your identity, organizations, configured insights, and collected demo results. Nothing can be created, changed, or deleted through the MCP server. If you can access more than one organization, ask the assistant to list them first, then name the organization it should use for later requests. ## Requirements - **A Supersonik account.** Sign in with the credentials you use at [app.supersonik.ai](https://app.supersonik.ai). The server only returns data your existing permissions allow. - **A client with remote MCP and OAuth support.** Some clients require a paid plan, and workspace administrators may need to allow custom connections. ## How it works Supersonik exposes a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server. MCP is an open standard that lets AI assistants and agents connect to external tools and data. The Supersonik server uses the remote Streamable HTTP transport and OAuth, so compatible clients can discover and authenticate the connection without a locally installed package. ## Security and data access - **Authentication** uses OAuth against Supersonik's identity provider. No API key is required, and your password is never shared with the AI client. The connection holds a token issued to you personally. - **Authorization** mirrors the Supersonik app. Every tool call is checked against your permissions and scoped to your organization; the server never exposes another organization's data. - **Read-only.** The available tools only read data. - **Disconnecting.** Remove or disconnect the server in your client's settings at any time to revoke its access. ## Troubleshooting | Symptom | Likely cause and fix | |---------|----------------------| | Sign-in window fails or shows an error | Confirm you can log in at [app.supersonik.ai](https://app.supersonik.ai) with the same credentials. If that works and the connection still fails, contact support. | | Connected, but no Supersonik tools appear | Make sure the server is enabled for the current chat or session (many clients require enabling connectors per conversation). Tool lists are also filtered by your permissions, so a restricted account sees fewer tools. | | Tools worked before and now error | Disconnect and reconnect the server in your client's settings to refresh the authentication, then retry. | ## Support Questions or issues? Contact your Supersonik account team or write to [support@supersonik.ai](mailto:support@supersonik.ai). Last updated: 2026-08-14.