How to connect the Opik MCP server

Before you start

• An Opik Cloud (Comet) account. You pick the workspace the server works in when you sign in. comet.com/docsgithub.com/comet-ml
• For Cursor, Cursor Pro or higher; MCP isn't available on Cursor's Hobby plan. comet.com/docs
• This endpoint is for Opik Cloud. Dedicated or self-hosted Comet deployments offer the hosted-style flow only when the deployment runs the MCP OAuth server, which is off by default; otherwise use the local server. github.com/comet-mlcomet.com/docs

Authentication

Your client → Opik MCP

OAuth sign-in, handled by your MCP client. github.com/comet-mlcomet.com/docsmodelcontextprotocol.io/specification

Opik MCP → Opik API

The server acts on your account with the access you approve. github.com/comet-ml

Steps

1. Open Opik's MCP server setup instructions

   www.comet.com/docs/opik/mcp-server
2. Add the Opik MCP server to your client

   Add https://www.comet.com/opik/api/v1/mcp as a remote MCP server that uses the HTTP transport. Opik publishes one-click installs for Cursor and VS Code, a Claude Code plugin, and a setup command that configures Claude Code, Codex, Cursor, VS Code and opencode. Clients that run only local commands can use the mcp-remote bridge.

   comet.com/docsgithub.com/comet-mlregistry.modelcontextprotocol.io/v0.1
3. Sign in to Opik in the browser and pick a workspace
   comet.com/docsgithub.com/comet-ml
4. If you need an API key instead of browser sign-in, use the local server

   The hosted endpoint uses browser sign-in only. To authenticate with an Opik API key, run Opik's local server package instead and give it your API key and workspace name as described in Opik's documentation. The older TypeScript npm package (opik-mcp version 2) is deprecated and stops serving requests on 2026-11-15.

   github.com/comet-ml
5. List the server's tools

   Your client should list the server's tools. That confirms the connection, not every API permission.

   comet.com/docs

What we observed

• 5 Nov 2026: HTTP 401 with WWW-Authenticate resource_metadata https://www.comet.com/.well-known/oauth-protected-resource, which names the authorization server https://www.comet.com/opik and the resource https://www.comet.com/opik/api/v1/mcp.