> For AI agents: the complete documentation index is available at https://developers.orbita.nexxo.tec.br/llms.txt, the full documentation bundle is available at https://developers.orbita.nexxo.tec.br/llms-full.txt.

# Diagnosticar a conexão MCP

## Confira os endpoints públicos

```bash
curl https://mcp.nexxo.tec.br/
curl https://mcp.nexxo.tec.br/.well-known/oauth-protected-resource
```

O health retorna o estado do processo. Os metadados anunciam o recurso e os servidores de autorização. `authConfigured: false` no health indica ausência de credenciais estáticas globais, não que o OAuth de usuário esteja desligado.

Uma chamada ao endpoint MCP sem bearer retorna `401` e `WWW-Authenticate` com o endereço dos metadados. Esse é o comportamento esperado de autenticação.

## Interprete o problema

| Sintoma                           | O que conferir                                                                              |
| --------------------------------- | ------------------------------------------------------------------------------------------- |
| Callback ou redirect URI inválido | Client público e callback exato do aplicativo.                                              |
| Client inválido                   | Cadastro no realm correto; não reutilize um client cujo callback pertence a outro programa. |
| Falha de registro dinâmico        | O endpoint anunciado pode exigir autorização administrativa; use um client pré-cadastrado.  |
| `401` ou `invalid_token`          | Assinatura, expiração, issuer e audience do access token.                                   |
| `403` ao consultar dados          | Organização autorizada e vínculos de workspace/projeto.                                     |
| `503`                             | Disponibilidade do backend ou configuração OAuth/JWKS, conforme o erro e a correlação.      |
| Conectado, mas sem projetos       | Identidade, organização ativa e participação real nos projetos.                             |

## Teste uma camada por vez

Conferir o health não comprova login, e concluir o login não comprova acesso a todos os projetos. Valide, em sequência, transporte, autenticação, contexto e uma leitura autorizada.

Os testes deste portal conferiram health, metadados e a rejeição de chamadas anônimas. Eles não realizaram login em uma conta nem criaram ou alteraram dados na produção.
