mcp-oauth
Operations of the MCP Gateway API. Paths are relative to your deployment's API host.
POST /api/mcp-gateway-api/mcp-servers/{serverId}/oauth/initiate
Initiate OAuth 2.1 PKCE flow for an MCP server
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
serverId | path | string | yes |
Request body: application/json OAuthInitiateRequestDto
| Status | Description | Body |
|---|---|---|
| 201 | application/json OAuthInitiateResponseDtoDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |
GET /api/mcp-gateway-api/oauth/callback
OAuth 2.1 auth-code callback (called by the authorization server)
Authentication: bearer token (Authorization: Bearer <token>)
| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
code | query | string | yes | Authorization code from the OAuth provider. |
state | query | string | yes | State parameter echoed back by the provider. |
| Status | Description | Body |
|---|---|---|
| 200 | application/json ObjectDataEnvelope | |
| 400 | application/problem+json ProblemDetailsDto | |
| 401 | application/problem+json ProblemDetailsDto | |
| 403 | application/problem+json ProblemDetailsDto | |
| 404 | application/problem+json ProblemDetailsDto | |
| 409 | application/problem+json ProblemDetailsDto | |
| 422 | application/problem+json ProblemDetailsDto | |
| 500 | application/problem+json ProblemDetailsDto |