# Connect an assistant

Source: https://developers.novilabs.com/ai/connect/

> Which assistants each Novi MCP server supports today, and how to add one in Claude, Claude Code or Codex.

Add a Novi MCP server to your assistant with one URL. The assistant then signs you in through Novi, or sends a Novi API token where the server takes one.

## Which clients each server supports

| Client | Novi Forecasts | Novi EVA | Novi M&A Intelligence |
| --- | --- | --- | --- |
| Claude (claude.ai and Claude Desktop), custom connector with Novi sign-in | Supported | Supported | Supported |
| Claude Code, Novi sign-in | Supported | Supported | Supported |
| OpenAI Codex, Novi sign-in | Supported | Supported | Supported |
| Any client that sends a Novi API token in an `Authorization` header | Supported | Not supported | Supported |
| Claude Desktop extension `novi-forecasts.mcpb` | Supported | Not supported | Not supported |
| Any other client signing in | Not available yet | Not available yet | Not available yet |

An unsupported client sees: "Novi doesn't recognise the app that sent you here, so it can't connect to your account."

## Before you start

- **Your company host.** Use the host you use for Novi apps in the browser, in the server URL below.
- **Permissions.** Signing in needs **Access MCP** plus the product's own permission: Access Forecasts, Access EVA or Access Intelligence M&A. Your company's Novi administrator grants them.
- **A token, if you skip sign-in.** Forecasts and M&A Intelligence also take a Novi API token. See [Authentication](https://developers.novilabs.com/start/authentication/#novi-api-token).

## Add a server

| Server | URL |
| --- | --- |
| Novi Forecasts | `https://<your-company>.novilabs.io/forecasts/api/mcp` |
| Novi EVA | `https://<your-company>.novilabs.io/eva/api/mcp` |
| Novi M&A Intelligence | `https://<your-company>.novilabs.io/intelligence-ma/api/mcp` |

The Forecasts and EVA servers are in preview and not yet available on company hosts. Tools and permissions per server: [Agents and MCP](https://developers.novilabs.com/ai/#mcp-servers).

<McpSignIn />

  **Claude**
Add a custom connector with the server URL, connect, sign in with your Novi login and approve Novi's [consent page](https://developers.novilabs.com/start/authentication/#novi-sign-in-for-assistants). On a Claude Team or Enterprise plan, an owner adds the connector first.

Step-by-step screens: [Connect Claude to EVA](https://developers.novilabs.com/eva/connect-claude/) and [Forecasts MCP server](https://developers.novilabs.com/forecasts/mcp/).
  
  **Claude Code**
Add the servers you use, then run `/mcp` in Claude Code and sign in. If no browser opens, copy the URL Claude Code prints.

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

To send a Novi API token instead of signing in (Forecasts and M&A Intelligence only):

```bash
claude mcp add --transport http novi-forecasts https://<your-company>.novilabs.io/forecasts/api/mcp \
  --header "Authorization: Bearer <your-token>"
```
  
  **Codex**
Add the server URL as a remote MCP server in Codex and complete the Novi sign-in. Novi shows the same consent page.
  

## After you connect

| What happens | What to do |
| --- | --- |
| The sign-in ends after 30 days | Sign in again when the assistant asks |
| Your administrator removes Access MCP or the product permission | Access stops. Ask your administrator |
| The sign-in expired or was revoked | The assistant asks you to sign in again |
| A call fails because Novi could not check your sign-in just then | Retry. You stay signed in |

A sign-in works only for that product, at your company, through its MCP server. It does not work on Novi's REST APIs.

> **Note:**
> Only the clients above can sign in today, so your own agent cannot sign in yet. Use a Novi API token on Forecasts or M&A Intelligence, or the [EVA REST API](https://developers.novilabs.com/eva/api/) for scripts. Sign-in for other clients is [Planned].
