Configuração do serviço

VariávelFinalidade
WORK_API_BASE_URLOrigem da API privada usada pelo servidor MCP.
MCP_RESOURCE_URLURL pública do recurso MCP, terminando em /mcp.
MCP_AUTHORIZATION_SERVER_URLIssuer do provedor OAuth do ambiente.
MCP_JWT_AUDIENCEAudience exigida; padrão nexxo-work-api.
MCP_OAUTH_SCOPESScopes anunciados pelo recurso.
MCP_REQUIRE_AUTHAutenticação obrigatória; padrão true.
MCP_CONFIRMATION_SECRETSegredo do servidor para assinar confirmações; pelo menos 32 caracteres.
STORAGE_API_BASE_URLOrigem 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.