Skip to content
Developers
Get an API token

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.

View MarkdownOpen in Claude(opens in a new tab)

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.

  • 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.
How an assistant connects to a Novi MCP serverStep 1, in your assistant: add the Novi MCP server URL, one URL per product on your company host. Step 2, on Novi: your browser opens Novi sign-in; sign in as usual. Step 3, on Novi: check the client, product, company and email on the consent page, then approve. Step 4, in your assistant: tools run as you, for that product only, at your company, with your permissions. When the sign-in expires, the assistant asks you to sign in again, back at step 2.In your assistantOn NoviIn your assistant1234Add the serverURLOne URL perproduct, on yourcompany host.Sign inYour browseropens Novi sign-in.Sign in as usual.Approve theconsent pageCheck the client,product, companyand email, thenapprove.Tools run as youThat product only,at your company,with yourpermissions.When the sign-in expires, sign in againHow an assistant connects to a Novi MCP serverStep 1, in your assistant: add the Novi MCP server URL, one URL per product on your company host. Step 2, on Novi: your browser opens Novi sign-in; sign in as usual. Step 3, on Novi: check the client, product, company and email on the consent page, then approve. Step 4, in your assistant: tools run as you, for that product only, at your company, with your permissions. When the sign-in expires, the assistant asks you to sign in again, back at step 2.In your assistantAdd the server URLOne URL per product, on yourcompany host.On NoviSign inYour browser opens Novi sign-in. Signin as usual.On NoviApprove the consent pageCheck the client, product, companyand email, then approve.In your assistantTools run as youThat product only, at your company,with your permissions.1234When the sign-in expiresSign in again when the assistant asks.
  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.

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.

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