Saltar para o conteúdo

Integração · Sites e conteúdos

Conecte Claude e ChatGPT ao Umbraco

Faça sua IA perguntar sobre o conteúdo do seu site Umbraco, e ela lê através da API de Entrega de Conteúdo. Ela pode buscar uma página pelo caminho URL, listar páginas em uma seção como seu blog e encontrar imagens e arquivos na biblioteca de mídia. Ela só lê conteúdo, então nada no seu site muda.

Ligar Umbraco Content Delivery API gratuitamente

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

Experimente pedir

  • “O que nossa página /sobre-nós/ diz sobre nossa história?”

    A IA busca a página pelo caminho e lê o conteúdo.

  • “Liste nossos 10 posts de blog mais recentes.”

    Ela consulta os filhos de /blog/, ordenados por data de atualização, do mais recente para o primeiro, e pega 10.

  • “Quais artigos temos sobre preços?”

    Ela consulta conteúdo publicado filtrado pelo tipo de conteúdo de artigo e pelo nome.

O que a sua IA pode fazer

Páginas por caminho ou ID

Busque uma página pelo seu caminho URL ou GUID, ou vários itens de conteúdo em uma única chamada.

Consulte a árvore de conteúdo

Liste os filhos ou descendentes de uma seção, filtre por tipo de conteúdo ou nome, ordene por data e pague resultados.

Biblioteca de mídia

Encontre imagens e arquivos por caminho ou ID, liste o conteúdo da pasta e obtenha suas URLs e metadados.

  • “Qual é a URL do nosso logotipo na biblioteca de mídia?”

    Ela procura o item de mídia pelo seu caminho, como /imagens/logotipo.png, e retorna sua URL e metadados.

  • “Verifique o rascunho da nova página de produto antes de publicá-la.”

    Com pré-visualização ativada, ela lê o rascunho não publicado do item de conteúdo pelo seu ID. Isso precisa de uma chave de API com acesso a pré-visualizações.

  • “Resuma todas as páginas sob /serviços/ para nossa equipe de vendas.”

    Ela busca todos os descendentes da seção de serviços e escreve um resumo de cada página.

8 ferramentas para Umbraco Content Delivery API

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.

  • get_content_by_idObtenha um item de conteúdo publicado (página, artigo, etc.) pelo seu GUID, passado como product_id. Defina preview para true para ler o rascunho não publicado.
  • get_content_by_pathObtenha um item de conteúdo publicado pelo seu caminho de URL, por exemplo /about-us/. Use isso quando você conhece o endereço da página.
  • get_content_itemsObtenha vários itens de conteúdo de uma vez passando seus GUIDs em id.
  • get_media_by_idObtenha um item de mídia (imagem, arquivo) pelo seu GUID, passado como product_id, incluindo sua URL e metadados.
  • get_media_by_pathObtenha um item de mídia pelo caminho da biblioteca de mídia, por exemplo /images/logo.png.
  • get_media_itemsObtenha vários itens de mídia de uma vez passando seus GUIDs em id.
  • query_contentConsulte o conteúdo publicado. Use fetch para consultas de árvore (por exemplo, children:/blog/ ou descendants:{id}), filtro por tipo de conteúdo ou nome (por exemplo, contentType:article), ordenação (por exemplo, updateDate:desc) e pule/tome via offset e take.
  • query_mediaConsulte a biblioteca de mídia. Use fetch para consultas de pasta (por exemplo, children:/images/), filtre por tipo de mídia ou nome, ordene e use paginação com offset e take.

Configure em três passos

  1. 1

    Escolha a aplicação

    Crie uma conta gratuita no PipMCP e escolha Umbraco Content Delivery API na lista de aplicações.

  2. 2

    Cole a sua chave

    Digite o endereço do seu site e a chave da API de Entrega. Seu desenvolvedor ativa a API de Entrega e define a chave em appsettings (Umbraco:CMS:DeliveryApi:ApiKey); a mesma chave também dá acesso ao conteúdo protegido e pré-visualizações.

  3. 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 Umbraco?

Ela pode ler itens de conteúdo publicados e mídia do seu site, por ID, por caminho URL ou vários de uma vez. Ela pode consultar a árvore de conteúdo e a biblioteca de mídia com filtros, ordenação e paginação. Com uma chave habilitada para pré-visualização, ela também pode ler rascunhos não publicados. Ela não pode criar, editar ou publicar nada.

A IA vê minha chave de API Umbraco?

Não. Você cola sua chave da API de Entrega do Umbraco no PipMCP uma vez. Ela é criptografada em repouso, nunca mostrada à IA e nunca mostrada novamente após você salvá-la. A IA só recebe os resultados das ferramentas que você ativou.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, por exemplo, apenas conteúdo ou sem mídia. Todas as ferramentas do Umbraco apenas leem, então a IA não pode alterar seu site. Cada chamada de ferramenta é registrada.

Funciona com o ChatGPT?

Sim. No ChatGPT, abra 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) e no Cursor.

Qual é o custo?

O PipMCP tem um plano gratuito e você não precisa de cartão de crédito para começar. Os planos pagos são cobrados por tarefa concluída. Você conecta seu próprio site do Umbraco e o PipMCP apenas lê dele através da API de Entrega de Conteúdo.

Preciso de um desenvolvedor para configurar isso?

Alguém com acesso à configuração do Umbraco precisa ativar a API de Entrega em appsettings (Umbraco:CMS:DeliveryApi). Para conteúdo protegido ou rascunhos, eles também definem uma ApiKey lá. Depois disso, você insere o endereço e a chave do seu site no PipMCP e não é necessário código.

Deixe a sua IA trabalhar em Umbraco Content Delivery API ainda hoje.

Comece gratuitamente. A sua chave permanece encriptada e é você quem decide o que a IA pode fazer.

Ligar Umbraco Content Delivery API gratuitamente

O PipMCP não tem qualquer afiliação com Umbraco Content Delivery API. Os nomes dos produtos são marcas comerciais dos respetivos titulares.