Registra sesiones de Claude Code en Opik como trazas y añade skills para instrumentar y evaluar aplicaciones de IA.
También conocido como comet-ml/opik-claude-code-plugin
- Stars
- 25
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 22 oct 2026
- Licencia
- Apache-2.0
¿Qué es Opik MCP?
Registra sesiones de Claude Code en Opik como trazas y añade skills para instrumentar y evaluar aplicaciones de IA.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Opik
Los desarrolladores que utilizan Claude Code pueden monitorear sus sesiones de IA registrándolas como trazas en la plataforma de observabilidad Opik. Este plugin captura automáticamente los turnos de conversación, las llamadas a herramientas y los pensamientos como spans, además de rastrear las llamadas de subagentes anidados mediante relaciones padre-hijo. Está diseñado para proporcionar visibilidad sobre cómo se comportan los agentes de codificación durante tareas complejas sin ralentizar la experiencia del usuario.
Más allá del registro de sesiones, el plugin ofrece skills y agentes especializados para ayudar a construir y mantener aplicaciones de IA observables. Los usuarios pueden instrumentar su propio código en Python o TypeScript detectando automáticamente frameworks como LangChain, OpenAI o LlamaIndex y añadiendo los decoradores de rastreo necesarios. La configuración requiere instalar el plugin a través del marketplace de Claude Code y configurar una conexión con Opik usando el CLI de Opik con una API key y la configuración del workspace.
Esta herramienta se distingue por ofrecer un agente revisor dedicado para verificar la arquitectura de los agentes en términos de seguridad e idempotencia. También incluye un pack de skills completo para tareas como depurar trazas fallidas, comparar resultados de experimentos y optimizar prompts directamente dentro de la interfaz de IA.
Qué puedes hacer con él
- 1Rastrear sesiones de Claude CodeRegistra automáticamente cada interacción y llamada a herramientas dentro de una sesión de Claude Code en la plataforma Opik para su revisión posterior.
- 2Instrumentar código de aplicacionesAñade observabilidad a proyectos existentes de Python o TypeScript detectando e integrando automáticamente los frameworks de IA compatibles.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
OPIK_CC_PARENT_TRACE_IDOPIK_CC_PROJECTOPIK_CC_ROOT_SPAN_IDOPIK_CC_TRUNCATE_FIELDSOPIK_CC_WORKSPACE
| Nombre | Descripción | Tipo |
|---|---|---|
| OPIK_CC_PARENT_TRACE_ID | — | |
| OPIK_CC_PROJECT | — | |
| OPIK_CC_ROOT_SPAN_ID | — | |
| OPIK_CC_TRUNCATE_FIELDS | — | |
| OPIK_CC_WORKSPACE | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblecomet-ml/opik-claude-code-plugin is public and reachablegithub.com/comet-ml/opik-claude-code-plugin ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-22github.com/comet-ml/opik-claude-code-plugin ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubOpik Claude Code Plugin
Log Claude Code sessions to Opik for LLM observability, plus skills and agents for building observable AI applications.
Opik is the open-source LLM observability and evaluation platform, built by Comet.
Features
- Session Tracing: Automatically log Claude Code sessions as Opik traces
- Span Tracking: Each tool call becomes a span within the trace
- Subagent Support: Nested agent calls are tracked with parent-child relationships
- Skills: Built-in knowledge for LLM observability, tracing, and evaluation
- Agents: Code review agent for agent architecture best practices
How Tracing Works
We trigger tracing for everything done in Claude Code, but don't slow you down.
Each conversation turn becomes an Opik trace. Tool calls, thoughts, and responses become spans. Subagent invocations are nested under their parent Task span.
Installation
From within Claude Code:
/plugin marketplace add comet-ml/opik-claude-code-plugin
Then install the plugin:
/plugin install opik
Local Install (for contributors)
If you've cloned the repo locally, add it as a marketplace and install from there:
/plugin marketplace add /path/to/opik-claude-code-plugin
/plugin install opik
Important: Restart any running Claude Code sessions after installation. Hooks only load when a session starts.
Configuration
Run the Opik CLI to configure your connection:
pip install opik
opik configure
This creates ~/.opik.config with your API URL, key, and workspace.
Optional Environment Variables
export OPIK_CC_PROJECT="my-project" # Project name (default: claude-code)
export OPIK_CC_WORKSPACE="my-workspace" # Workspace override (default: OPIK_WORKSPACE / ~/.opik.config)
export OPIK_CC_TRUNCATE_FIELDS="false" # Don't truncate large fields
All plugin env vars use the OPIK_CC_ prefix to avoid conflicts with standard Opik SDK variables.
OPIK_CC_WORKSPACE and OPIK_CC_PROJECT let you send Claude Code traces to a different
workspace/project than the rest of your Opik setup, without touching the global
OPIK_WORKSPACE / project_name in ~/.opik.config used by the Opik SDK. Both can also be
set in ~/.opik.config via the plugin-scoped cc_workspace and cc_project keys:
[opik]
workspace = my-sdk-workspace # used by the Opik SDK
project_name = my-sdk-project # used by the Opik SDK
cc_workspace = my-cc-workspace # used only by the Claude Code plugin
cc_project_name = my-cc-project # used only by the Claude Code plugin
Note: for backward compatibility, if
cc_project_nameis not set the plugin still falls back to the sharedproject_namekey.
External Trace Linking
Link Claude Code sessions to existing Opik traces (useful for embedding Claude Code in larger workflows):
export OPIK_CC_PARENT_TRACE_ID="your-trace-id" # Attach to existing trace
export OPIK_CC_ROOT_SPAN_ID="your-span-id" # Set parent span for all Claude Code spans
MCP Server Setup
The Opik MCP server provides Claude with tools to interact with your Opik data - query traces, analyze experiments, and access evaluation results directly in conversation.
For Opik Cloud
Add to your ~/.claude.json:
{
"mcpServers": {
"opik": {
"command": "npx",
"args": ["-y", "opik-mcp", "--apiKey", "YOUR_OPIK_API_KEY"]
}
}
}
Replace YOUR_OPIK_API_KEY with your API key from comet.com.
For Self-Hosted Opik
{
"mcpServers": {
"opik": {
"command": "npx",
"args": ["-y", "opik-mcp", "--apiBaseUrl", "http://localhost:5173/api"]
}
}
}
Adjust the apiBaseUrl to match your Opik instance.
Pre-configured Templates
Copy-ready configurations are available in mcp-configs/mcp-servers.json.
Commands
/opik:trace-claude-code - Claude Code Session Tracing
Enable/disable automatic tracing of your Claude Code sessions to Opik.
/opik:trace-claude-code start # Enable tracing for this project
/opik:trace-claude-code start --debug # Enable tracing + debug logging
/opik:trace-claude-code stop # Disable tracing for this project
/opik:trace-claude-code status # Check project + global + effective state
/opik:trace-claude-code start --global # Enable tracing for all projects
/opik:trace-claude-code stop --global # Disable tracing globally
Tracing state is stored in .claude/.opik-tracing-enabled (project) or ~/.claude/.opik-tracing-enabled (global). Resolution order (first match wins):
- Project file containing
off/disabled→ disabled (opt a single project out of a global enable) - Project file present → enabled (
debugcontent also enables debug logging) - Global file present → enabled (same content rules)
- Neither → disabled
So the project setting always takes precedence over the global one. Running stop in a project while global tracing is on writes the off opt-out for that project rather than removing the global enable.
Note: Changes take effect immediately for new conversation turns (no restart needed).
/opik:instrument - Add Observability to Your Code
Automatically detect frameworks in your code and add the correct Opik integration.
/opik:instrument my_agent.py # Add tracing to a specific file
/opik:instrument # Analyze current context and add tracing
Supports automatic detection and integration for:
- Python: OpenAI, Anthropic, LangChain, LlamaIndex, CrewAI, Bedrock, Groq, LiteLLM
- TypeScript: OpenAI, LangChain, Vercel AI SDK
- Custom code: Adds
@opik.trackdecorators orOpikclient usage
The command ensures tracing starts at your entry point (critical for replay capability) and uses the correct span types.
Skills
Opik skills (vendored from comet-ml/opik-mcp)
The plugin ships the Opik skill pack — the same skills published as opik-skills. Claude loads them by task:
| Skill | Use for |
|---|---|
opik |
SDK reference — span types, integrations, threads, the prompt library |
opik-instrument |
"add opik tracing", "instrument my code" — and verify a real trace lands |
opik-diagnose |
"what is broken in production", "which traces need attention" |
opik-explain |
"why did this trace fail", "debug this trace" |
opik-test |
"turn this trace into a test", "make sure this doesn't happen again" |
opik-compare |
"did my fix work", "which cases regressed" |
opik-evaluate |
"evaluate my agent", "build an eval", "write an LLM judge" |
opik-online-eval |
"score production traces", "take this judge live" |
opik-optimize |
"optimize this prompt", "run the prompt optimizer" |
opik-verify |
"is this safe to ship", "go/no-go on this change" |
They are vendored at a pinned opik-mcp commit (see skills/SHARED.md); edit them upstream, not here.
Agents
agent-reviewer
Reviews agent code for:
- Idempotence and retry safety
- Security vulnerabilities
- Architecture patterns
- State management
- Observability hooks
Directory Structure
opik-claude-code-plugin/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace definition
├── hooks/
│ └── hooks.json # Hook configuration
├── scripts/
│ └── opik-logger # Platform selector script
├── bin/
│ └── opik-logger-* # Compiled binaries (darwin/linux, amd64/arm64)
├── src/
│ └── *.go # Go source code
├── skills/ # Opik skill pack, vendored from comet-ml/opik-mcp (see skills/SHARED.md)
│ ├── opik/
│ ├── opik-instrument/ … opik-optimize/
├── agents/
│ └── agent-reviewer.md # Agent review agent
├── commands/
│ ├── trace-claude-code.md # /opik:trace-claude-code command
│ └── instrument.md # /opik:instrument command
└── mcp-configs/
└── mcp-servers.json # MCP server configurations
Building from Source
make build # Build for all platforms
make build-local # Build for current platform only
Opik for Claude Code
This repo is part of a set of tools for observing Claude Code and other coding agents with Opik:
- opik-claude-code-plugin: log Claude Code sessions as Opik traces, with skills and agents included (this repo)
- ccsync: export Claude Code conversation history to Opik
- cost-intelligence-proxy: meter Claude Code token spend and cost per call
- opik-skills: agent skills for instrumenting your code with Opik
Preguntas sobre Opik MCP
¿Cómo instalo el plugin de Opik para Claude Code?
Añade el marketplace e instala el plugin desde Claude Code, luego reinicia cualquier sesión que esté en ejecución.
¿Cómo realiza Opik el rastreo de las sesiones de Claude Code?
Cada turno de la conversación se convierte en una traza de Opik, y las llamadas a herramientas, pensamientos y respuestas se convierten en spans, con los subagentes anidados bajo su span de Task padre.
¿Cómo configuro la conexión con Opik?
Instala el CLI de Opik y ejecuta opik configure, lo cual escribirá tu URL de API, clave y workspace en ~/.opik.config.
¿Puedo enviar las trazas de Claude Code a un proyecto o workspace diferente?
Sí, establece OPIK_CC_PROJECT y OPIK_CC_WORKSPACE, o las claves cc_project_name y cc_workspace en ~/.opik.config.
¿Cómo añado el rastreo de Opik a mi propio código de agente?
Ejecuta /opik:instrument, que detecta frameworks como OpenAI, LangChain y CrewAI y añade la integración de Opik correspondiente.