---
title: "Início do fluxo de autorização (navegador)."
method: GET
path: "/api/mcp-oauth/authorize"
tags: ["OAuth"]
---

# Início do fluxo de autorização (navegador).

`GET /api/mcp-oauth/authorize`

## Request

- Base URL: `https://api.juspronto.com.br`
- URL: `https://api.juspronto.com.br/api/mcp-oauth/authorize`
- Auth: none required

O navegador da pessoa chega aqui vindo do cliente. O servidor valida o par `client_id` e `redirect_uri` e manda a pessoa para a tela de consentimento do Juspronto (/conectar), onde ela entra com o login, confere quem pede o acesso e marca as permissões. O parâmetro `scope` enviado pelo cliente NÃO concede permissão nenhuma: quem escolhe as permissões é a pessoa, na tela. Só `openid` e `email`, se pedidos, ficam registrados na conexão, e apenas habilitam o endereço userinfo. PKCE S256 é obrigatório. Toda resposta que volta ao cliente, de sucesso ou de erro, leva `iss` (RFC 9207). Cliente ou endereço de retorno não registrados nunca redirecionam: respondem 400 com uma página de erro.

## Query parameters

- `client_id` string, required
- `redirect_uri` string, uri, required
- `response_type` 'code', required
- `code_challenge` string, required
- `code_challenge_method` 'S256', required
- `state` string
- `scope` string
- `resource` string, uri

## Other responses

- `302`: Redireciona para a tela de consentimento (https://juspronto.com.br/conectar) ou, em erro de protocolo (`response_type` diferente de `code`, PKCE ausente, `resource` não aceito), para o `redirect_uri` com `?error=`. Nos dois casos o retorno ao cliente leva `iss`.
- `400`: Parâmetros ausentes, cliente ou endereço de retorno não registrados. Página HTML de erro.
- `429`: Limite de requisições atingido. A espera em segundos vem em `Retry-After`; o teto e a janela vêm em `RateLimit-Policy`. Aguarde antes de repetir: não é falha do servidor.

---

[API](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau.md) · [All operations](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/llms.txt) · [OpenAPI document](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/revisions/b2c70e4e0734?raw)