feat(cli): name the MCP in the suggested prompt and flag the sign-in step

Two things a user cannot infer from the current closing block.

The suggested prompt was "list my Opik projects", which an agent can answer
without ever touching the MCP — the SDK is right there and the repo documents
it. Naming the server makes the first thing they try actually exercise what
was just installed.

The hosted server also needs a sign-in that we never mention. How it is
triggered is the host's choice: some open the browser on first use, others
leave the server unauthorized until asked. An unauthorized server contributes
no tools at all rather than an error, so a user who was not told to look never
finds out why it went quiet.

The tip goes through the existing note() hook rather than a done() parameter:
done() is also called from cli.assistants with announce_next_steps=False, and
that path has no access to the transport without changing what
setup_mcp_server returns. Gated on RemoteServerSpec — the stdio server takes
its credentials at startup and has nothing to sign in to.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: alexkuzmik

sdks/python/src/opik/cli/install_view.py

@@ -136,7 +136,7 @@ def done(self, components: List[str], assistants: List[str]) -> None:
             text.Text.assemble(
                 ("Restart ", ""),
                 ("them" if len(assistants) > 1 else "it", "bold"),
-                (', then ask "list my Opik projects"', ""),
+                (', then ask "list my Opik projects via Opik MCP"', ""),
             ),
         )
         console.print(padding.Padding(grid, _FIELDS_INDENT, expand=False))

sdks/python/src/opik/configurator/mcp/install.py

@@ -194,6 +194,18 @@ def setup_mcp_server(
                 check_tls_certificate=check_tls_certificate,
             )
         display.verification(verification.succeeded, verification.detail)
+        # Only the hosted server has a sign-in step, and how it is triggered is
+        # the host's choice, not ours: some open the browser on first use, others
+        # leave the server sitting unauthorized until the user asks. An
+        # unauthorized server contributes no tools at all rather than an error,
+        # so a user who is not told to look never finds out why it went quiet.
+        if isinstance(server_spec, mcp_spec.RemoteServerSpec):
+            display.note(
+                "Signing in: depending on your assistant, you will either be "
+                "prompted with a sign-in link the first time it uses Opik, or "
+                "need to authorize the opik-mcp server yourself from its MCP "
+                "settings."
+            )
         if verification.succeeded and announce_next_steps:
             display.done(
                 ["MCP server"],

sdks/python/src/opik/configurator/mcp/view.py

@@ -148,7 +148,7 @@ def verification(self, succeeded: bool, detail: str) -> None:
     def done(self, components: List[str], assistants: List[str]) -> None:
         LOGGER.info(
             "Done. %s set up for %s. Restart %s, then ask it to 'list my Opik "
-            "projects'.",
+            "projects via Opik MCP'.",
             " and ".join(components) or "Nothing",
             ", ".join(assistants) or "your AI client",
             "them" if len(assistants) > 1 else "it",

sdks/python/tests/unit/configurator/mcp/test_install.py

@@ -426,6 +426,37 @@ def test_setup_mcp_server__hosted_detected__does_not_prefetch(
     install_spy.assert_called_once()
 
 
+def test_setup_mcp_server__hosted_detected__mentions_signing_in(monkeypatch):
+    monkeypatch.setattr(
+        install.mcp_detection,
+        "detect_hosted_mcp_server",
+        lambda **kwargs: "https://dev.comet.com/opik/api/v1/mcp",
+    )
+    install_spy = mock.Mock(return_value=targets.InstallResult("Cursor", True, "Added"))
+    monkeypatch.setattr(targets, "HOST_TARGETS", [_target("cursor", True, install_spy)])
+    monkeypatch.setattr("builtins.input", lambda message: "y")
+    args = _make_args()
+
+    install.setup_mcp_server(**args)
+
+    said = args["view"].said
+    assert "sign-in link" in said
+    assert "authorize the opik-mcp server yourself" in said
+
+
+def test_setup_mcp_server__local_server__says_nothing_about_signing_in(monkeypatch):
+    """The stdio server takes its credentials at startup — there is nothing to sign in to."""
+    monkeypatch.setattr(install.shutil, "which", lambda name: "/usr/bin/uvx")
+    install_spy = mock.Mock(return_value=targets.InstallResult("Cursor", True, "Added"))
+    monkeypatch.setattr(targets, "HOST_TARGETS", [_target("cursor", True, install_spy)])
+    monkeypatch.setattr("builtins.input", lambda message: "y")
+    args = _make_args()
+
+    install.setup_mcp_server(**args)
+
+    assert "sign-in link" not in args["view"].said
+
+
 def test_setup_mcp_server__force_local__skips_probe_and_installs_uvx(monkeypatch):
     monkeypatch.setattr(install.shutil, "which", lambda name: "/usr/bin/uvx")
     detect_spy = mock.Mock(return_value="https://dev.comet.com/opik/api/v1/mcp")