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

# MCP e ferramentas de IA

## Endpoint e estado atual

O servidor MCP existente usa `https://mcp.nexxo.tec.br/mcp`. Ele oferece operações tipadas do Órbita e encaminha a identidade autenticada à API; não aceita uma URL ou payload HTTP arbitrário como ferramenta genérica.

O OAuth está documentado no repositório como **piloto interno**. A expansão para organizações em realms diferentes depende de uma autoridade estável que resolva o realm da pessoa. Não trate o piloto como uma integração pública já habilitada para todos os clientes.

## Autenticação

O piloto usa Authorization Code com PKCE S256 e o cliente público `nexxo-work-mcp`. Não há client secret para colocar no ChatGPT. O JWT precisa conter o usuário, a organização autorizada e a audience `nexxo-work-api`.

A API do Órbita continua aplicando suas permissões. Uma API key de organização não substitui a identidade de usuário desse fluxo.

## Ferramentas

O catálogo inclui `resolve_work_context`, `list_projects`, `search_issues`, `get_issue`, ferramentas de comentários e alteração de issues, além de `work_capabilities` e do dispatcher fechado `work_execute`.

Consulte as capacidades anunciadas pela versão conectada antes de escolher uma operação. Algumas ações administrativas ou destrutivas exigem preview e confirmação assinada pelo servidor MCP.

## O que ainda depende de contratos

Iniciativas, customer requests e sessões assíncronas de agente não são capacidades públicas prometidas por este guia. O servidor só pode oferecer o que o backend e a configuração OAuth efetivamente suportam.

## Configuração por cliente

Use o [guia de configuração](https://developers.orbita.nexxo.tec.br/mcp/configuracao.md) para conectar ChatGPT, Codex ou Claude Code, com o client OAuth e o callback correspondentes.
