---
title: "Start OAuth consent for a bound remote MCP server"
method: POST
path: "/mcp/projects/{projectId}/servers/{serverName}/oauth/start"
tags: ["mcp"]
---

# Start OAuth consent for a bound remote MCP server

`POST /mcp/projects/{projectId}/servers/{serverName}/oauth/start`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/mcp/projects/{projectId}/servers/{serverName}/oauth/start`
- Auth: none declared

## Path parameters

- `projectId` string, required
- `serverName` string, required

## Request body

- StartMcpOAuthRequest
  - `scope` string
  - `returnTo` string

## Response `200`

Consent URL

- StartMcpOAuthResponse
  - `authorizeUrl` string, required
  - `expiresAt` integer, required

## Other responses

- `400`: Invalid
- `403`: Role insufficient
- `404`: Not found
- `502`: The MCP server's OAuth step failed
- `503`: Not configured

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)