Direct Connection

Cursor Direct Connection

If your version of Cursor supports remote HTTP MCP servers, this is the simplest way to connect to Euno MCP.

1. Open Cursor Settings

2. Go to Tools & Integrations

3. Add a new MCP server. In the mcp.json file that opens, add:

   {
     "mcpServers": {
       "euno-mcp": {
         "type": "http",
         "url": "https://api.app.euno.ai/mcp"
       }
     }
   }

4. Save the file

5. The first time you use Euno MCP, Cursor will prompt you to sign in to Euno in a browser

6. After sign-in, you can start using Euno MCP in chat

Claude Code Direct Connection

Use this for the Claude Code CLI or the Claude Code extension in VS Code.

1. Open your terminal (or VS Code Terminal → New Terminal)

2. Run: claude mcp add --transport http euno-mcp https://api.app.euno.ai/mcp

3. Open Claude Code (or the Claude Code extension tab in VS Code) and type /mcp

4. Choose euno-mcp and authenticate

5. Complete Euno sign-in in the browser when prompted

ChatGPT Direct Connection

ChatGPT can connect to Euno MCP as a custom connector. ChatGPT supports remote HTTP MCP servers over OAuth, which matches the recommended Euno setup, so no bridge or API key is required.

Custom MCP connectors in ChatGPT are available through Developer Mode, which is a beta feature. Before you start, note that:

• Developer Mode is available on the Plus, Pro, Business, Enterprise, and Education plans (web). It is not available on the free plan.

• On Business, Enterprise, and Education plans, a workspace admin may need to allow custom connectors before you can add one.

• Developer Mode gives the connector access to both read and write tools. Review actions before you confirm them.

Enable Developer Mode

1. In ChatGPT, open Settings

2. Go to Apps & Connectors (Connectors)

3. Open Advanced settings

4. Turn on Developer mode

Add the Euno connector

1. Return to Apps & Connectors and select Create (or Add new connector)

2. Enter the connector details:

   • Name: Euno (or another name you'll recognize)

   • Description (optional): a short note such as "Explore the Euno data model"

   • MCP Server URL: https://api.app.euno.ai/mcp

3. Set Authentication to OAuth

4. Confirm that you trust the application, then select Create

5. The first time you use a Euno tool, ChatGPT will prompt you to sign in to Euno in a browser. Complete the OAuth sign-in.

6. After sign-in, enable the Euno connector from the Developer Mode tool in the message composer, then start using Euno MCP in chat

Troubleshooting

Euno MCP does not appear in Cursor

1. Confirm that your mcp.json file is valid JSON

2. Save the file and refresh Tools & Integrations

3. Re-open Tools & Integrations and confirm that the Euno MCP server appears there

Euno MCP does not appear in Claude Code extension on VS Code

This setup uses the Claude Code extension or CLI, not Claude Desktop. In VS Code, open the Claude Code chat panel and run /mcp there. The Manage MCP Servers settings view can show "No servers" even when the server is configured correctly. Start with Confirm the CLI registered the server.

Confirm the CLI registered the server

In VS Code → Terminal (the same environment you use day to day—not a different shell such as WSL unless you always use WSL):

claude mcp list
claude mcp get euno-mcp

Result	What to do
euno-mcp is listed	The server is configured. Continue with Connect from the VS Code extension.
claude is not found	Install Claude Code and ensure it is on your PATH in VS Code's terminal. On Windows, run where claude in PowerShell.
euno-mcp is missing	Continue with Fix scope and project folder mismatches.

On Windows, you can also open %USERPROFILE%\.claude.json (for example, C:\Users\YourName\.claude.json) and search for euno-mcp:

• Found under top-level mcpServers — the entry exists. Continue with Connect from the VS Code extension and run /mcp to sign in.

• Found only under projects.<folder>.mcpServers — the server is tied to one folder. Either open that same folder in VS Code, or continue with Fix scope and project folder mismatches.

• Not found — the add command did not save. Continue with Fix scope and project folder mismatches and run claude mcp add again.

Fix scope and project folder mismatches

claude mcp add defaults to local scope for the terminal's current working directory. If you ran the command in one folder but opened a different folder in VS Code, the server may not appear.

Add the server for all your projects:

claude mcp add --transport http --scope user euno-mcp https://api.app.euno.ai/mcp

Or add a project-scoped entry by creating .mcp.json in your project root:

{
  "mcpServers": {
    "euno-mcp": {
      "type": "http",
      "url": "https://api.app.euno.ai/mcp"
    }
  }
}

Save the file, fully quit VS Code, and reopen it. Then continue with Connect from the VS Code extension.

Windows and WSL

• If you ran claude mcp add in WSL but use VS Code on Windows (or the reverse), the configs live in different home directories. Run the add command in the same environment VS Code uses.

• After changing config, restart VS Code completely (not only reload the window), then continue with Connect from the VS Code extension.

Connect from the VS Code extension

Use this section when claude mcp list shows euno-mcp, but the Claude Code extension still does not list it or offer Euno tools.

This is a known limitation in some Claude Code extension versions: the terminal lists MCP servers, but the extension UI does not show them until you connect from the extension itself.

Try these in order:

1. In the Claude Code extension chat (not an external terminal), run /mcp, choose euno-mcp, and complete Euno sign-in in the browser.

2. If euno-mcp is only under projects.<path>.mcpServers in %USERPROFILE%\.claude.json, copy the entry to the top-level mcpServers object in that file (back up the file first). See also Fix scope and project folder mismatches.

3. In extension chat, run /switch-account and sign in again—the extension can use a separate session from the terminal.

4. Start a chat in the extension and ask: What MCP servers are available? Some users report this initializes MCP for that session.

If none of these steps work, continue with Still not working on Windows.

Still not working on Windows

If you completed Connect from the VS Code extension and Euno MCP still does not work, use the MCP Bridge Setup with Node.js 18+ and npx, or share the following with your Euno support contact:

claude --version
claude mcp list
claude mcp get euno-mcp

The Euno sign-in page does not open

1. Try the connection again

2. Check whether your browser prevented the sign-in page from opening

Euno asks you to choose a persona

This is expected when Euno cannot identify a single clear persona automatically.

1. Choose one of the offered personas to continue

2. If you want to change later, ask your assistant to show your available personas and switch to another one

Euno MCP is connected, but no tools appear

1. Make sure your active persona has access to the Euno resources you expect to use

2. Ask your assistant to show your available personas

3. If needed, switch to another persona and try again

Sign-in worked before, but now fails

1. Try the connection again

2. Remove and re-add the Euno MCP server entry if the issue persists

3. If the problem continues, contact your Euno team or support team