# Connect Claude to EVA

Source: https://developers.novilabs.com/eva/connect-claude/

> Add Novi EVA to Claude, Claude Code or Codex with one URL, sign in through Novi, and ask about wells in plain language.

Add Novi EVA to Claude, Claude Code or Codex, then ask for well rankings, production charts, type curves and maps in plain language. The assistant works in EVA as you.

> **Preview:**
> The EVA MCP server is in preview and not yet available on company hosts. These steps work once it is.

## Before you start

- **URL:** `https://<your-company>.novilabs.io/eva/api/mcp`, with the company name you use for Novi apps in the browser.
- **Permissions:** **Access EVA** and **Access MCP**, granted by your company's Novi administrator.
- **Client:** Claude (claude.ai and Claude Desktop), Claude Code or OpenAI Codex. API keys and personal tokens don't work.

## Add the connector

<McpSignIn />

  **Claude**

1. In Claude, open **Customize > Connectors**, select **+ Add**, then **Add custom connector**.

2. Enter a name, for example `Novi EVA`, and the URL `https://<your-company>.novilabs.io/eva/api/mcp`. Select **Continue**, review the authentication Claude detects, select **Continue** again, then **Add**.

3. Select **Connect** and sign in to Novi in the browser.

4. Approve Novi's consent page, which shows the client, the application (EVA), your company, your email and how long the sign-in lasts.

5. In a chat, select **+**, then **Connectors**, and turn on the EVA connector.

  
  **Claude Team or Enterprise**

1. An owner opens **Organization settings > Connectors**, selects **Add**, hovers over **Custom** and selects **Web**.

2. The owner enters a name, for example `Novi EVA`, and the URL `https://<your-company>.novilabs.io/eva/api/mcp`, selects **Continue** twice, then **Add**.

3. Each member opens **Customize > Connectors**, selects **Connect** on the connector, signs in and approves the Novi consent page.

4. In a chat, select **+**, then **Connectors**, and turn on the EVA connector.

The connector also shows up in Claude's mobile apps. If it does not, open Claude on the web or desktop first.
  
  **Claude Code**

1. Add the server:

   ```bash
   claude mcp add --transport http novi-eva https://<your-company>.novilabs.io/eva/api/mcp
   ```

2. Run `/mcp`, select `novi-eva` and authenticate. Sign in to Novi in the browser, or open the URL Claude Code prints.

3. Approve the Novi consent page.

  
  **Codex**
Add `https://<your-company>.novilabs.io/eva/api/mcp` as a remote MCP server in Codex and complete the Novi sign-in. Novi shows the same consent page.
  

## After you connect

Try: "Rank US basins by median first-12-month oil per 1,000 ft for wells online 2022 through 2024." More prompts and the tool list: [EVA MCP server](https://developers.novilabs.com/eva/mcp/).

When a sign-in expires, the assistant asks you to sign in again. If an administrator removes Access EVA or Access MCP, access stops within about two minutes.

## Troubleshooting

| What you see | Meaning | Fix |
|---|---|---|
| "Novi doesn't recognise the app that sent you here, so it can't connect to your account." | The client is not supported | Use Claude, Claude Code or Codex |
| `403` on every call | Missing Access EVA or Access MCP, a host for another company, or an API key instead of a sign-in | Ask your administrator for both permissions; use your own company host; remove any API key header and connect again |
| `401` after signing in | The sign-in expired or was revoked | Reconnect and sign in again |
| `503` | Novi could not check your sign-in just then | Retry in a moment. You do not need to sign in again |
| Sign-in fails, or calls return `404`, on a `novilabs.io` host | The EVA MCP server is not yet available on company hosts | Use the [REST API](https://developers.novilabs.com/eva/api/) until it is |
| `LIMIT_EXCEEDED` in a tool result | Too many calls at once, or a result too large | Wait and retry, or narrow the question |

> **Note:**
> A custom agent cannot sign in yet. For scripts, use the [REST API](https://developers.novilabs.com/eva/api/).
