Opik — MCP-сервер для Claude Code: что делает и как установить
Подключает AI-ассистента к рабочему пространству Opik: можно читать трейсы, эксперименты и датасеты, оценивать результаты и сохранять версии промптов.
claude mcp add --transport http opik-mcp https://www.comet.com/opik/api/v1/mcpЧто делает Opik
Opik подключает Claude Code и другие MCP-клиенты к рабочему пространству Opik. Через чат ассистент читает трейсы, эксперименты, датасеты и промпты, ставит оценки трейсам с пояснением и сохраняет версии промптов. Это удобно, когда проверка наблюдаемости и качества LLM уже ведётся в Opik.
Для Opik Cloud сервер работает по HTTP через https://www.comet.com/opik/api/v1/mcp, а вход выполняется в браузере через OAuth без API-ключа. Self-hosted и open-source Opik запускаются локально командой uvx opik-mcp через stdio; для них используются переменные OPIK_API_KEY, OPIK_WORKSPACE, OPIK_URL и COMET_URL_OVERRIDE. Для локального запуска нужен uv, поэтому без него сервер не запустится. После настройки требуется начать новую сессию клиента.
Какие задачи решает
- найти неудачные трейсы в проекте Opik
- прочитать эксперименты и датасеты из рабочего пространства
- оценить трейс с числом и причиной
- сохранить новую версию промпта
- подключить Opik Cloud или локальный сервер к MCP-клиенту
Примеры запросов агенту
- Покажи трейсы проекта
demo, которые завершились ошибкой сегодня. - Поставь трейсу
7f2e…оценку0.9за полезность и добавь причину «хорошее восстановление». - Сохрани текущую версию этого промпта в Opik и покажи доступные версии.
Как установить Opik
1Командой платформы: удалённый сервер
claude mcp add --transport http opik-mcp https://www.comet.com/opik/api/v1/mcp2Командой платформы
claude mcp add --env OPIK_API_KEY=<OPIK_API_KEY> --env OPIK_WORKSPACE=<OPIK_WORKSPACE> --env OPIK_URL=<OPIK_URL> --env COMET_URL_OVERRIDE=<COMET_URL_OVERRIDE> --transport stdio opik -- uvx opik-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from opik-mcp <команда>
1Командой платформы: удалённый сервер
codex mcp add opik --url https://www.comet.com/opik/api/v1/mcp2Командой платформы
codex mcp add opik --env OPIK_API_KEY=<OPIK_API_KEY> --env OPIK_WORKSPACE=<OPIK_WORKSPACE> --env OPIK_URL=<OPIK_URL> --env COMET_URL_OVERRIDE=<COMET_URL_OVERRIDE> -- uvx opik-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from opik-mcp <команда>
Файл настроек
{
"mcpServers": {
"opik": {
"url": "https://www.comet.com/opik/api/v1/mcp"
}
}
}{
"mcpServers": {
"opik": {
"command": "uvx",
"args": [
"opik-mcp"
],
"env": {
"OPIK_API_KEY": "<OPIK_API_KEY>",
"OPIK_WORKSPACE": "<OPIK_WORKSPACE>",
"OPIK_URL": "<OPIK_URL>",
"COMET_URL_OVERRIDE": "<COMET_URL_OVERRIDE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from opik-mcp <команда>
Файл настроек
{
"servers": {
"opik": {
"type": "http",
"url": "https://www.comet.com/opik/api/v1/mcp"
}
}
}{
"servers": {
"opik": {
"type": "stdio",
"command": "uvx",
"args": [
"opik-mcp"
],
"env": {
"OPIK_API_KEY": "<OPIK_API_KEY>",
"OPIK_WORKSPACE": "<OPIK_WORKSPACE>",
"OPIK_URL": "<OPIK_URL>",
"COMET_URL_OVERRIDE": "<COMET_URL_OVERRIDE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from opik-mcp <команда>
1Командой платформы: удалённый сервер
gemini mcp add -t http opik https://www.comet.com/opik/api/v1/mcp2Командой платформы
gemini mcp add -e OPIK_API_KEY=<OPIK_API_KEY> -e OPIK_WORKSPACE=<OPIK_WORKSPACE> -e OPIK_URL=<OPIK_URL> -e COMET_URL_OVERRIDE=<COMET_URL_OVERRIDE> opik uvx opik-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from opik-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Opik
Как установить Opik в Claude Code?
Для подключения hosted-сервера Opik Cloud выполните claude mcp add --transport http opik-mcp https://www.comet.com/opik/api/v1/mcp. Затем начните новую сессию и пройдите вход через браузер.
Что делает Opik?
MCP-сервер даёт ассистенту доступ к трейсами, экспериментам, датасетам и промптам Opik. Через чат можно читать данные, записывать оценки трейсов и сохранять версии промптов.
Чем отличаются Opik Cloud и локальный сервер Opik?
Opik Cloud подключается по HTTP и использует вход через браузер без API-ключа. Локальный или self-hosted Opik запускается через uvx opik-mcp по stdio и получает настройки из переменных окружения.
