> 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.

# Configurar o MCP

## Um endpoint, a sua identidade

O servidor é **`https://mcp.nexxo.tec.br/mcp`**, com transporte **Streamable HTTP**. Ele oferece ferramentas tipadas para consultar e operar o trabalho autorizado da sua organização.

| Campo                          | Valor                                                           |
| ------------------------------ | --------------------------------------------------------------- |
| Endpoint MCP                   | `https://mcp.nexxo.tec.br/mcp`                                  |
| Metadados do recurso           | `https://mcp.nexxo.tec.br/.well-known/oauth-protected-resource` |
| Authorization server do piloto | `https://sso.nexxo.tec.br/realms/nexxo-hub`                     |
| Fluxo                          | Authorization Code com PKCE S256                                |
| Scopes anunciados              | `openid profile email offline_access`                           |
| Audience esperada pelo MCP     | `nexxo-work-api`                                                |

## Antes de conectar

Você precisa de uma conta autorizada, organização identificada no token e permissão para os projetos que vai consultar. O piloto OAuth atual atende o realm central `nexxo-hub`; a expansão para outras organizações depende da configuração do serviço de autenticação.

O client público `nexxo-work-mcp` já está documentado para o callback do plugin ChatGPT. Outros clientes usam callbacks próprios. Peça ao administrador um client público e os callbacks corretos para seu aplicativo antes de reutilizar esse ID em outro lugar.

A descoberta OIDC anuncia um endpoint de registro de clientes. Isso não comprova que registro anônimo esteja permitido. Um client pré-cadastrado evita depender dessa permissão.

## Escolha o seu cliente

- [ChatGPT](https://developers.orbita.nexxo.tec.br/mcp/chatgpt.md): plugin do piloto e configuração OAuth fornecida.
- [Codex](https://developers.orbita.nexxo.tec.br/mcp/codex.md): CLI, client público e arquivo TOML.
- [Claude Code](https://developers.orbita.nexxo.tec.br/mcp/claude-code.md): transporte HTTP, callback e configuração JSON.

Os exemplos abaixo geram apenas instruções e arquivos. Adicionar um servidor à lista não significa que a autenticação já tenha sido concluída. Depois do login, comece pelas [ferramentas de leitura](https://developers.orbita.nexxo.tec.br/mcp/primeiras-ferramentas.md).
