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

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/teams/{teamId}/connections/oauth/mcp/start`
- 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)

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.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)