Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fmcp-server%2Fsetup.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fmcp-server%2Fsetup.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

# 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[​](#connecting-with-cursor "Direct link to Connecting with Cursor")

### OAuth (recommended)[​](#oauth-recommended "Direct link to 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[​](#api-key "Direct link to 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[​](#connecting-with-claude-code "Direct link to Connecting with Claude Code")

Configure the MCP server using the Claude Code CLI.

### OAuth (recommended)[​](#oauth-recommended-1 "Direct link to 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[​](#api-key-1 "Direct link to 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[​](#connecting-with-codex "Direct link to Connecting with Codex")

Configure the MCP server using the Codex CLI.

### OAuth (recommended)[​](#oauth-recommended-2 "Direct link to 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[​](#api-key-2 "Direct link to 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[​](#enabling-olly-tools "Direct link to 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[​](#using-a-proxy-for-outbound-connections "Direct link to 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[​](#starting-a-session "Direct link to 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[​](#requesting-a-fix-for-agent-based-ides "Direct link to 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[​](#additional-resources "Direct link to Additional resources")

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

## Next steps[​](#next-steps "Direct link to Next steps")

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