Opik
An implementation of the Model Context Protocol for the Opik platform that provides a unified interface for accessing Opik's capabilities, supporting multiple transport mechanisms for flexible integration with IDEs and other environments.
What is Opik?
Opik is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to implementation of the model context protocol for the opik platform that provides a unified interface for accessing opik's capabilities, supporting multiple transport mechanisms for flexible integratio...
An implementation of the Model Context Protocol for the Opik platform that provides a unified interface for accessing Opik's capabilities, supporting multiple transport mechanisms for flexible integration with IDEs and other environments.
This server falls under the Developer Tools and Coding Agents categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- opik-integration-docs
- get-prompts
- create-prompt
- get-prompt-version
- save-prompt-version
Use Cases
Maintainer
Works with
Installation
NPM
npx -y opik-mcpManual Installation
npx -y opik-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Opik
The Opik MCP server connects AI coding assistants and IDEs to Comet's Opik platform for LLM evaluation, tracing, and monitoring, exposing six universal tools that let you read, list, and write Opik entities — including projects, traces, spans, experiments, prompts, and test suites — entirely through natural language. It supports both stdio and streamable-HTTP transports and works with Claude Code, Cursor, VS Code Copilot, and other MCP clients, making it easy to inspect evaluation results, log traces, and manage prompt versions without leaving your development environment.
Prerequisites
- Python 3.13 or later
- uv package manager installed (curl -LsSf https://astral.sh/uv/install.sh | sh)
- A Comet/Opik account with an API key from comet.com/api/my/settings/
- Your Opik workspace name (defaults to 'default' if omitted)
- Claude Code, Cursor, or another MCP-compatible client
Install uv if not already available
uv is the recommended Python package runner for Opik MCP. Install it with the one-liner below.
curl -LsSf https://astral.sh/uv/install.sh | shTest the server manually
Run the server once from the command line to confirm your credentials work before connecting a client.
OPIK_API_KEY=your_api_key OPIK_WORKSPACE=your_workspace uvx opik-mcp@latestAdd to Claude Code via CLI
Register the Opik MCP server with Claude Code in one command, passing credentials as environment variables.
claude mcp add --transport stdio opik-mcp \
--env OPIK_API_KEY=your_api_key \
--env OPIK_WORKSPACE=your_workspace \
-- uvx opik-mcpConfigure Claude Desktop
Add the server to claude_desktop_config.json (or ~/.claude.json for Claude Code) with the uvx command and your credentials in the env block.
{
"mcpServers": {
"opik-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["opik-mcp"],
"env": {
"OPIK_API_KEY": "your_api_key",
"OPIK_WORKSPACE": "your_workspace"
}
}
}
}Restart your MCP client and verify
Restart Claude Desktop or your IDE. Ask the assistant to list your Opik projects or retrieve a recent trace to confirm the connection is working.
Opik Examples
Client configuration
claude_desktop_config.json / ~/.claude.json entry for Opik MCP using uvx with required credentials.
{
"mcpServers": {
"opik-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["opik-mcp"],
"env": {
"OPIK_API_KEY": "your_opik_api_key",
"OPIK_WORKSPACE": "your_workspace_name"
}
}
}
}Prompts to try
Example prompts that exercise the six Opik MCP tools across reading, listing, and writing operations.
- "List all projects in my Opik workspace."
- "Show me the most recent 10 traces for project 'my-llm-app'."
- "Retrieve prompt version 3 of the 'summarization-prompt' prompt."
- "Create a new prompt version with the text: 'You are a concise summarizer. Summarize in 2 sentences.'"
- "What experiments have been run on test suite 'accuracy-v2'?"Troubleshooting Opik
Server starts but returns 'Unauthorized' or '401' errors
Double-check OPIK_API_KEY by logging into comet.com/api/my/settings/ and regenerating a key if needed. Ensure OPIK_WORKSPACE matches exactly the workspace name shown in the Opik UI (case-sensitive).
ask_ollie or run_experiment tools are unavailable
These tools are only available on Comet Cloud (hosted Opik). Self-hosted Opik installations only support the read, list, write, and schema tools. Switch to the hosted service or use the other four tools directly.
Cursor times out on long ask_ollie calls
Cursor enforces a hard 60-second timeout per tool call. Use Claude Code instead, which has no documented timeout and keeps connections alive via heartbeats during long-running Opik operations.
Frequently Asked Questions about Opik
What is Opik?
Opik is a Model Context Protocol (MCP) server that implementation of the model context protocol for the opik platform that provides a unified interface for accessing opik's capabilities, supporting multiple transport mechanisms for flexible integration with ides and other environments. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Opik?
Install via npm with the command: npx -y opik-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Opik?
Opik works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Opik free to use?
Yes, Opik is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Opik Alternatives — Similar Developer Tools Servers
Looking for alternatives to Opik? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Opik in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Opik?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.