---
title: "Authorize MCP OAuth"
method: POST
path: "/v2/teams/{teamId}/connections/oauth/mcp/start"
tags: ["Connections"]
---

# Authorize MCP OAuth

`POST /v2/teams/{teamId}/connections/oauth/mcp/start`

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`.

## Path parameters

- `teamId` string, required

## Request body

- object
  - `mcp_server_url` string, uri, required — URL of the MCP server requiring OAuth.
  - `name` string, required — Human-readable name to display for the connection.
  - `custom_integration_id` string, uuid — Optional ID of a custom integration this connection should be associated with.
  - `return_url` string — 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_type` string — Optional integration type label.
  - `reconnect_instance_id` string, uuid — When set, the OAuth flow will update the existing connection in place rather than creating a new one.

## Response `200`

Default Response

- object
  - `authorization_url` string, required — OAuth provider authorization URL to open in a browser

## Other responses

- `400` — Default Response
- `401` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)