Skip to content

docs(onboarding): distinguish HTTP and stdio setup - #155

Merged
nmartorell merged 6 commits into
feat/http-oauth-dssfrom
docs/http-client-onboarding
Sep 14, 2026
Merged

nmartorell merged 6 commits into
feat/http-oauth-dssfrom
docs/http-client-onboarding

Conversation

@pmasiphelps

@pmasiphelps pmasiphelps commented Sep 10, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • distinguish personal stdio and customer-managed Streamable HTTP onboarding
  • route the setup skill through transport-specific workflows
  • document managed MCP distribution, authentication, and end-user verification
  • replaced "DSS" with "Dataiku" everywhere :)

This PR is stacked on #125 and intentionally excludes the customer plugin bundle generator (#156 )

Validation

  • uv run pytest tests/test_http_config.py tests/test_launcher_cli.py tests/test_plugin_packaging.py
  • full repository suite and pre-commit hooks passed on the combined change before splitting

@nmartorell

nmartorell commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

hey @pmasiphelps, the changes I pushed are in line with this branch and #156 , but this branch is now intended to supersede it.

Broadly speaking, this branch does the following:

  • It keeps the plugins stdio-first, including the setup skill
  • provides a script that replaces the "mcp" server definitions in the pluign jsons, as well as the setup skill, to expect an http mcp server (the script expects the URL of the mcp server, the location for the created plugin bundle, and an optional zip flag)
  • I also cleaned up the stdio setup skill, so that now we don't bother checking uv every time the mcp server starts (assuming the tools are exposed and working)

So, a client looking to use Headless in http mode would (1) clone the repo, (2) follow the docs to setup the http mcp server, and (3) execute the script to create the plugin bundle, which can now be added to their internal maketplaces.

I tested the resulting bundle with codex, it works well!

@pmasiphelps

Copy link
Copy Markdown
Collaborator Author

@nmartorell your changes look good to me! feel free to merge into your other branch :)

@nmartorell
nmartorell merged commit fb63d3a into feat/http-oauth-dss Sep 14, 2026
@nmartorell
nmartorell deleted the docs/http-client-onboarding branch September 14, 2026 14:26
pmasiphelps added a commit that referenced this pull request Sep 15, 2026
* feat(mcp): add HTTP JWT delegation

* fix(mcp): load HTTP settings from file

* fix(mcp): clarify HTTP token exchange policy

* refactor(mcp): unify server launch modes

* refactor(config): separate transport configuration

* fix(mcp): recover from stale HTTP defaults

* refactor(mcp): name stdio entrypoint

* refactor(mcp): relocate shared auth infrastructure

* refactor(mcp): simplify runtime configuration

* refactor(config): unify Dataiku settings directory

* refactor(mcp): remove tool registration import cycle

* fix(mcp): isolate stdio initialization

* refactor(mcp): move dotenv loading to launcher

* refactor(mcp): classify local tools with tags

* refactor(config): require pinned instances for tools

* refactor(auth): name pinned instance resolver

* refactor(auth): clarify request token context

* refactor(config): simplify instance pinning

* refactor(server): simplify tool tag lookup

* refactor(auth): reuse request mode

* refactor(request): centralize instance selection guidance

* refactor(cobuild): inline turn callbacks

* refactor(config): unify settings path startup

* refactor(config): share JSON file operations

* refactor(config): model HTTP settings

* refactor(config): rename user defaults to selections

* refactor(request): remove redundant identity assertion

* feat: support enterprise HTTP OAuth flows

* fix(auth): log token exchange failures safely

* feat: simplify HTTP authentication configuration

* refactor(config): model stdio settings

* fix(config): harden local credential handling

* refactor(config): cache settings at startup

* docs(http): add deployment guide

* fix(setup): select stdio transport when warming runtime

* docs(http): clarify Entra access token versions

* fix(mcp): isolate HTTP file operations

* docs(onboarding): distinguish HTTP and stdio setup (#155)

* docs(onboarding): distinguish HTTP and stdio setup

* feat(plugins): render HTTP plugin variant

* fix(plugins): restore stdio setup skill

* fix(setup): check MCP before uv

* chore(gitignore): added http assets to gitignore

* docs(skills): skip uv check when testing stdio

---------

Co-authored-by: Ned Martorell <32619850+nmartorell@users.noreply.github.com>

* fix(ci): satisfy repository checks

* docs(onboarding): clarify HTTP client setup

* docs(http): keep plugin distribution guidance generic

* fix(http): validate request identity claims

---------

Co-authored-by: Patrick Phrayme (Masi-Phelps) <pmasiphelps@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants