---
title: Setup
description: Easily set up Coralogix's MCP server. It is fully remote and does not require any local installation.
url: https://coralogix.com/docs/user-guides/mcp-server/setup/
product: ai
feature: MCP
feature_id: mcp
feature_identifier: ai/mcp
last_updated: '2026-09-03'
---

# Setup and installation

The MCP server is **fully remote** and does **not** require any local installation.

Staying on MCP server v1

The MCP server uses v2 by default, so the configuration examples below don't set a version header. To stay on the deprecated v1, send the `mcp-version: v1` header instead. v1 will be removed, so plan to migrate to v2.

Using Olly through MCP

Olly tools are hidden by default. To use them, add the `x-allow-costly-use: true` header to your MCP server configuration. See [Enabling Olly tools](#enabling-olly-tools) below. For the full Olly tool reference, see [Olly](https://coralogix.com/docs/user-guides/mcp-server/tools/catalog.md#olly).

## Connecting with Cursor

### OAuth (recommended)

1. Add the following to your `.cursor/mcp.json` file:

   ```
   {

     "mcpServers": {

       "coralogix-server": {

         "url": "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"

       }

     }

   }
   ```

2. Open the MCP settings in Cursor and enable the new MCP server.

3. A browser window will open, log in to Coralogix and click **Authorize** to complete the connection.

Cursor handles authentication via OAuth 2.1 with OpenID Connect (OIDC). For more details, see [Authorize MCP with OAuth 2.1](https://coralogix.com/docs/user-guides/mcp-server/oauth.md).

### API key

1. Add the following to your `.cursor/mcp.json` file:

   ```
   {

     "mcpServers": {

       "coralogix-server": {

         "url": "https://api.eu2.coralogix.com/mgmt/api/v1/mcp",

         "headers": {

           "Authorization": "Bearer <YOUR-API-KEY>"

         }

       }

     }

   }
   ```

   Replace `<YOUR-API-KEY>` with a personal [Coralogix API key](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md). The MCP server inherits the permissions associated with the user's personal API key. Find out more in [Permissions](https://coralogix.com/docs/user-guides/mcp-server/permissions.md).

2. Open the MCP settings in Cursor and enable the new MCP server.

Note

If necessary, modify the <!-- -->https\://api./mgmt/api/v1/mcp<!-- --> endpoint to correspond to your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md) using the domain selector at the top of the page.

## Connecting with Claude Code

Configure the MCP server using the Claude Code CLI.

### OAuth (recommended)

1. Register the MCP server:

   ```
   claude mcp add --transport http coralogix-server https://api.eu2.coralogix.com/mgmt/api/v1/mcp
   ```

2. Authenticate:

   ```
   claude /mcp
   ```

   * Select **coralogix-server**.
   * Select **Authenticate**.
   * A browser window will open, log in to Coralogix and click **Authorize** to complete the connection.

Claude Code handles authentication via OAuth 2.1 with OpenID Connect (OIDC). For more details, see [Authorize MCP with OAuth 2.1](https://coralogix.com/docs/user-guides/mcp-server/oauth.md).

### API key

```
claude mcp add coralogix-server \

  --transport http \

  https://api.eu2.coralogix.com/mgmt/api/v1/mcp \

  --header "Authorization: Bearer <YOUR-API-KEY>"
```

Replace `<YOUR-API-KEY>` with a personal [Coralogix API key](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md). The MCP server inherits the permissions associated with the user's personal API key. Find out more in [Permissions](https://coralogix.com/docs/user-guides/mcp-server/permissions.md).

Note

If necessary, modify the <!-- -->https\://api./mgmt/api/v1/mcp<!-- --> endpoint to correspond to your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md) using the domain selector at the top of the page.

## Connecting with Codex

Configure the MCP server using the Codex CLI.

### OAuth (recommended)

1. Register the MCP server:

   ```
   codex mcp add coralogix-server --url "https://api.eu2.coralogix.com/mgmt/api/v1/mcp"
   ```

2. Authenticate:

   ```
   codex mcp login coralogix-server
   ```

   A browser window will open, log in to Coralogix and click **Authorize** to complete the connection.

Codex handles authentication via OAuth 2.1 with OpenID Connect (OIDC). For more details, see [Authorize MCP with OAuth 2.1](https://coralogix.com/docs/user-guides/mcp-server/oauth.md).

### API key

1. Set your API key as an environment variable:

   ```
   export CORALOGIX_API_KEY="<YOUR-API-KEY>"
   ```

   Replace `<YOUR-API-KEY>` with a personal [Coralogix API key](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys.md). The MCP server inherits the permissions associated with the user's personal API key. Find out more in [Permissions](https://coralogix.com/docs/user-guides/mcp-server/permissions.md).

2. Register the MCP server:

   ```
   codex mcp add coralogix-server \

     --url "https://api.eu2.coralogix.com/mgmt/api/v1/mcp" \

     --bearer-token-env-var CORALOGIX_API_KEY
   ```

3. Verify the configuration:

   ```
   codex mcp list

   codex mcp get coralogix-server
   ```

Note

If necessary, modify the <!-- -->https\://api./mgmt/api/v1/mcp<!-- --> endpoint to correspond to your Coralogix [domain](https://coralogix.com/docs/user-guides/account-management/account-settings/coralogix-domain.md) using the domain selector at the top of the page.

## Enabling Olly tools

[Olly](https://coralogix.com/docs/user-guides/mcp-server/tools/catalog.md#olly) tools are hidden by default. To advertise them to your client, add the `x-allow-costly-use: true` header to your MCP server configuration. Set it once on the `coralogix-server` entry so it applies to every tool listing and call.

For Cursor, add the header to your `.cursor/mcp.json` file:

```
{

  "mcpServers": {

    "coralogix-server": {

      "url": "https://api.eu2.coralogix.com/mgmt/api/v1/mcp",

      "headers": {

        "x-allow-costly-use": "true"

      }

    }

  }

}
```

For Claude Code, register the server with the header:

```
claude mcp add --transport http coralogix-server https://api.eu2.coralogix.com/mgmt/api/v1/mcp \

  --header "x-allow-costly-use: true"
```

For Codex, add the header to the `coralogix-server` entry in `~/.codex/config.toml`:

```
[mcp_servers.coralogix-server]

http_headers = { "x-allow-costly-use" = "true" }
```

If you authenticate with an API key, keep the `Authorization` header alongside `x-allow-costly-use`. See [Olly](https://coralogix.com/docs/user-guides/mcp-server/tools/catalog.md#olly) for the full tool reference.

## Using a proxy for outbound connections

If your network requires a proxy for outbound connections, set the standard `HTTP_PROXY` / `HTTPS_PROXY` environment variables before running your CLI client. The MCP client picks up your system proxy settings automatically.

```
export HTTPS_PROXY="https://your-proxy:port"
```

## Starting a session

Start a conversation by entering a prompt such as:

```
Show me the most frequent errors for service XYZ in the past week.
```

The assistant locates relevant log entries and identifies problematic functions.

## Requesting a fix for agent-based IDEs

After identifying the issue, for agent-based IDEs such as Cursor, instruct the assistant to fix it by saying:

```
Now, fix the issue.
```

You can also ask:

```
When did the issue start?
```

## Additional resources

|                     |                                                                                       |
| ------------------- | ------------------------------------------------------------------------------------- |
| Coralogix Endpoints | [Coralogix Endpoints](https://coralogix.com/docs/integrations/coralogix-endpoints.md) |

## Next steps

Configure and enable your MCP server to [connect to Coralogix using OAuth](https://coralogix.com/docs/user-guides/mcp-server/oauth.md).