Integração · Ferramentas para programadores

Conecte Claude e ChatGPT ao Cloudinary

Peça à sua IA para encontrar uma imagem, marcar um lote de ativos ou verificar quanto do seu plano você já usou, e ela funcionará na sua biblioteca de mídia do Cloudinary. Ela pode pesquisar e listar imagens, vídeos e arquivos brutos, fazer upload a partir de uma URL, renomear e mover ativos, e editar tags, contexto e metadados estruturados. Excluir um ativo pode exigir sua aprovação primeiro.

Ligar Cloudinary gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Encontre todas as imagens marcadas como verão na pasta de marketing.”
A IA executa uma expressão de pesquisa do Cloudinary e lista as imagens correspondentes com ID público, formato e tamanho.
“Faça upload da imagem nesta URL para nossa biblioteca de mídia.”
Ela faz upload do arquivo a partir da URL pública. O Cloudinary detecta o tipo de arquivo, e você recebe o novo ID público e URL do ativo.
“Adicione a tag spring-2026 a essas 40 imagens de produto.”
Ela adiciona a tag a todos os ativos em uma única chamada. Uma chamada pode cobrir até 1.000 ativos.

O que a sua IA pode fazer

Pesquisar e navegar

Pesquise ativos e pastas com expressões de pesquisa do Cloudinary, liste imagens, vídeos e arquivos brutos, e leia qualquer URL, tamanho, formato, tags e metadados de um ativo.

Upload e organização

Faça upload de arquivos a partir de uma URL ou URI de dados, renomeie ativos e pastas, mova ativos entre pastas e restaure ativos excluídos quando os backups estão ativados.

Tags e metadados

Adicione, remova ou substitua tags em até 1.000 ativos de uma vez, e defina campos de contexto e metadados estruturados em um ativo.

“Quão perto estamos dos limites de armazenamento e largura de banda?”
Ela lê o uso atual da conta e os limites do plano para armazenamento, largura de banda, transformações e créditos.
“Renomeie hero-v2 para homepage-hero.”
Ela altera o ID público do ativo. Se outro ativo já tiver esse nome, ele será substituído apenas quando você permitir.
“O que está na pasta de campanhas?”
Ela lista as subpastas e os ativos dentro da pasta, página por página.

110 ferramentas para Cloudinary

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

attach_inviteElimina dadosAnexar um convite (ID de pasta). Ação destrutiva; pode exigir aprovação. Resumo da API: Atribuir papéis de pasta.
create_asset_relations_by_public_idAltera dadosAtualizar um ativo relacionado existente identificado pelo ID público. Resumo da API: Criar relações de ativos por ID público.
create_concatAltera dadosCriar uma nova concat. Obrigatório: urls. Resumo da API: Concatenar segmentos de vídeo ordenados em um único ativo MP4.
create_contactElimina dadosCriar um novo contato. Obrigatório: inspeções. Ação destrutiva; pode exigir aprovação. Resumo da API: Inspecionar as ações permitidas do chamador sobre pessoas.
create_document_contextAltera dadosCriar um novo contexto para um documento. Obrigatório: IDs públicos ou comando. Resumo da API: Adicionar ou limpar metadados contextuais em múltiplos ativos.
create_document_evalAltera dadosCriar uma nova avaliação para um documento. Obrigatório: eval. Resumo da API: Avaliar uma expressão de parâmetro de upload dinâmica.
create_document_explicitAltera dadosCriar uma nova explícita para um documento. Obrigatório: ID público. Resumo da API: Aplicar operações em um ativo existente.
create_document_explodeAltera dadosCriar uma nova explode para um documento. Obrigatório: ID público ou transformação. Resumo da API: Criar imagens derivadas de arquivo multi-página.
create_document_generate_archiveAltera dadosCriar uma nova geração de archive para um documento. Resumo da API: Cria um archive (arquivo ZIP ou TGZ) que contém um conjunto de ativos do seu ambiente de produto.
create_document_metadataAltera dadosCriar metadados novos para um documento. Obrigatório: IDs públicos ou metadados. Resumo da API: Definir valores de metadados estruturados em múltiplos ativos.
create_document_metadata_fieldAltera dadosCriar um novo campo de metadados para um documento. Obrigatório: tipo ou label. Resumo da API: Cria um novo campo de metadados estruturado na sua conta.
create_document_metadata_ruleAltera dadosCriar uma nova regra de metadados para um documento. Obrigatório: id do campo, nome, condição ou resultado. Resumo da API: Cria uma nova regra condicional de metadados.
create_document_streaming_profileAltera dadosCriar um novo perfil de streaming para um documento. Obrigatório: nome ou representações. Resumo da API: Cria um novo perfil de streaming adaptativo na sua conta Cloudinary.
create_document_textAltera dadosCriar um novo texto para um documento. Obrigatório: texto. Resumo da API: Gerar imagem a partir do texto.
create_document_triggerAltera dadosCriar um novo gatilho para um documento. Obrigatório: uri ou tipo de evento. Resumo da API: Cria um novo gatilho de notificação (webhook) especificando um tipo de evento e um destino.
create_generate_image_to_imageAltera dadosCriar uma nova imagem a imagem para gerar. Obrigatório: prompt ou imagens de referência. Resumo da API: Gerar uma imagem a partir de imagens de referência.
create_generate_text_to_imageAltera dadosCriar uma nova texto a imagem para gerar. Obrigatório: prompt. Resumo da API: Gerar uma imagem.
create_initial_backupAltera dadosCriar um novo backup inicial. Resumo da API: Criar backup inicial.
create_orderAltera dadosCriar um novo pedido. Obrigatório: ordenação por. Resumo da API: Ordenar os valores de fonte de dados de um campo de metadados.
create_trigger_testAltera dadosCriar um novo teste para um gatilho. Resumo da API: Testar o filtro de um gatilho existente contra dados de amostra.
create_updateAltera dadosCriar uma nova atualização. Obrigatório: public id, tipo de recurso ou espécie. Resumo da API: Atualizar os detalhes de um único ativo por parâmetros do corpo.
create_visual_searchAltera dadosCriar uma nova busca visual. Obrigatório: corpo. Resumo da API: Encontrar imagens na sua biblioteca de ativos com base em semelhança visual ou conteúdo.
delete_assetElimina dadosApague permanentemente um único recurso por meio de `resource_type` e `public_id`. Não pode ser desfeito, a menos que as cópias de segurança estejam ativadas.
delete_asset_relations_by_public_idElimina dadosExcluir permanentemente um ativo relacionado pelo public id. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir relações de ativos por ID público.
delete_backupElimina dadosExcluir permanentemente um backup pelo id do ativo. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir versões de backup.
delete_destroysElimina dadosExcluir permanentemente uma destruição pelo nome da nuvem. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir ativo por ID de ativo.
delete_documentElimina dadosExcluir permanentemente um documento pelo nome. Ação destrutiva; pode exigir aprovação. Resumo da API: Excluir um preset de upload da conta.
delete_document_derived_resourcesMovimenta dinheiroExcluir permanentemente um recurso derivado pelo nome da nuvem. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Excluir recursos derivados.
delete_document_folderElimina dadosApague permanentemente uma pasta. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga uma pasta existente da sua biblioteca multimídia.
delete_document_metadata_fieldElimina dadosApague permanentemente um campo de metadados por ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga a definição de um campo de metadados estruturais da sua conta.
delete_document_metadata_ruleElimina dadosApague permanentemente uma regra de metadados por ID externo. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga uma regra condicional de metadados pelo seu ID.
delete_document_resourceElimina dadosApague permanentemente um recurso por tipo. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga recursos por ID público.
delete_document_streaming_profileElimina dadosApague permanentemente um perfil de streaming por nome. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga um perfil de streaming personalizado ou restaura o perfil nativo às configurações originais.
delete_document_transformationElimina dadosApague permanentemente uma transformação por transformação. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga uma transformação nomeada da sua conta.
delete_document_triggerElimina dadosApague permanentemente um gatilho por ID de gatilho. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga um gatilho de notificação.
delete_invalidate_by_urlsMovimenta dinheiroApague permanentemente uma invalidação por URL por nome de nuvem. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Invalida recursos derivados por URLs de entrega.
delete_metadata_field_datasourcesMovimenta dinheiroApague permanentemente um fonte de dados por ID externo. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Remove um ou mais valores permitidos da fonte de dados de um campo de metadados.
delete_related_assetElimina dadosApague permanentemente um recurso relacionado por ID de recurso. Ação destrutiva; pode exigir aprovação. Resumo da API: Apaga relações de recursos pelo ID do recurso.
download_assetBaixe o documento para um recurso. Resumo da API: Baixa um recurso pelo seu ID de recurso.
download_documentBaixe o documento para um documento. Resumo da API: Gera um link de download para um recurso específico (imagem).
download_document_backupBaixe o documento para um documento. Resumo da API: Baixa uma cópia de backup de um recurso.
get_assetObter os detalhes de um único ativo por `resource_type` (imagem, vídeo, arquivo bruto), `type` (geralmente upload) e `public_id`: URL, tamanho, formato, tags, contexto e metadados.
get_asset_by_idObter os detalhes de um único ativo pelo seu `asset_id` imutável em vez de seu public_id.
get_by_container_idObtenha um por ID de container por ID de container. Os resultados são paginados. Resumo da API: Lista os recursos em uma pasta pelo ID de container.
get_documentObtenha um documento para um documento por nome. Resumo da API: Recupera detalhes de um único preset de upload.
get_document_contactObtenha um contato para um documento por ID de contato. Resumo da API: Obter detalhes pessoais.
get_document_metadata_fieldObter um campo de metadados para um documento pelo ID externo. Resumo da API: Recupera a definição de um campo específico de metadados estruturais pelo seu identificador (externalid).
get_document_streaming_profileObter um perfil de streaming para um documento pelo nome. Resumo da API: Recupera os detalhes de um único perfil de streaming adaptativo pelo seu nome.
get_document_transformationObter uma transformação para um documento por transformação. Resumo da API: Recupera os detalhes de uma transformação específica.
get_generate_taskObter uma tarefa para gerar por ID de tarefa. Resumo da API: Obter uma tarefa de geração.
get_initial_backupObter um backup inicial pelo ID de backup inicial. Resumo da API: Obter backup inicial.
get_inviteObter um convite pelo ID de pasta. Resumo da API: Obter papéis de pasta.
get_resourceAltera dadosObter um recurso pelo nome da nuvem. Resumo da API: Obter os detalhes de um único ativo por parâmetros do corpo.
get_resource_moderationObter uma moderação para um recurso pelo status de moderação. Os resultados são paginados. Resumo da API: Obter recursos por tipo e status de moderação.
get_usageObter o uso atual e limites do plano (armazenamento, largura de banda, transformações, créditos) da conta, opcionalmente para um `date` específico.
list_by_asset_idsListar por IDs de ativo. Filtros opcionais: IDs de ativos ou tipo de recurso. Resumo da API: Obter recursos por IDs de ativos.
list_by_external_idsListar por IDs externos. Filtros opcionais: IDs externos, tipo de recurso, tags, contexto, metadados ou moderações. Resumo da API: Obter recursos por IDs externos.
list_document_contactsListar contatos para um documento. Filtros opcionais: próximo cursor, status do nome, prefixo do nome, status, ordenação ou direção. Os resultados são paginados. Resumo da API: Listar pessoas reconhecidas.
list_document_metadata_rulesListar regras de metadados para um documento. Resumo da API: Recupera uma lista de todas as regras condicionais de metadados definidas na sua conta.
list_document_resourcesListar recursos para um documento. Resumo da API: Obter tipos de recurso.
list_document_streaming_profilesListar perfis de streaming para um documento. Resumo da API: Listar todos os perfis de streaming adaptativos (pré-definidos e personalizados) definidos na sua conta Cloudinary.
list_document_transformationsListar transformações de um documento. Filtros opcionais: nome ou cursor seguinte. Resultados paginados. Resumo da API: Lista todas as definições de transformação na sua conta, incluindo transformações nomeadas.
list_document_triggersListar gatilhos para um documento. Filtro opcional: tipo de evento. Resumo da API: Lista todos os gatilhos de notificação webhook configurados no ambiente do seu produto.
list_folder_assetsListar os ativos dentro de uma pasta pelo `asset_folder` caminho, opcionalmente limitado a um resource_type. Paginar com next_cursor.
list_imagesListar imagens carregadas, filtradas opcionalmente por `prefix` (public_id/início de pasta), `tags` ou `type`. Paginar com next_cursor.
list_initial_backupsListar cópias iniciais. Filtros opcionais: cursor seguinte. Resultados paginados.
list_metadata_fieldsListar os campos de metadados estruturais definidos para a biblioteca de mídia, com seus IDs externos e valores permitidos. Use antes de definir metadados em ativos.
list_raw_filesListar ficheiros não-mídia carregados (PDFs, documentos e outros ficheiros brutos), filtrados opcionalmente por `prefix` ou `tags`.
list_resource_contextsListar contextos para um recurso. Filtros opcionais: valor, cursor seguinte ou direção. Resultados paginados. Resumo da API: Obter recursos por contexto.
list_root_foldersListar as pastas de nível superior na biblioteca de mídia.
list_subfoldersLista as subpastas de um `folder` caminho.
list_tagsListar todas as tags usadas em ativos de uma `resource_type`, opcionalmente filtradas por `prefix`.
list_videosListar vídeos carregados, filtrados opcionalmente por `prefix`, `tags` ou `type`. Paginar com next_cursor.
list_viewsListar visualizações. Filtros opcionais: expressão, ordenação por ou cursor seguinte. Resultados paginados. Resumo da API: Obter visualizações de vídeo.
rename_assetAltera dadosRenomear um ativo alterando seu public_id de `from_public_id` para `to_public_id` em um `resource_type`. Defina overwrite para substituir um ativo existente pelo nome alvo.
rename_folderAltera dadosRenomear ou mover uma pasta: passe o caminho atual `folder` e o novo caminho `to_folder`.
restore_assetsAltera dadosRestaurar ativos anteriormente excluídos (quando as cópias estão ativadas) pelo seu `asset_ids`, opcionalmente para versões específicas.
restore_datasource_restoreAltera dadosRestaurar uma cópia de um datasource (ID externo). Resumo da API: Restaurar valores de datasource.
search_assetsAltera dadosPesquisar imagens, vídeos e ficheiros com uma pesquisa Cloudinary `expression` (ex: tags=summer AND resource_type:image), com ordenação opcional, with_field e max_results. Use isto para encontrar o public_id de um ativo.
search_datasource_values_in_a_metadata_fieldAltera dadosPesquisar datasources por termo ou correspondência exata. Use isto para encontrar datasources existentes antes de criar um novo datasource. Resumo da API: Pesquisar valores de datasource num campo de metadados.
search_datasourcesAltera dadosPesquisar datasources. Use isto para encontrar datasources existentes antes de criar um novo datasource. Resumo da API: Pesquisar em todos os campos de metadados de datasource.
search_foldersPesquisar pastas com um `expression`, como name:product* ou path:marketing/*.
search_folders_searchAltera dadosPesquisar pastas. Use isto para encontrar pastas existentes antes de criar uma nova pasta. Resumo da API: Pesquisar pastas no ambiente do seu produto.
tag_assetsAltera dadosAdicionar, remover ou substituir tags em até 1000 ativos: definir `command` (adicionar, remover, substituir, remover_todos), `tags` e o `public_ids` de um `resource_type`.
update_assetAltera dadosAtualizar um ativo identificado por `resource_type`, `type` e `public_id`: tags, contexto, metadados estruturados, display_name ou asset_folder (o move). Apenas os campos que você passa são alterados.
update_by_idsVisível para outras pessoasAtualizar um existente identificado por ID cloud name. Tem efeitos visíveis fora deste sistema. Resumo da API: Obter uma pasta pelo seu identificador.
update_by_pathsVisível para outras pessoasAtualizar um existente identificado por path cloud name. Tem efeitos visíveis fora deste sistema. Resumo da API: Obter uma pasta pelo seu caminho.
update_descendantsVisível para outras pessoasAtualizar um descendente existente identificado pelo nome da nuvem. Os efeitos são visíveis fora deste sistema. Resumo da API: Obter os descendentes de uma pasta.
update_documentAltera dadosAtualizar um documento existente identificado pelo nome. Resumo da API: Atualiza as configurações de um preset de upload existente.
update_document_contactAltera dadosAtualizar um contato existente identificado pelo ID do contato. Resumo da API: Atualizar uma pessoa.
update_document_metadata_fieldAltera dadosAtualizar um campo de metadados existente identificado pelo ID externo. Resumo da API: Atualiza a configuração de um campo de metadados existente.
update_document_metadata_ruleAltera dadosAtualizar uma regra de metadados existente identificada pelo ID externo. Resumo da API: Atualiza a definição de uma regra condicional de metadados existente.
update_document_streaming_profileAltera dadosAtualizar um perfil de streaming existente identificado pelo nome. Resumo da API: Modifica a configuração de um perfil de streaming adaptativo existente.
update_document_transformationAltera dadosAtualizar uma transformação existente identificada por transformação. Resumo da API: Atualiza a definição de uma transformação existente.
update_document_triggerAltera dadosAtualizar um gatilho existente identificado pelo ID do gatilho. Resumo da API: Atualiza o URL de callback de um gatilho webhook existente em sua conta Cloudinary.
update_documentsVisível para outras pessoasAtualizar um documento existente identificado pelo nome da nuvem. Os efeitos são visíveis fora deste sistema. Resumo da API: Substitui todos os mapeamentos de upload.
update_metadata_field_datasourcesVisível para outras pessoasAtualizar uma fonte de dados existente identificada pelo ID externo. Os efeitos são visíveis fora deste sistema. Resumo da API: Atualiza os valores permitidos (a fonte) para um campo de metadados especificado.
update_metadata_field_reordersVisível para outras pessoasAtualizar uma reordenação existente identificada pelo ID externo. Os efeitos são visíveis fora deste sistema. Resumo da API: Alterar a posição do campo de metadados.
update_ordersVisível para outras pessoasAtualizar um pedido existente identificado pelo nome da nuvem. Os efeitos são visíveis fora deste sistema. Resumo da API: Reordenar todos os campos de metadados.
update_related_assetAltera dadosAtualizar um ativo relacionado existente identificado pelo ID do ativo. Resumo da API: Adicionar ativos relacionados por ID de ativo.
update_renamesVisível para outras pessoasAtualizar um renomeio existente identificado pelo nome da nuvem. Os efeitos são visíveis fora deste sistema. Resumo da API: Renomear ou mover uma pasta.
upload_documentAltera dadosUploadar um documento (tipo de recurso). Resumo da API: Uploada ativos de mídia (imagens, vídeos, arquivos brutos) para o ambiente do produto Cloudinary.
upload_document_chunkedAltera dadosUploadar um documento (tipo de recurso). Resumo da API: Uploadar uma única parte de um arquivo grande.
upload_document_mappingsAltera dadosCarregar um documento (nome da nuvem). Os resultados são paginados. Resumo da API: Recupera uma lista de todas as regras de mapeamento de carregamento configuradas no seu ambiente do produto Cloudinary.
upload_document_mappings_create_upload_mappingAltera dadosCarregar um documento (nome da nuvem). Resumo da API: Cria um novo mapeamento de carregamento.
upload_document_mappings_delete_upload_mappingElimina dadosCarregar um documento (nome da nuvem). Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui um mapeamento de carregamento de pasta.
upload_document_mappings_uploadAltera dadosCarregar um documento (nome da nuvem). Resumo da API: Atualiza um mapeamento de carregamento existente alterando o modelo de URL remoto para uma pasta específica.
upload_document_presetsAltera dadosCarregar um documento (nome da nuvem). Os resultados são paginados. Resumo da API: Lista todos os presets de carregamento configurados na conta.
upload_document_presets_uploadAltera dadosCarregar um documento (nome da nuvem). Resumo da API: Cria um novo preset de carregamento com configurações específicas.
upload_fileAltera dadosCarregar um arquivo para a biblioteca de mídia. `file` é uma URL HTTP(S) pública ou um URI de dados Base64; o tipo de arquivo é detectado automaticamente. Opcionalmente defina `upload_preset`.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Cloudinary na lista de aplicações.
2
Cole a sua chave
Cole sua Chave de API e Segredo de API do Cloudinary, e insira seu nome da nuvem. No Console do Cloudinary, abra Configurações > Chaves de API (ou o Dashboard) e copie as três. A mesma chave e segredo funcionam para ambas as APIs Admin e Upload.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Cloudinary?

Ela pode pesquisar e listar imagens, vídeos, arquivos brutos, pastas e tags, ler detalhes do ativo e campos de metadados estruturados, e verificar seu uso e limites do plano. Ela pode fazer upload de arquivos, renomear ativos e pastas, atualizar tags, contexto, metadados e localização da pasta, restaurar ativos excluídos e excluir permanentemente um ativo.

A IA vê minhas credenciais do Cloudinary?

Não. Suas credenciais do Cloudinary estão criptografadas em repouso e nunca são mostradas à IA. Após salvar, elas não aparecem novamente, nem mesmo para você. A IA só vê os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, podendo começar apenas com busca e consultas. Excluir um ativo é permanente (a menos que backups estejam habilitados) e renomear com sobrescrita substitui um ativo existente; essas ações podem exigir sua aprovação antes de rodarem. Cada chamada de ferramenta é registrada.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações e Conectores › Avançado, ative o Modo Desenvolvedor e adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem cartão de crédito necessário. Planos pagos cobram por tarefa concluída. Você também precisa de sua própria conta do Cloudinary.

Como a IA faz o upload de arquivos?

A ferramenta de upload aceita uma URL HTTP(S) pública ou um URI de dados Base64. O Cloudinary baixa o arquivo e detecta automaticamente o tipo de arquivo. Você também pode nomear um preset de upload, para que as configurações do seu preset no Cloudinary se apliquem ao upload.