Comet Opik

resmi

Opik günlüklerinizi, izlemelerinizi, istemlerinizi ve LLM'lerinizden gelen diğer tüm telemetri verilerinizi doğal dilde sorgulayın ve analiz edin.

GitHub

217

Comet Opik MCP ile neler yapabilirsiniz?

Opik çalışma alanınızda gezinin ve arayın — list ile isteğe bağlı ad filtreleri ve sayfalama kullanarak projeleri, deneyleri, izleri, yayılmaları, promptları veya test paketlerini listeleyin.
Herhangi bir varlığı kimliğe, ada veya URI'ye göre inceleyin — read ile opik:// URI'leri veya UUID'ler kullanarak tam ayrıntıları (izler ve promptlar için satır içi alt öğeler dahil) alın.
İzleri, puanları, yorumları ve prompt sürümlerini kaydedin — write ile izler ve yayılmalar oluşturun veya güncelleyin, geri bildirim puanları ekleyin, prompt sürümlerini kaydedin ve test paketlerini yönetin.
LLM gözlemlenebilirlik verileriniz hakkında Ollie'ye araştırma soruları sorun — deneyleri karşılaştırmak, gerilemeleri teşhis etmek veya isteğe bağlı akış ortası puanlamayla varlıklar arası içgörüleri sentezlemek için ask_ollie sorgulayın.
Değerlendirme deneylerini uçtan uca çalıştırın — tam bir değerlendirme çalıştırmasını yürütmek ve kaydetmek için bir prompt, test paketi ve puanlayıcılarla run_experiment tetikleyin.
Yazma işlemi şemalarını inceleyin — bir yük oluşturmadan önce herhangi bir yazma işlemi için tam JSON şeklini ve gerekli alanları almak üzere schema kullanın.

Dokümantasyon

Opik MCP Sunucusu

Opik için resmi Model Context Protocol (MCP) sunucusu — Comet tarafından geliştirilen açık kaynak LLM gözlemlenebilirlik ve değerlendirme platformu Opik. AI ana bilgisayarınızı (Claude Code, Cursor, VS Code Copilot, MCP Inspector) doğrudan Opik çalışma alanınıza bağlayın: izlemeleri okuyun, puanları kaydedin, prompt sürümlerini saklayın ve Opik'in ürün içi AI asistanı Ollie'ye araştırma soruları sorun — hepsi sohbetten.

Opik'i zaten çalıştıran ve onu birlikte kod yazdıkları AI asistanından yönetmek isteyen LLM mühendisleri için geliştirilmiştir.

Eski npx opik-mcp sürümünden mi geçiyorsunuz? TypeScript sunucusu kullanımdan kaldırıldı ve 2026-11-15 tarihinde kullanımdan kaldırılacak. MCP istemci yapılandırmanızda npx -y opik-mcp yerine uvx opik-mcp@latest kullanın. Tam rehber: legacy/typescript/MIGRATION.md.

You:    "Why did the experiment 'gpt-4o-rerank-v3' regress on factuality?"
Claude: → ask_ollie → reads experiment + traces → "Three traces failed because…"

You:    "Score trace 7f2e… 0.9 on helpfulness with reason 'great recovery'."
Claude: → write(score.create) → done

Kurulum

opik-mcp bir Python paketidir (Python 3.13+ gerektirir). Çalıştırmanın önerilen yolu uvx kullanmaktır; bu, en son yayınlanan sürümü istek üzerine getirir ve çalıştırır — küresel kurulum veya sanal ortam yönetimi gerekmez.

uv öğesini bir kez kurun:

curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS / Linux
# or: brew install uv

Opik çalışma alanınızdan iki şeye ihtiyacınız olacak:

OPIK_API_KEY — comet.com/api/my/settings/ adresinden alın.
OPIK_WORKSPACE — çalışma alanı adınız (küçük harf, URL'de göründüğü gibi). Örn. https://www.comet.com/acme-ai/... → OPIK_WORKSPACE=acme-ai. İsteğe bağlı — varsayılan olarak default (Opik SDK kuralı) kullanılır; bu, yerel/OSS kurulumları için doğrudur; adlandırılmış çalışma alanı olan bulut kullanıcıları bunu ayarlamalıdır. COMET_WORKSPACE kullanımdan kaldırılmış bir takma ad olarak kabul edilir.

Ön sürüm notu: opik-mcp (Python) henüz PyPI'de yayınlanmadı. İlk PyPI sürümü yayınlanana kadar, aşağıdaki herhangi bir parçadaki uvx opik-mcp yerine şunu kullanın: uvx --from git+https://github.com/comet-ml/opik-mcp.git opik-mcp

OPIK_WORKSPACE isteğe bağlıdır. Aşağıdaki herhangi bir parçadaki OPIK_WORKSPACE satırını/anahtarını atlayın; sunucu default çalışma alanını kullanır (yerel/OSS kurulumları için doğru). Yalnızca adlandırılmış bir bulut çalışma alanına bağlanıyorsanız ayarlayın.

Claude Code

Sunucuyu tek komutla ekleyin:

claude mcp add --transport stdio opik-mcp \
  --env OPIK_API_KEY=<your-key> \
  --env OPIK_WORKSPACE=<your-workspace> \
  -- uvx opik-mcp

Veya ~/.claude.json dosyasını doğrudan düzenleyin:

{
  "mcpServers": {
    "opik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["opik-mcp"],
      "env": {
        "OPIK_API_KEY": "<your-key>",
        "OPIK_WORKSPACE": "<your-workspace>"
      }
    }
  }
}

Claude Code'u yeniden başlatın. /mcp ile doğrulayın — opik-mcp bağlı olarak görünmelidir. Ardından sohbette şunu sorun: "Opik projelerimi listele" — Claude list aracını çağırır ve çalışma alanınızın projelerini görürsünüz.

Cursor

~/.cursor/mcp.json (küresel) veya .cursor/mcp.json (proje) dosyasını düzenleyin veya Cmd+Shift+J → Özellikler → Model Context Protocol bölümünü açın:

{
  "mcpServers": {
    "opik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["opik-mcp"],
      "env": {
        "OPIK_API_KEY": "<your-key>",
        "OPIK_WORKSPACE": "<your-workspace>"
      }
    }
  }
}

Cursor'u yeniden yükleyin; MCP panelinde opik-mcp yanındaki yeşil nokta bağlantıyı doğrular. Sohbette şunu sorun: "Opik projelerimi listele".

Cursor 60 saniye zaman aşımı. Cursor, ilerleme bildirimlerinde sıfırlanmayan sabit bir araç çağrısı zaman aşımı uygular. Uzun ask_ollie turları Cursor'da başarısız olur. Bilinen ana bilgisayar sınırlamaları bölümüne bakın.

VS Code Copilot

Çalışma alanınızda (veya Kullanıcı Ayarları JSON'unda) .vscode/mcp.json:

{
  "servers": {
    "opik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["opik-mcp"],
      "env": {
        "OPIK_API_KEY": "<your-key>",
        "OPIK_WORKSPACE": "<your-workspace>"
      }
    }
  }
}

Pencereyi yeniden yükleyin; Copilot Sohbet MCP göstergesi, sunucuya ulaşıldığında opik-mcp gösterir. Sohbette şunu sorun: "Opik projelerimi listele".

MCP Inspector (manuel test)

OPIK_API_KEY=<your-key> OPIK_WORKSPACE=<your-workspace> \
  npx @modelcontextprotocol/inspector uvx opik-mcp

Kendi kendine barındırılan Opik

Ana bilgisayar yapılandırmanızdaki aynı env bloğuna COMET_URL_OVERRIDE (ve Opik varsayılan olmayan bir yolda yaşıyorsa OPIK_URL) ekleyin:

{
  "mcpServers": {
    "opik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["opik-mcp"],
      "env": {
        "OPIK_API_KEY": "<your-key>",
        "COMET_URL_OVERRIDE": "https://opik.your-company.com",
        "OPIK_MCP_ANALYTICS_SOURCE": ""
      }
    }
  }
}

ask_ollie ve run_experiment yalnızca Comet Cloud'da kullanılabilir — kendi kendine barındırılan kurulumlarda bu çağrılar gönderimde başarısız olur, bu nedenle read / list / write doğrudan kullanın. OPIK_MCP_ANALYTICS_SOURCE="" ayarlamak, kurulumunuzu telemetri olaylarındaki bulut-Comet kaynak etiketinden çıkarır.

Araçlar

opik-mcp küçük, sonuç odaklı bir yüzey sunar — tam yaşam döngüsünü kapsayan altı araç (oku → not ekle → seç → yaz → yinele).

Araç	Amaç
`read`	Kimlik / ad / `opik://` URI ile evrensel okuma
`list`	İsteğe bağlı ad filtresi + sayfalama ile evrensel listeleme
`ask_ollie`	Opik ürün içi asistanı aracılığıyla araştırma / sentez
`write`	Evrensel yazma — izleme/aralık kaydetme, puanlama, yorum, prompt kaydetme, test paketleri ve deneyleri yönetme
`schema`	Yazma işlemi şemalarını inceleme (LLM tarafından geçerli yükler oluşturmak için kullanılır)
`run_experiment`	Ollie aracılığıyla uçtan uca değerlendirme deneyi çalıştırma

`read`

"Bana X'i göster" soruları için tek araç. Bir entity_type artı bir id (UUID veya adlandırılabilir türler için bir ad) veya tam bir opik:// URI alır. Bileşik okumalar (trace, prompt) alt öğelerini satır içine alır, böylece tek bir çağrı tam resmi döndürür.

Desteklenen varlıklar: project, trace, span, test_suite, experiment, prompt. Ada dayalı arama project, experiment, prompt, test_suite için kullanılabilir (daha yavaş — iki API çağrısı — ve birden çok eşleşme döndürebilir).

read(entity_type="trace", id="7f2e3c8a-…")
read(entity_type="project", id="demo")          # name lookup
read(entity_type="trace", id="opik://traces/7f2e3c8a-…")

`list`

İsteğe bağlı ad filtresi ve sayfalama ile bir koleksiyona göz atın. Proje kapsamlı türler (trace, test_suite_item, prompt_version) üst UUID gerektirir.

list(entity_type="experiment", page=1, size=25)
list(entity_type="experiment", name="rerank")          # name substring filter
list(entity_type="trace", project_id="<project-uuid>") # traces of one project

`ask_ollie`

Araştırma soruları, varlıklar arası sentez veya Opik alan uzmanlığı gerektiren her şey için. Ollie'nin çalışma alanınıza doğrudan okuma erişimi vardır ve istendiğinde akış sırasında yazma işlemleri (puanlar, yorumlar, test paketi öğeleri, prompt sürümleri) gerçekleştirebilir.

ask_ollie(query="Why are spans in project 'demo' slower this week than last?")
ask_ollie(query="Compare experiments A and B on factuality. Score the bottom 5 traces of A 0.2 with reason.")

Asistanın son metnini artı bir thread_id döndürür. Bağlamı korumak için takip sorularında geri iletin — Ollie'nin iş parçacıkları arasında belleği yoktur.

YOLO modu (varsayılan). Ollie'nin akış sırasında gerçekleştirdiği yazma işlemleri, eylem başına onay olmadan yürütülür. Her otomatik onay, opik_mcp.audit Python günlükçüsünde JSON denetim satırı olarak kaydedilir. Bunun yerine onay gerektirmek için OPIK_MCP_AUTO_APPROVE=disabled ayarlayın — Ollie'nin onay istekleri daha sonra manuel olarak yeniden gönderebileceğiniz yazılı hatalar olarak görünür.

Yalnızca Comet Cloud'da kullanılabilir.

`write`

Evrensel yazma dağıtıcısı. operation + data iletin; dağıtıcı yükü doğrular, doğru REST fiilini uygular ve arka uç yanıtını döndürür.

İşlemler:

İşlem	Ne yapar
`trace.create`	Tek bir izleme kaydedin (veya bir toplu iş). Aralıklar / puanlar / yorumlar için üst öğe.
`trace.update`	Mevcut bir izlemeyi sonlandırın veya değiştirin.
`span.create`	Mevcut bir izlemeye bir aralık kaydedin (veya bir toplu iş).
`score.create`	Bir izlemeye, aralığa veya iş parçacığına sayısal geri bildirim puanı ekleyin.
`comment.create`	Bir izlemeye, aralığa veya iş parçacığına serbest metin yorumu ekleyin.
`prompt_version.save`	Yeni bir prompt sürümü kaydedin (yoksa prompt'u ada göre oluşturur).
`test_suite.create`	Bir değerlendirme test paketi oluşturun.
`test_suite_item.upsert`	Bir test paketine öğeleri ekleyin veya güncelleyin (her zaman zarf şeklinde).
`experiment.create`	Bir test paketine kapsamlı bir deney oluşturun.
`experiment_item.create`	Bir deneye izleme + veri kümesi öğesi satırları ekleyin.

write(operation="score.create", data={
  "target": "trace",
  "target_id": "7f2e3c8a-…",
  "name": "helpfulness",
  "value": 0.9,
  "reason": "great recovery"
})

`schema`

Çağırmadan önce herhangi bir yazma işleminin tam JSON şeklini ve gerekli alanlarını inceleyin — data'nin nasıl görünmesi gerektiğinden emin olmadığınızda kullanışlıdır. Şemayı, OAuth kapsamını ve doğrulanmış bir örneği döndürür. Saf arama, arka uç çağrısı yok.

schema(operation="score.create")
schema(operation="prompt_version.save")

`run_experiment`

Ollie aracılığıyla uçtan uca bir değerlendirme deneyi çalıştırın. Opik'in deney şeklini yansıtan tek bir experiment_config sözlüğü alır (prompt, test paketi, puanlayıcılar); Ollie çalıştırmayı yürütür ve sonuçları bir Opik deneyi olarak geri yazar.

run_experiment(experiment_config={
  "test_suite_name": "qa-eval-v2",
  "prompt_name": "welcome-msg",
  # … see `schema(operation="experiment.create")` for the full shape
})

Yalnızca Comet Cloud'da kullanılabilir.

Yapılandırma

Her ayar bir ortam değişkenidir. Gerekli olanlar kalın yazılmıştır.

Kimlik / uç nokta

Değişken	Varsayılan	Notlar
`OPIK_API_KEY`	—	`ask_ollie` ve kimliği doğrulanmış herhangi bir okuma/yazma için gereklidir.
`OPIK_WORKSPACE`	`default`	Çalışma alanı adı. İsteğe bağlı — `default` (Opik SDK kuralı) kullanılır. Adlandırılmış çalışma alanı olan bulut kullanıcıları bunu ayarlamalıdır.
`COMET_WORKSPACE`	—	`OPIK_WORKSPACE` için kullanımdan kaldırılmış takma ad (geriye dönük uyumluluk). Her ikisi de ayarlanırsa `OPIK_WORKSPACE` kazanır.
`COMET_WORKSPACE_ID`	—	İsteğe bağlı çalışma alanı UUID'si. Ayarlanırsa analiz olaylarına damgalanır, böylece BI (değişebilir) çalışma alanı adı yerine sabit bir kimliğe katılabilir.
`COMET_URL_OVERRIDE`	`https://www.comet.com`	Kendi kendine barındırılan Comet ana bilgisayarınıza ayarlayın veya hazırlık için `https://dev.comet.com` kullanın.
`OPIK_URL`	`COMET_URL_OVERRIDE` + `/opik/api`'den türetilir	Yalnızca Opik, Comet arayüzünden farklı bir ana bilgisayarda/yolda yaşıyorsa geçersiz kılın.
`OPIK_DEFAULT_PROJECT_NAME`	ayarlanmamış	Ayarlanırsa, oturum başına `instructions` blobu LLM'e, kullanıcı farklı bir proje adlandırmadıkça her araç çağrısında bunu `project_name` olarak iletmesini söyler.

Sunucu / taşıma

Değişken	Varsayılan	Notlar
`OPIK_MCP_TRANSPORT`	`stdio`	Ana bilgisayar tarafından başlatılan için `stdio`, bir bağlantı noktasını dinlemek için `streamable-http`.
`OPIK_MCP_HOST`	`127.0.0.1`	uvicorn bağlama ana bilgisayarı (yalnızca `streamable-http`).
`OPIK_MCP_PORT`	`8080`	uvicorn bağlama bağlantı noktası (yalnızca `streamable-http`).
`OPIK_MCP_RELOAD`	`false`	uvicorn `--reload` etkinleştirmek için `true` (yalnızca geliştirme).
`OPIK_MCP_AS_URL`	ayarlanmamış	OAuth Yetkilendirme Sunucusu URL'si, `/.well-known/oauth-protected-resource` (RFC 9728) içinde duyurulur ve AS keşif araştırmaları için proxy hedefi olarak kullanılır. MCP ana bilgisayarlarının HTTP üzerinden OAuth dansını başlatması için gereklidir.
`OPIK_MCP_RESOURCE_URI`	ayarlanmamış	Bu sunucunun kurallı genel URI'si, korumalı kaynak meta verilerinde `resource` olarak duyurulur ve `WWW-Authenticate` ipucunu türetmek için kullanılır.
`OPIK_MCP_LOG_LEVEL`	`INFO`	stderr günlükçü eşiği.

Taşıma seçme

opik-mcp, HTTP taşımasında yerel kimlik bilgisi doğrulaması yapmaz: iyi biçimlendirilmiş herhangi bir Authorization: Bearer … (bir Opik API anahtarı veya bir opik_mcp_at_… OAuth erişim belirteci) opik-backend'e olduğu gibi iletilir; kimlik doğrulama zorlamasının tek noktası burasıdır. Taşımayı dağıtım şekline göre seçin:

Senaryo	Taşıma
MCP istemcisi ve Opik aynı makinede (yerel OSS kurulumu)	stdio (önerilir — en basit, bağlantı noktası yok, OAuth kurulumu yok)
Yerel MCP istemcisi → uzak Opik (Comet bulutu / kendi kendine barındırılan)	`OPIK_API_KEY` ile stdio veya OAuth ile HTTP (`OPIK_MCP_AS_URL` arka uca işaret eder)
opik-backend ile aynı uçta barındırılan opik-mcp	HTTP — taşıyıcılar arka uç tarafından istek başına doğrulanır

Yerel OSS kurulumları için not: OSS arka ucu istekleri doğrulamaz, bu nedenle önündeki bir HTTP opik-mcp, OSS REST API'sinin kendisi kadar açıktır. Paylaşılan ağlarda varsayılan 127.0.0.1 bağlamayı koruyun (ve stdio'yu tercih edin).

Ollie / uzun çağrılar

Değişken	Varsayılan	Notlar
`OPIK_MCP_AUTO_APPROVE`	`enabled`	Ollie'nin akış sırasındaki yazma işlemleri devam etmeden önce eylem başına onay gerektirmek için `disabled`. MCP `elicitation` yeteneğini duyuran ana bilgisayarlarda kullanıcı evet/hayır istemi görür; daha basit ana bilgisayarlarda istek, manuel olarak yeniden gönderebileceğiniz yazılı bir hata olarak görünür.
`OPIK_MCP_ELICIT_TIMEOUT_SECONDS`	`60`	Ollie'nin akış sırasındaki onay isteminin, iptal olarak değerlendirilmeden önce kullanıcıyı ne kadar bekleyebileceği. `0` sınırı devre dışı bırakır (yalnızca hata ayıklama).
`OPIK_MCP_POD_READY_TIMEOUT_S`	`120`	Ollie pod soğuk başlatma yoklama sınırı.
`OPIK_MCP_POD_READY_INTERVAL_S`	`2`	Soğuk başlatma yoklama aralığı.
`OPIK_MCP_HEARTBEAT_INTERVAL_S`	`15.0`	Bekçi köpeği ritmi — pod sessizken bir `notifications/progress` işareti yayar, ana bilgisayar zaman aşımlarını uzak tutar.
`OPIK_MCP_STREAM_IDLE_TIMEOUT_S`	`300.0`	`ask_ollie` iptal etmeden önce pod sessizliği için üst sınır. `0` devre dışı bırakır (yalnızca hata ayıklama).

Telemetri

Anonim kullanım olayları (yalnızca olay türü ve zamanlama — sorgu içeriği yok). API anahtarınızın SHA-256 özeti, desteğin hesabınızı bulabilmesi için dahil edilir; ham anahtar asla işlemi terk etmez. Devre dışı bırak: OPIK_MCP_ANALYTICS_ENABLED=false.

Değişken	Varsayılan	Notlar
`OPIK_MCP_ANALYTICS_ENABLED`	`true`	Tüm telemetriyi devre dışı bırakmak için `false` olarak ayarlayın.
`OPIK_MCP_ANALYTICS_URL`	`https://stats.comet.com/notify/event/`	Hazırlık aşaması için geçersiz kılma.
`OPIK_MCP_ANALYTICS_ENVIRONMENT`	`prod`	Her olayda etiket (`prod` / `staging` / `dev`).
`OPIK_MCP_ANALYTICS_SOURCE`	`comet.com`	Alıcı bunu `on_prem=False` işaretlemek için kullanır. Şirket içi kurulumlar `""` veya kendi alan adlarıyla geçersiz kılmalıdır.
`OPIK_MCP_ANALYTICS_CONNECT_TIMEOUT_S`	`5.0`	HTTP bağlantı zaman aşımı.
`OPIK_MCP_ANALYTICS_TOTAL_TIMEOUT_S`	`10.0`	HTTP toplam istek zaman aşımı.

Bilinen ana bilgisayar sınırlamaları

MCP spesifikasyonu, ana bilgisayarların araç çağrısı zaman aşımını notifications/progress üzerinde sıfırlamasına izin verir — opik-mcp, her Ollie SSE olayı başına bir tane ve 15 saniyelik bekçi köpeği kalp atışı yayar. Gerçeklik eşitsizdir:

Claude Code — belgelenmiş bir araç çağrısı zaman aşımı yoktur; kalp atışı çağrıyı message_end kadar canlı tutar. Önerilir.
Cursor — ilerlemede sıfırlanmayan sabit 60s zaman aşımı (yukarı akış hatası). Uzun Ollie dönüşleri başarısız olur. ask_ollie sorgularını odaklı tutun.
MCP Inspector — MAX_TOTAL_TIMEOUT toplam süreyi sınırlar (varsayılan 60s). Uzun işlemler için Inspector arayüzünde yükseltin.

Bir çağrı takılırsa, OPIK_MCP_LOG_LEVEL=DEBUG ayarlayın — kalp atışı hataları (genellikle ana bilgisayar bağlantı kesilmeleri) opik_mcp.ask_ollie üzerinde hata ayıklama düzeyinde günlüğe kaydedilir.

Sorun giderme

OPIK_API_KEY is required to use ask_ollie — değişken sunucu işlemine ulaşmıyor. Claude Code / Cursor / VS Code'da, ortam değişkenleri yalnızca MCP sunucu yapılandırmasının env bloğunun içinde geçerlidir, kabuğunuzda değil. Düzenlemeden sonra ana bilgisayarı yeniden başlatın.

ask_ollie, 2 dakika sonra "pod not ready" döndürüyor — Ollie pod soğuk başlatması OPIK_MCP_POD_READY_TIMEOUT_S aştı. Yeniden deneyin — ikinci çağrı genellikle sıcak bir poda isabet eder.

ask_ollie / run_experiment, kendi kendine barındırılan Opik'te dağıtım hatasıyla başarısız oluyor — bu araçlar yalnızca Comet Cloud'da mevcuttur. Kendi kendine barındırılan ortamda doğrudan read / list / write kullanın.

Cursor çağrısı 60s'de zaman aşımına uğruyor — Cursor'un bilinen hatası, opik-mcp değil. Ya Ollie sorgusunu kısaltın ya da sabit sınırı olmayan Claude Code'da aynı işlemi çalıştırın.

Geliştirme

git clone git@github.com:comet-ml/opik-mcp.git
cd opik-mcp
make install        # uv sync --extra dev
make check          # lint + typecheck + test
make run-dev        # uvicorn with --reload + DEBUG logs
make inspect        # MCP Inspector against the running server

Ortak hedefler:

Hedef	Ne yapar
`make install`	`uv sync --extra dev`
`make run`	MCP sunucusunu çalıştırın (varsayılan olarak stdio).
`make run-dev`	DEBUG günlüğü + uvicorn `--reload` ile çalıştırın.
`make dev`	`mcp dev` aracılığıyla çalıştırın (Inspector dev-mode sarmalayıcısı).
`make inspect`	Çalışan bir sunucuya karşı MCP Inspector başlatın.
`make test`	`uv run pytest -q`.
`make test-live`	`dev.comet.com` karşı canlı uçtan uca (`OPIK_API_KEY` + `OPIK_WORKSPACE` ayarlayın).
`make lint`	`ruff check` + biçim kontrolü.
`make format`	`ruff format` + `ruff check --fix`.
`make typecheck`	`mypy`.
`make check`	`lint + typecheck + test`.

Depo düzeni:

opik-mcp/
├── src/opik_mcp/        ← server, tools, ask_ollie, analytics
├── tests/               ← pytest suites
├── scripts/             ← live-BE smoke + MCP-session smoke
├── legacy/typescript/   ← deprecated v2 TS server
├── pyproject.toml
└── Makefile

Yardım alın

Hatalar ve özellik istekleri için bir sorun açın
SDK / arka uç belgeleri için Opik belgeleri
Sorular için Comet topluluk Slack'i

v2'den yükseltiyor musunuz? Eski TypeScript sunucusu hâlâ npm'de opik-mcp@^2 olarak yayınlanıyor (npx -y opik-mcp); kaynak legacy/typescript/ altında korunuyor. Destek politikası için legacy/typescript/DEPRECATED.md bölümüne bakın.

Lisans

Apache-2.0.