---
title: "Mcp Oauth Start"
method: POST
path: "/api/workspace-integrations/{integration_id}/mcp-oauth/start"
tags: ["workspace-integrations", "workspace-integrations"]
---

# Mcp Oauth Start

`POST /api/workspace-integrations/{integration_id}/mcp-oauth/start`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/workspace-integrations/{integration_id}/mcp-oauth/start`
- Auth: none declared

Start OAuth for a dynamic-registration MCP integration (RFC 7591).

No DialogBrain-owned app: probe the MCP server's 401 challenge → discover
its OAuth metadata (mcp_oauth.handle_401) → register an OAuth client on the
fly (oauth_client.register_dynamic_client) → persist it on the integration →
return an authorize_url (+ double-submit oauth_flow cookie). The
/oauth/callback handler exchanges the code and persists the token at
`oauth_<integration_id>` (the ref mcp_client.refresh_if_expired reads).

## Path parameters

- `integration_id` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)