---
title: "Troca o código de autorização por token, ou renova o token."
method: POST
path: "/api/mcp-oauth/token"
tags: ["OAuth"]
---

# Troca o código de autorização por token, ou renova o token.

`POST /api/mcp-oauth/token`

## Request

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

Dois usos. `grant_type=authorization_code`: troca o código (de uso único, 10 minutos) por um par de tokens, com `code`, `redirect_uri`, `client_id` e `code_verifier` (PKCE S256). `grant_type=refresh_token`: renova com `refresh_token`. O token de acesso é opaco e dura 1 hora; o refresh dura 30 dias e é rotativo: reaproveitar um refresh já usado revoga os tokens da conexão e responde 401. O corpo é `application/x-www-form-urlencoded`, como manda o OAuth. Cliente público, sem segredo.

## Response `200`

Par de tokens.

- TokenResposta
  - `access_token` string, required: Token de acesso opaco, para o cabeçalho Authorization: Bearer.
  - `refresh_token` string, required: Token de renovação, rotativo.
  - `token_type` 'Bearer', required
  - `expires_in` integer, required: Segundos de validade do token de acesso (1 hora).
  - `scope` string, required: Escopos que a conexão realmente recebeu, separados por espaço, com `openid` e `email` quando foram pedidos.

## Other responses

- `400`: Pedido inválido: `invalid_request` (campo ausente), `unsupported_grant_type`, ou `invalid_grant` (código usado, expirado, de outro cliente, PKCE que não confere, ou refresh vencido).
- `401`: Refresh token já usado: tratado como roubo. Os tokens da conexão foram revogados e é preciso refazer a autorização.
- `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)