v1

latestOpenAPI 3.0.32026-07-222111928.0 KB

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

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