Developers
Get access

stensul-get-auth-url

Starts the OAuth authorization-code flow and returns the sign-in URL the user opens in a browser.

write: changes contentScope none

Hosts that support remote OAuth connectors (Claude, ChatGPT, Writer, Copilot Studio) run this flow themselves. The server tells the model to show the full URL to the user, never a summary of it.

Inputs

  • callback_urlstringoptional

    OAuth redirect URI override. Leave unset: the server builds the callback from its own base URL and your instance at runtime. Only for one-off local testing.

Errors people hit

What you seeFix
sign-in Redirect URI mismatch
The redirect URI on the API connection is missing your instance name or doesn't match exactly.
Set it to exactly https://mcp.stensul.com/<your-instance>/oauth/callback (Writer also needs its own callback).

All errors: Errors and troubleshooting.

{}
Response

An authorization URL for your Stensul instance. After the user signs in and approves, the token is saved for the session.

Described from the tool's definition. Captured responses from a Stensul-internal tenant will replace this.

Example values use invented brands and ids. Tool list captured 2026-09-28.

Esc