Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs-docusaurus.kinsta.page%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%2Fdocs-docusaurus.kinsta.page%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 configuration examples below use v2, the current MCP server version. If you need to stay on v1, send the `mcp-version: v1` header instead. v1 is deprecated and 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 alongside `mcp-version: v2`. See [Olly](https://docs-docusaurus.kinsta.page/user-guides/mcp-server/tools/olly/.md) for the full setup. ## 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", "headers": { "mcp-version": "v2" } } } } ``` 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://docs-docusaurus.kinsta.page/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 ", "mcp-version": "v2" } } } } ``` Replace `` with a personal [Coralogix API key](https://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/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 --header "mcp-version: v2" ``` 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://docs-docusaurus.kinsta.page/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 " \ --header "mcp-version: v2" ``` Replace `` with a personal [Coralogix API key](https://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/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. Selecting MCP server v2 with Codex `codex mcp add` can't set custom request headers, so the commands below don't select a server version on their own. After registering, add the `mcp-version` header to the `coralogix-server` entry in `~/.codex/config.toml`: ``` [mcp_servers.coralogix-server] http_headers = { "mcp-version" = "v2" } ``` Without this header, Codex uses v1. ### 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://docs-docusaurus.kinsta.page/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="" ``` Replace `` with a personal [Coralogix API key](https://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/user-guides/account-management/account-settings/coralogix-domain/.md) using the domain selector at the top of the page. ## 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://docs-docusaurus.kinsta.page/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://docs-docusaurus.kinsta.page/user-guides/mcp-server/oauth/.md).