Visão geral
Integração via MCP para clientes e agentes compatíveis, conforme os recursos, permissões e formas de autenticação disponibilizados por cada plataforma.
A disponibilidade de recursos pode variar conforme o cliente MCP, o plano contratado, as permissões configuradas e os mecanismos de autenticação oferecidos por cada plataforma.
O servidor proposto atua como uma camada controlada entre o cliente MCP e o backend confiável. Ele não oferece acesso ao banco de dados, ao registro de créditos ou a operações administrativas.
Requisitos
- • Cliente compatível com MCP remoto e autenticação segura
- • Organização e ambiente previamente cadastrados
- • Usuário responsável e escopos mínimos definidos
- • Política de consumo ou confirmação explícita
- • Backend MCP implementado, publicado e validado
- • Canal HTTPS e armazenamento seguro de credenciais
Autenticação
O desenho exige OAuth 2.1, token de acesso de curta duração ou mecanismo equivalente. Tokens ficam fora do frontend e do prompt, são criptografados em repouso, separados por organização e ambiente e podem ser revogados imediatamente.
Configuração
- 01Registrar o cliente, a organização e o ambiente no backend confiável.
- 02Concluir o fluxo de autorização em uma interface segura fora do prompt.
- 03Selecionar escopos e limites por ferramenta, usuário e organização.
- 04Definir se operações com consumo sempre pedem confirmação ou seguem política limitada.
- 05Testar leitura, revogação, isolamento e auditoria antes de liberar produção.
Escopos
Conceda somente o necessário para o fluxo aprovado:
projects:readprojects:writejobs:readjobs:createassets:readcredits:readEscopos administrativos e financeiros não são concedidos por padrão.
Ferramentas disponíveis
Neste site, todas as ferramentas estão com status prevista. A lista só deve mudar para disponível depois que servidor, autorização e auditoria forem implementados e testados.
| Ferramenta | Finalidade | Status |
|---|---|---|
list_projects | Lista projetos acessíveis à identidade autenticada. | Prevista |
get_project | Consulta um projeto dentro da organização autenticada. | Prevista |
create_video_project | Cria um rascunho de projeto; não inicia cobrança ou processamento. | Prevista |
submit_script | Anexa um roteiro tratado como conteúdo não confiável a um projeto. | Prevista |
upload_source_reference | Solicita uma URL temporária para upload validado de material de origem. | Prevista |
estimate_credits | Solicita ao backend uma estimativa sem permitir que o agente determine a tarifa. | Prevista |
confirm_credit_reservation | Confirma uma estimativa previamente calculada e autoriza a reserva no backend. | Prevista |
create_avatar_video | Inicia um vídeo com avatar usando referências e reserva previamente autorizadas. | Prevista |
create_authorized_clone_video | Inicia um vídeo com clone somente com consentimento verificável e reserva válida. | Prevista |
create_ugc_video | Inicia um vídeo estilo UGC após validação de roteiro, referências e reserva. | Prevista |
create_video_cuts | Inicia a geração de cortes a partir de uma origem validada e reserva válida. | Prevista |
create_video_job | Inicia uma operação autorizada usando uma reserva válida. | Prevista |
get_job_status | Consulta o estado seguro de um processamento. | Prevista |
list_generated_assets | Lista arquivos autorizados usando URLs assinadas e temporárias. | Prevista |
get_credit_balance | Consulta somente o saldo disponível da organização autenticada. | Prevista |
list_usage_history | Lista eventos de uso não sensíveis dentro do escopo autorizado. | Prevista |
Schemas de entrada e resposta
Os contratos usam validação estrita: campos desconhecidos são rejeitados, textos e arquivos possuem limites e toda resposta inclui apenas dados necessários e um correlation ID.
list_projects
- Entrada
{ cursor?, limit?, status? }- Resposta
{ projects[], next_cursor, correlation_id }
get_project
- Entrada
{ project_id }- Resposta
{ project, correlation_id }
create_video_project
- Entrada
{ name, kind, brief?, brand_reference? }- Resposta
{ project, next_step, correlation_id }
submit_script
- Entrada
{ project_id, script, language }- Resposta
{ script_reference, validation_status, correlation_id }
upload_source_reference
- Entrada
{ project_id, filename, content_type, size_bytes }- Resposta
{ upload_reference, temporary_upload_url, expires_at, correlation_id }
estimate_credits
- Entrada
{ project_id, operation }- Resposta
{ estimate_id, estimated_credits, expires_at, explicit_confirmation_required, correlation_id }
confirm_credit_reservation
- Entrada
{ estimate_id, confirmation: true, idempotency_key }- Resposta
{ reservation_id, reserved_credits, status, correlation_id }
create_avatar_video
- Entrada
{ project_id, reservation_id, script_reference, avatar_reference }- Resposta
{ job_id, status: queued, correlation_id }
create_authorized_clone_video
- Entrada
{ project_id, reservation_id, script_reference, clone_reference, consent_reference }- Resposta
{ job_id, status: queued, correlation_id }
create_ugc_video
- Entrada
{ project_id, reservation_id, script_reference, product_reference? }- Resposta
{ job_id, status: queued, correlation_id }
create_video_cuts
- Entrada
{ project_id, reservation_id, source_reference, maximum_cuts }- Resposta
{ job_id, status: queued, correlation_id }
create_video_job
- Entrada
{ project_id, reservation_id, operation, script_reference?, source_reference?, consent_reference? }- Resposta
{ job_id, status, correlation_id }
get_job_status
- Entrada
{ job_id }- Resposta
{ job_id, status, progress_percent, failure_code, correlation_id }
list_generated_assets
- Entrada
{ project_id }- Resposta
{ assets[], correlation_id }
get_credit_balance
- Entrada
{}- Resposta
{ available_credits, reserved_credits, updated_at, correlation_id }
list_usage_history
- Entrada
{ cursor?, limit? }- Resposta
{ events[], next_cursor, correlation_id }
Exemplos por cliente
Claude Code
Cadastre um servidor remoto somente após a disponibilização de uma URL pública segura. Conclua a autorização fora do prompt e permita apenas os escopos necessários ao projeto.
ChatGPT
Configure uma conexão compatível com MCP quando o cliente e o backend oferecerem essa modalidade. O usuário deve autorizar a conta e confirmar ações com consumo.
Gemini
Use o mecanismo de extensão ou cliente MCP efetivamente disponibilizado pelo ambiente. Documentos e campanhas só entram no fluxo após autorização explícita.
Cliente MCP genérico
Descubra as ferramentas do servidor, solicite OAuth 2.1 fora da conversa e chame primeiro uma operação de leitura. Não inclua tokens, segredos ou credenciais no prompt.
Estes são fluxos conceituais, não arquivos de configuração prontos nem evidência de integração oficial com qualquer plataforma.
Erros
| Código | Uso |
|---|---|
AUTH_REQUIRED | Autenticação ausente, inválida ou expirada. |
SCOPE_DENIED | A identidade não possui o escopo exigido. |
VALIDATION_ERROR | A entrada não atende ao schema estrito. |
CONFIRMATION_REQUIRED | A operação com consumo aguarda confirmação. |
RATE_LIMITED | O limite aplicável foi atingido. |
OPERATION_FAILED | Falha segura; consulte o correlation ID. |
Respostas nunca incluem stack trace, segredos ou URLs internas.
Rate limits
Limites devem ser aplicados simultaneamente por usuário, organização, token, ferramenta e endereço de origem. Os valores finais dependem do plano e da capacidade do backend; quando implementados, serão retornados por cabeçalhos e erros seguros.
Consumo de SuperCréditos
O agente nunca calcula preço ou altera saldo. O backend estima, exige confirmação, reserva os créditos, inicia o processamento, liquida o consumo real e libera ou estorna a reserva em falha técnica. Automação sem confirmação só poderá existir com escopo permitido, orçamento, limite, responsável e log de auditoria.
Segurança
Organização é resolvida no servidor pela identidade autenticada. Um organization_id enviado pelo agente nunca é prova de autorização.
Prompts, documentos, URLs e arquivos são conteúdo não confiável. Eles não alteram escopos nem concedem permissão; parâmetros passam por schema e allowlist, com limites de tamanho e duração. Arquivos saem somente por URLs assinadas e temporárias.
Operações proibidas
- • Alterar diretamente o registro confiável de SuperCréditos
- • Determinar preços, conceder saldo ou aprovar pagamentos
- • Acessar outra organização ou ignorar limites do plano
- • Executar ações administrativas sem autorização
- • Receber chaves secretas ou tokens como parte do prompt
A auditoria deve registrar organização, usuário, cliente MCP, ferramenta, parâmetros não sensíveis, resultado, estimativa, consumo, data, origem aplicável, correlation ID e motivo de falha.
Revogação
O usuário ou administrador autorizado deve poder revogar a conexão imediatamente. O backend invalida tokens, encerra sessões derivadas, preserva o registro de auditoria e impede novas chamadas sem reutilizar credenciais antigas.
Changelog
Contrato público inicial
Documentação conceitual, schemas estritos e controles de segurança publicados com status previsto. Nenhum endpoint operacional foi anunciado.
Conheça o produto MCP
Veja casos de uso, integrações em destaque e o modelo de aprovação para operações com consumo.