> For the complete documentation index, see [llms.txt](https://docs.euno.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.euno.ai/ai/mcp-setup/direct-connection.md).

# 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:

   ```json
   {
     "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 <a href="#chatgpt-direct-connection" id="chatgpt-direct-connection"></a>

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 <a href="#toc_7" id="toc_7"></a>

1. In ChatGPT, open **Settings**
2. Go to **Apps & Connectors** (Connectors)
3. Open **Advanced settings**
4. Turn on **Developer mode**

#### Add the Euno connector <a href="#toc_8" id="toc_8"></a>

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).

#### 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):

```bash
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](#connect-from-the-vs-code-extension).                                                         |
| `claude` is not found | Install [Claude Code](https://docs.anthropic.com/en/docs/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](#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](#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](#fix-scope-and-project-folder-mismatches).
* **Not found** — the add command did not save. Continue with [Fix scope and project folder mismatches](#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:

```bash
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:

```json
{
  "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](#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).

#### 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](#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).

#### Still not working on Windows

If you completed [Connect from the VS Code extension](#connect-from-the-vs-code-extension) and Euno MCP still does not work, use the [MCP Bridge Setup](/ai/mcp-bridge-setup.md) with Node.js 18+ and `npx`, or share the following with your Euno support contact:

```bash
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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.euno.ai/ai/mcp-setup/direct-connection.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.