Skip to content

docs(jupyter): add /proxy/3001 to BinderHub MCP endpoint path #121

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
kratsg merged 1 commit into from
Jul 2, 2026
Merged

docs(jupyter): add /proxy/3001 to BinderHub MCP endpoint path #121

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 3 additions & 3 deletions docs/uchicago/jupyter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -448,7 +448,7 @@ you launched:

| Surface | Endpoint | Token | Token lifetime | Endpoint lifetime |
| --------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `https://jupyterhub.af.uchicago.edu` (BinderHub-launched) | `/user/<name>/mcp` | JupyterHub API token, scope **`access:servers`** (or the tighter `access:servers!user=<name>`) | Durable — mint once at `/hub/token`, reuse across spawns | Only while your server is running; if culled, the endpoint 404s until you spawn again, then the **same** token reconnects |
| `https://jupyterhub.af.uchicago.edu` (BinderHub-launched) | `/user/<name>/proxy/3001/mcp` | JupyterHub API token, scope **`access:servers`** (or the tighter `access:servers!user=<name>`) | Durable — mint once at `/hub/token`, reuse across spawns | Only while your server is running; if culled, the endpoint 404s until you spawn again, then the **same** token reconnects |
| `https://af.uchicago.edu/jupyterlab` (af-portal-launched) | `<notebook_id>.<af-domain>/mcp` | The `?token=…` from your notebook URL — this is the singleuser server's `IdentityProvider` token | Generated per pod; **gone forever** when the pod is reaped | Same as token lifetime |

Both designs are intentional: the credential is scoped to your identity, the
Expand All @@ -471,7 +471,7 @@ For Claude Code:

```bash
claude mcp add jupyter --transport http \
https://jupyterhub.af.uchicago.edu/user/<your-username>/mcp \
https://jupyterhub.af.uchicago.edu/user/<your-username>/proxy/3001/mcp \
--header "Authorization: Bearer <your-api-token>"
```

Expand All @@ -486,7 +486,7 @@ For Claude app, Cursor, Continue, or any client configured via
"args": [
"-y",
"mcp-remote",
"https://jupyterhub.af.uchicago.edu/user/<your-username>/mcp",
"https://jupyterhub.af.uchicago.edu/user/<your-username>/proxy/3001/mcp",
"--header",
"Authorization:${JUPYTERHUB_AUTH_HEADER}"
],
Expand Down