Assistentes de IA (MCP)

A Oficina tem um servidor MCP — o Claude e outros assistentes podem consultar e operar a sua conta, respeitando as permissões da chave.

• Endpoint: https://app.oficina.protoncode.com.br/mcp (Streamable HTTP)
• Autenticação: Authorization: Bearer pk_live_... — crie uma chave só com as permissões que o assistente deve ter.

Conectar

Claude Code

claude mcp add --transport http oficina https://app.oficina.protoncode.com.br/mcp \
  --header "Authorization: Bearer pk_live_xxx"

Claude Desktop / outros clientes: adicione um servidor MCP remoto com a URL acima e o header de autorização.

Ferramentas

Ferramenta	O que faz	Permissão
find_vehicle_by_plate	Acha o carro pela placa, com o dono e as OS	customers:read + service_orders:read
list_customers	Lista e busca clientes	customers:read
create_customer	Cadastra cliente	customers:write
create_vehicle	Cadastra veículo de um cliente	customers:write
list_stages	Etapas do quadro do pátio	service_orders:read
get_board	Quadro do pátio (OS abertas por etapa)	service_orders:read
get_technician_board	Em qual carro cada técnico está e os serviços dele	service_orders:read
list_service_orders	Lista OS (abertas, por etapa ou por veículo)	service_orders:read
get_service_order	OS com orçamento e serviços	service_orders:read
create_service_order	Abre OS para um veículo	service_orders:write
add_service_order_item	Adiciona serviço ou peça ao orçamento	service_orders:write
move_service_order_stage	Muda a etapa (o assistente deve confirmar antes de entregar)	service_orders:write
list_due_reminders	Clientes na hora de voltar (troca de óleo, revisão…) com a mensagem pronta; não envia nada	customers:read + service_orders:read
assign_job	Atribui ou tira o técnico de um serviço	service_orders:write

Exemplos de pedido: "o Gol ABC1D23 já está pronto?", "quem está livre agora?", "abra uma OS para a placa RIO2A19 com barulho na suspensão".

Tudo o que o assistente faz fica registrado na auditoria da conta e dispara os mesmos webhooks.