Ligue o MOVA a assistentes de IA e automações

1. Crie uma chave de acesso

1. No app MOVA, abra Configurações › Integrações › Criar chave de acesso.
2. Dê um nome, escolha as permissões e a validade (30, 90 ou 365 dias).
3. Copie a chave: ela aparece uma vez só. O MOVA guarda só uma impressão dela.
4. Revogue quando quiser na mesma tela. Trocar a senha revoga todas as chaves e conexões.

2. Use a API

Mande a chave no cabeçalho Authorization. Dinheiro é um número inteiro na menor unidade da moeda, como texto, mais o código da moeda ("30000" USD = 300,00). Para criar, use PUT com um id que você gera (UUID).

Cada chave só alcança as rotas das permissões dela; o resto responde 403. Nada pode ser apagado por uma chave: para desmarcar um atendimento, mude a situação para cancelado.

curl -s "https://api.movapro.app/appointments?from=2026-11-01&to=2026-11-30" \
  -H "Authorization: Bearer mova_pat_..." 

curl -s -X PUT "https://api.movapro.app/appointments/$(uuidgen | tr A-Z a-z)" \
  -H "Authorization: Bearer mova_pat_..." \
  -H "Content-Type: application/json" \
  -d '{"clientId":"<client id>","startsLocal":"2026-11-10T14:00",
       "timezone":"America/New_York","durationMinutes":60,
       "currency":"USD","priceMinor":"30000"}'

3. Claude

1. Claude (web e desktop): Configurações › Conectores › Adicionar conector personalizado, e cole https://api.movapro.app/mcp.
2. O Claude abre a página do MOVA: entre com o e-mail e a senha do MOVA e escolha as permissões.
3. Claude Code: adicione o conector com uma chave de acesso, como abaixo (ou use /mcp para entrar).

claude mcp add --transport http mova https://api.movapro.app/mcp \
  --header "Authorization: Bearer mova_pat_..." 

4. ChatGPT

1. No ChatGPT, abra Configurações › Apps e conectores (modo desenvolvedor) e crie um conector com o endereço https://api.movapro.app/mcp.
2. Escolha a entrada por OAuth. O ChatGPT abre a página do MOVA: entre e escolha as permissões.
3. O ChatGPT não aceita chave fixa: ele sempre usa essa entrada.

5. Meta Muse e outros assistentes

1. Adicione um conector personalizado (servidor MCP) com o endereço https://api.movapro.app/mcp.
2. Se ele pedir uma chave de API ou um cabeçalho, use Authorization: Bearer com uma chave de acesso do MOVA. Se oferecer entrar (OAuth), use a entrada.
3. Gemini, Microsoft Copilot e Grok funcionam do mesmo jeito onde aceitam conectores MCP remotos.

6. Zapier e Make

1. Zapier: adicione a ação Webhooks by Zapier › Custom Request (planos pagos do Zapier).
2. Método e endereço da rota (por exemplo PUT https://api.movapro.app/expenses/<id novo>), Data em JSON.
3. Headers: Authorization = Bearer mova_pat_... e Content-Type = application/json.
4. Make: use o módulo HTTP com o mesmo método, endereço e cabeçalhos.

7. Relatos da comunidade

Consultar número é opcional e começa desligado. Usa as mesmas regras e limites da aba Consultar do app, e os comentários públicos dos relatos encontrados vão para o serviço de IA que você conectou.

Relatos: por padrão, a IA só deixa um rascunho que você confirma no app. Se você escolher "Publicar direto", aceita ser responsável pelo que for publicado, e cada relato publicado pela IA aparece na Atividade com Desfazer. A IA nunca anexa foto.

8. Limites e segurança

Cada chave ou conexão pode fazer até 60 pedidos por minuto e 1.000 por hora (429 com Retry-After quando passa).

Nenhuma chave alcança sua conta, senha, e-mail, relatos de outras pessoas, dados de secretária além das permissões dela ou o painel. Toda mudança feita por uma conexão fica registrada com o nome dela.

Permissões

Referência completa (OpenAPI 3.1): /developers/openapi.json