Connections

Authorize MCP OAuth

Start an OAuth-based connection with a remote MCP server using Dynamic Client Registration. Returns an authorization URL the user must open in a browser; once they grant consent, Duvo creates the matching connection and redirects the browser to the optional returnUrl.

post/v2/teams/{teamId}/connections/oauth/mcp/start

Request

Base URL
https://api.duvo.ai
Auth
HTTP bearer
TypeScript
https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/teams/:teamId/connections/oauth/mcp/start/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

teamIdstring required

Request body

mcp_server_urlstring uri required

URL of the MCP server requiring OAuth.

namestring required

Human-readable name to display for the connection.

custom_integration_idstring uuid

Optional ID of a custom integration this connection should be associated with.

return_urlstring

Where to send the user's browser after consent completes. Accepts an absolute URL on a domain Duvo allows, or a path relative to the Duvo frontend (e.g. /integrations/slack).

integration_typestring

Optional integration type label.

reconnect_instance_idstring uuid

When set, the OAuth flow will update the existing connection in place rather than creating a new one.

Response

Default Response

authorization_urlstring required

OAuth provider authorization URL to open in a browser

Changes

No recorded changes to this operation across all 1 revision of this API.