Documentação

API REST e servidor MCP do QClave

Documentação em construção: as rotas de partituras entram nas próximas etapas. As regras abaixo já valem.

Autenticação

Envie sua chave no header Q-Api-Key: qm_SuaChaveAqui (ou x-api-key). A chave está no dashboard.

Permissões

Você cria, edita e apaga apenas as suas partituras. As partituras de outros clientes só podem ser lidas, e somente quando públicas. Partituras privadas nunca são entregues a outro cliente.

Cotas e custos

R$ 50,00 liberam 500 cotas. Cada requisição REST consome 1 cota e devolve até 10 partituras (R$ 0,10). Cada chamada MCP consome 2 cotas. Sem saldo, a API responde 402 e nada é debitado.

Paginação

Listagens aceitam page (padrão 1) e size (padrão e máximo 10).

MCP

Endpoint POST /mcp (streamable HTTP, sem sessão). 33 ferramenta(s) disponível(is) nesta versão.