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

# Primeiras ferramentas

## Comece pelas leituras

Depois do login, use estas ferramentas:

| Ferramenta             | Finalidade                                                         |
| ---------------------- | ------------------------------------------------------------------ |
| `work_capabilities`    | Consultar o catálogo de operações oferecido pela versão conectada. |
| `resolve_work_context` | Resolver organizações, workspaces e projetos visíveis.             |
| `list_projects`        | Listar projetos autorizados.                                       |
| `search_issues`        | Pesquisar issues com os filtros anunciados no schema.              |
| `get_issue`            | Consultar uma issue no contexto exigido pelo schema.               |

Exemplos de pedidos ao assistente:

> Mostre meu contexto no Órbita e os projetos aos quais tenho acesso.

> Liste as issues abertas deste projeto, sem alterar nada.

> Leia esta issue e resuma seus comentários e atividade.

## Dispatcher fechado

`work_execute` recebe o nome de uma operação do catálogo, `input`, `mode` e, quando necessário, `confirmationToken`. Não é um cliente HTTP genérico: não aceita URL, método HTTP ou SQL arbitrários.

Uma leitura simples, quando sua sessão já resolve uma organização, pode usar:

```json
{
  "operation": "list_projects",
  "input": {},
  "mode": "execute"
}
```

Quando houver mais de uma organização, selecione o contexto explicitamente usando os identificadores retornados pelo servidor. Consulte o schema anunciado para os argumentos da operação em vez de reutilizar o formato de outra ferramenta ou da API pública.

## Escritas e limites

Ferramentas como `create_issue`, `update_issue`, `change_issue_status` e `add_issue_comment` respeitam o usuário autenticado. Operações marcadas como sensíveis exigem o fluxo de [prévia e confirmação](https://developers.orbita.nexxo.tec.br/mcp/confirmacoes.md).

A presença de um campo `idempotencyKey` em um consumidor não comprova idempotência em todos os endpoints do backend. Confira o contrato específico antes de repetir uma escrita cuja resposta se perdeu.
