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

# Operação do servidor MCP

## Configuração do serviço

| Variável                       | Finalidade                                                               |
| ------------------------------ | ------------------------------------------------------------------------ |
| `WORK_API_BASE_URL`            | Origem da API privada usada pelo servidor MCP.                           |
| `MCP_RESOURCE_URL`             | URL pública do recurso MCP, terminando em `/mcp`.                        |
| `MCP_AUTHORIZATION_SERVER_URL` | Issuer do provedor OAuth do ambiente.                                    |
| `MCP_JWT_AUDIENCE`             | Audience exigida; padrão `nexxo-work-api`.                               |
| `MCP_OAUTH_SCOPES`             | Scopes anunciados pelo recurso.                                          |
| `MCP_REQUIRE_AUTH`             | Autenticação obrigatória; padrão `true`.                                 |
| `MCP_CONFIRMATION_SECRET`      | Segredo do servidor para assinar confirmações; pelo menos 32 caracteres. |
| `STORAGE_API_BASE_URL`         | Origem de Storage usada por operações de anexos.                         |

`WORK_ACCESS_TOKEN` e `WORK_ORGANIZATION_ID` existem para configuração estática de desenvolvimento. No fluxo autenticado, o token de usuário recebido tem precedência. O servidor valida assinatura, issuer, expiração, audience e organizações autorizadas antes de encaminhar a chamada.

## Piloto e expansão

O piloto existente usa o realm central `nexxo-hub`. Organizações que usam outros realms dependem de uma autoridade estável e do roteamento de identidade definidos pela plataforma. Publicar este guia não altera essas permissões nem habilita automaticamente novos tenants.

O script de bootstrap no repositório MCP provisiona um client somente quando executado explicitamente com o realm e callback escolhidos pelo operador. A documentação não o executa durante um build.

## Faça a atualização no repositório correto

A documentação mantém conteúdo e exemplos. Clients OAuth e seus callbacks pertencem à administração do provedor; as ferramentas e a validação pertencem ao servidor MCP; autorização de dados permanece no backend do Órbita.
