---
title: "Begin MCP OAuth"
method: POST
path: "/mcp/{name}/auth/begin"
---

# Begin MCP OAuth

`POST /mcp/{name}/auth/begin`

Begin an interactive OAuth flow for a remote MCP server without blocking. Returns the authorization URL for the client to open (embedded window on desktop, new tab on web/mobile); completion happens when the provider redirects back to the callback. Poll mcp.status for the result.

## Path parameters

- `name` string, required

## Query parameters

- `directory` string
- `workspace` string
- `redirectUri` string

## Response `200`

OAuth flow begun (authorization URL) or already resolved (status)

- object
  - `supports` boolean, required
  - `authorizationUrl` string — URL to open for authorization
  - `redirectUri` string — Redirect URI the provider will return to
  - `status` union — Set when the flow resolved without user interaction
    - MCPStatusConnected
      - `status` 'connected', required
    - MCPStatusDisabled
      - `status` 'disabled', required
    - MCPStatusFailed
      - `status` 'failed', required
      - `error` string, required
    - MCPStatusNeedsAuth
      - `status` 'needs_auth', required
    - MCPStatusNeedsClientRegistration
      - `status` 'needs_client_registration', required
      - `error` string, required

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.dev/isogonic/apis/codeplane.md) · [All operations](https://skmtc.dev/isogonic/apis/codeplane/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/isogonic/codeplane/revisions/e787ab2e6692/schema)