Skip to content

[OPIK-8062] [SDK] feat: one-command MCP + skill pack setup #7958

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
alexkuzmik merged 42 commits into from
Aug 28, 2026
Merged

[OPIK-8062] [SDK] feat: one-command MCP + skill pack setup #7958

Show file tree
Hide file tree
Changes from 39 commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
18c676c
[NA] [SDK] feat: headless MCP configure, install verification, codex …
alexkuzmik Aug 21, 2026
41f8f1f
docs(mcp): document --install-mcp, --host, and the new hosts
alexkuzmik Aug 21, 2026
70c6a1c
feat(skills): add `opik skills` and wire the pack into `opik configure`
alexkuzmik Aug 21, 2026
3b808fe
feat(mcp): make the install read like a wizard, and show the plan first
alexkuzmik Aug 24, 2026
c0996ac
feat(cli): pick assistants from a list, and ask which ones for skills
alexkuzmik Aug 24, 2026
73b786b
docs(mcp): show the assistant picker and per-agent skills selection
alexkuzmik Aug 24, 2026
b76bc59
fix(mcp): report the outcome per host, not how we wrote it
alexkuzmik Aug 24, 2026
60a2b81
feat(skills): add `opik skills update`, and record hosts for re-linking
alexkuzmik Aug 24, 2026
c82b5cb
feat(mcp): set up the server and the skill pack in one command
alexkuzmik Aug 24, 2026
d3aca11
feat(cli): give `opik configure` the same assistant setup, and stop t…
alexkuzmik Aug 24, 2026
5a0f95a
feat(cli): register the server, then offer the skill pack as recommended
alexkuzmik Aug 24, 2026
8bacb18
fix(cli): stop relisting the assistants in the skill-pack question
alexkuzmik Aug 24, 2026
b9a93a9
fix(cli): separate representation from configuration logic, and stop …
alexkuzmik Aug 24, 2026
aeae2f3
fix(cli): honour --install-mcp without a terminal (PR review)
alexkuzmik Aug 24, 2026
440f983
fix(cli): make Enter register the highlighted assistant, not every on…
alexkuzmik Aug 24, 2026
e99cd7d
docs(mcp): lead with the benefit, cut the reference sprawl
alexkuzmik Aug 24, 2026
c78fd80
test(sdk): make the unit suite pass from a clean checkout
alexkuzmik Aug 24, 2026
336733f
refactor(cli): localize the assistant step, untangle the CLI imports
alexkuzmik Aug 24, 2026
c0c4e64
fix(sdk): green up CI — mypy annotation, formatting, click 8.4 prompt
alexkuzmik Aug 24, 2026
1a8c01e
feat(cli)!: MCP and skill-pack setup only run in an interactive session
alexkuzmik Aug 24, 2026
17eb5a0
refactor(cli)!: rename --host to --ai-client, and say "AI client" thr…
alexkuzmik Aug 24, 2026
f9179e3
fix(sdk): address live review findings — vacuous test, 5xx verify, ES…
alexkuzmik Aug 24, 2026
0292f1c
fix(cli): harden the escape-key window, and keep it off Windows' path
alexkuzmik Aug 24, 2026
996d617
refactor(cli)!: drop `opik skills`, install the pack only in the conf…
alexkuzmik Aug 25, 2026
a71d31f
docs(mcp): stop teaching a flag without its values, and fold npx into…
alexkuzmik Aug 25, 2026
8836a3e
fix(cli): stop reading arrow keys as cancellation
alexkuzmik Aug 25, 2026
060f64d
feat(cli): let a coding agent run the configure flow
alexkuzmik Aug 25, 2026
ee33738
fix(cli): make the agent-facing path discoverable, not just possible
alexkuzmik Aug 25, 2026
bf43be3
feat(cli): assume the defaults when there is no terminal
alexkuzmik Aug 25, 2026
f089afe
fix(cli): tell a person too when `-y` skipped their editor
alexkuzmik Aug 25, 2026
5f3ce34
Merge remote-tracking branch 'origin/main' into alexkuzmik/NA-mcp-con…
alexkuzmik Aug 25, 2026
79410b4
fix(cli): match the Comet host, not a substring of the URL
alexkuzmik Aug 25, 2026
303769c
Merge remote-tracking branch 'origin/main' into alexkuzmik/NA-mcp-con…
alexkuzmik Aug 25, 2026
17bc248
feat(cli): report what the configuration flow was asked for and what …
alexkuzmik Aug 25, 2026
edc3b20
fix(cli): keep configuration event property types stable across the pair
alexkuzmik Aug 25, 2026
37f763b
refactor(cli): decide the assistant setup steps in one place
alexkuzmik Aug 26, 2026
ccfc0b2
fix(cli): stop the assistant installers damaging what they touch on f…
alexkuzmik Aug 26, 2026
249f866
chore(cli): drop the analytics markers the installers cannot act on
alexkuzmik Aug 26, 2026
9d58be2
fix(cli): follow a symlinked client config instead of replacing the link
alexkuzmik Aug 26, 2026
f0de289
feat(cli): name the MCP in the suggested prompt and flag the sign-in …
alexkuzmik Aug 27, 2026
db9dd15
fix(cli): close the install with the sign-in hint, and highlight the …
alexkuzmik Aug 27, 2026
a3e9bd6
Merge branch 'main' into alexkuzmik/NA-mcp-configure-onboarding
alexkuzmik Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions apps/opik-documentation/documentation/fern/docs-v2/home.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Opik is an [open-source](https://github.com/comet-ml/opik) platform that helps y
## How to use Opik

<Tip>
**Using Claude Code, Cursor, or VS Code Copilot?** Install the [Opik MCP server](/mcp-server) and drive your entire workspace from chat — read traces, score outputs, save prompts, and run experiments without opening the UI.
**Using Claude Code, Cursor, VS Code Copilot, Codex, or opencode?** Install the [Opik MCP server](/mcp-server) and drive your entire workspace from chat — read traces, score outputs, save prompts, and run experiments without opening the UI.
</Tip>

<Steps>
Expand Down Expand Up @@ -60,7 +60,7 @@ Opik is an [open-source](https://github.com/comet-ml/opik) platform that helps y
Get Opik running with your existing AI stack in minutes. Works with OpenAI, Anthropic, LangChain, and 50+ other providers and frameworks.
</Card>
<Card title="MCP Server" href="/mcp-server" icon="fa-solid fa-network-wired" iconPosition="left">
Connect Claude Code, Cursor, or VS Code Copilot directly to your Opik workspace. Read traces, score outputs, and run experiments from chat — no UI required.
Connect Claude Code, Cursor, VS Code Copilot, Codex, or opencode directly to your Opik workspace. Read traces, score outputs, and run experiments from chat — no UI required.
</Card>
<Card title="Log traces" href="/tracing/advanced/log_traces" icon="fa-solid fa-eye" iconPosition="left">
Record every LLM call, tool invocation, and agent step. Debug failures, track token costs, and understand what your application is doing.
Expand Down
4 changes: 2 additions & 2 deletions apps/opik-documentation/documentation/fern/docs-v2/integrations/overview.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ Opik helps you easily log, visualize, and evaluate everything from raw LLM calls
Connect your AI coding assistant directly to your Opik workspace with the MCP server. Read traces, score outputs, save prompts, and run experiments from chat — works with Claude Code, Cursor, and VS Code Copilot.

<CardGroup cols={1}>
<Card title="MCP Server — Claude Code, Cursor, VS Code Copilot" href="/mcp-server" icon="fa-regular fa-network-wired">
Install `uvx opik-mcp` in under 2 minutes and drive your entire Opik workspace from your AI assistant's chat.
<Card title="MCP Server — Claude Code, Cursor, VS Code Copilot, Codex, opencode" href="/mcp-server" icon="fa-regular fa-network-wired">
Run `opik mcp configure` and drive your entire Opik workspace from your AI assistant's chat.
</Card>
</CardGroup>

Expand Down
Loading
Loading