Setup and installation

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

Connecting with Cursor

OAuth (recommended)

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

   {
     "mcpServers": {
       "coralogix-server": {
         "url": "https://api./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.

API key

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

   {
     "mcpServers": {
       "coralogix-server": {
         "url": "https://api./mgmt/api/v1/mcp",
         "headers": {
           "Authorization": "Bearer <YOUR-API-KEY>"
         }
       }
     }
   }
   

   Replace <YOUR-API-KEY> with a personal Coralogix API key. The MCP server inherits the permissions associated with the user's personal API key. Find out more in Permissions.

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

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

API key

claude mcp add coralogix-server \
  --transport http \
  https://api./mgmt/api/v1/mcp \
  --header "Authorization: Bearer <YOUR-API-KEY>"

Replace <YOUR-API-KEY> with a personal Coralogix API key. The MCP server inherits the permissions associated with the user's personal API key. Find out more in Permissions.

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

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. The MCP server inherits the permissions associated with the user's personal API key. Find out more in Permissions.

2. Register the MCP server:

   codex mcp add coralogix-server \
     --url "https://api./mgmt/api/v1/mcp" \
     --bearer-token-env-var CORALOGIX_API_KEY
   

3. Verify the configuration:

   codex mcp list
   codex mcp get coralogix-server
   

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

Next steps

Configure and enable your MCP server to connect to Coralogix using OAuth.