Opere o Origami a partir dos seus sistemas
Um mesmo espaço de trabalho, três formas de entrar: uma API JSON, uma descrição OpenAPI dessa API, e um servidor MCP que entrega a um agente as mesmas ferramentas com a mesma tenência e os mesmos limites.
API do espaço de trabalho v1
Todos os endpoints ficam sob /api/v1, falam JSON e respondem um erro como {error, reason, detail} com uma razão estável para máquinas. Cada requisição leva uma chave de API do espaço como Bearer token, e é a chave que nomeia o espaço: a tenência nunca é um parâmetro da requisição, então uma chave só alcança a própria biblioteca.
Como obter uma chave
Owners e admins emitem chaves em Configurações → Chaves de API, onde o valor aparece uma única vez. De um console, `php artisan api:token` emite uma para um usuário.
Referência completa de endpointsPermissões
Uma chave carrega apenas as permissões com que foi emitida, e cada rota verifica uma:
library:read- Ler o espaço, suas publicações, versões de arquivo, execuções e relatórios.
library:write- Enviar arquivos, registrar publicações e reenviar uma cópia ao leitor.
tools:run- Listar o catálogo de ferramentas e iniciar execuções.
Primeiros passos
Uma única requisição prova que a chave funciona e diz o que ela pode rodar: o catálogo de ferramentas, como a API o expõe.
Listar as ferramentas que esta chave pode rodar
curl https://origami.publica.la/api/v1/tools \
-H "Authorization: Bearer ${ORIGAMI_API_KEY}" \
-H "Accept: application/json"A resposta lista cada ferramenta com o slug, se ela é medida e o que aceita. Dali em diante, o ciclo enviar → rodar → ler → baixar está documentado na página da API.
Descrição OpenAPI
O plano do espaço de trabalho está descrito em um documento OpenAPI. Aponte para ele um gerador de clientes, um cliente HTTP ou um agente e ele tem toda a superfície — rotas, parâmetros, esquemas e o formato do erro — sem ler esta página.
Servidor MCP
O Origami fala Model Context Protocol sobre Streamable HTTP, então um agente pode percorrer um espaço de trabalho e rodar ferramentas do mesmo jeito que um cliente HTTP. Cada ferramenta MCP reutiliza o serviço por trás do endpoint que espelha — mesma tenência, mesmas permissões, mesmos limites — então os dois planos não têm como se separar.
Endpoint
POST https://origami.publica.la/mcp
Duas formas de autenticar
- Uma chave de API do espaço como Bearer token, exatamente como a API HTTP a recebe. É a opção para um agente que roda no seu servidor.
- OAuth, para clientes que se registram sozinhos: registro dinâmico de cliente com PKCE e escopo mcp:use. O token age como a pessoa usuária no espaço de trabalho atual dela.
Conectar pelo Claude Code
claude mcp add --transport http origami https://origami.publica.la/mcp \
--header "Authorization: Bearer ${ORIGAMI_API_KEY}"Descoberta
Um cliente OAuth encontra tudo o que precisa nos documentos de metadados do recurso protegido e do servidor de autorização:
Se você é um agente
Dois arquivos de texto simples descrevem este site sem percorrê-lo: um diz o que é o Origami, quanto custa e quais páginas importam; o outro diz como autenticar.
Está conectando alguma coisa?
Ingestão em massa, um gancho com o seu DAM, um pipeline de preflight: conte o que você está automatizando e ajudamos a conectar.