Connect Claude to EVA
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.
Before you start
Section titled “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
Section titled “Add the connector”-
In Claude, open Customize > Connectors, select + Add, then Add custom connector.
-
Enter a name, for example
Novi EVA, and the URLhttps://<your-company>.novilabs.io/eva/api/mcp. Select Continue, review the authentication Claude detects, select Continue again, then Add. -
Select Connect and sign in to Novi in the browser.
-
Approve Novi’s consent page, which shows the client, the application (EVA), your company, your email and how long the sign-in lasts.
-
In a chat, select +, then Connectors, and turn on the EVA connector.
-
An owner opens Organization settings > Connectors, selects Add, hovers over Custom and selects Web.
-
The owner enters a name, for example
Novi EVA, and the URLhttps://<your-company>.novilabs.io/eva/api/mcp, selects Continue twice, then Add. -
Each member opens Customize > Connectors, selects Connect on the connector, signs in and approves the Novi consent page.
-
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.
-
Add the server:
Terminal window claude mcp add --transport http novi-eva https://<your-company>.novilabs.io/eva/api/mcp -
Run
/mcp, selectnovi-evaand authenticate. Sign in to Novi in the browser, or open the URL Claude Code prints. -
Approve the Novi consent page.
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
Section titled “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.
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
Section titled “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. host |
The EVA MCP server is not yet available on company hosts | Use the REST API until it is |
LIMIT_ in a tool result |
Too many calls at once, or a result too large | Wait and retry, or narrow the question |