---
title: "Authenticate MCP OAuth"
method: POST
path: "/mcp/{name}/auth/authenticate"
---

# Authenticate MCP OAuth

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

Start OAuth flow and wait for callback (opens browser)

## Path parameters

- `name` string, required

## Query parameters

- `directory` string
- `workspace` string

## Response `200`

OAuth authentication completed

- union
  - 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.net/kaaass/apis/opencode.md) · [All operations](https://skmtc.net/kaaass/apis/opencode/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kaaass/opencode/versions/8bb9a15bd144/schema)