Conectar seu aplicativo de IA ao PlanRadar com MCP (Beta)

Visão geral

Conecte um aplicativo de IA como ChatGPT, Claude, Claude Code, Codex ou LangDock ao PlanRadar. Depois, você pode perguntar ao aplicativo de IA sobre seus projetos com suas próprias palavras, em todos os seus projetos de uma vez, e deixar que ele faça alterações por você, como atualizar um ticket ou adicionar um comentário.

O aplicativo de IA age como você. Ele vê apenas o que você pode ver no PlanRadar e faz apenas o que o seu usuário tem permissão para fazer.

A conexão usa o Model Context Protocol (MCP). Você não precisa saber como o MCP funciona: basta copiar uma URL do PlanRadar para o seu aplicativo de IA e fazer login com o seu usuário do PlanRadar.

Acesso e permissões

• Somente os seus projetos. O aplicativo de IA vê apenas os projetos dos quais você é membro, e apenas o que a sua função em cada projeto permite ver.
• Uma única chave para a conta inteira. Um administrador da conta ativa o MCP uma vez para a conta. Não existe configuração por usuário. Cada usuário conecta e desconecta o seu próprio aplicativo de IA.
• As alterações são suas. Cada alteração feita pelo aplicativo de IA aparece no PlanRadar como feita por você, por exemplo no histórico do ticket, como uma alteração que você mesmo fez.

Ativar o MCP para a sua conta

Um administrador da conta faz isso uma vez para a conta inteira. A configuração só fica visível depois que o PlanRadar ativa o beta para a sua conta.

Para ativar o MCP:

1. Clique em Configurações
2. Clique em Conta
3. Clique em Configurações da conta
4. Marque Ativar MCP

Copiar a URL do seu servidor MCP

Cada usuário precisa da URL do servidor MCP para conectar o seu aplicativo de IA.

Para copiar a URL:

1. Clique em Configurações
2. Clique em Perfil
3. Clique em Aplicativos de IA conectados
4. Em URL do servidor MCP, clique em Copiar

Para a maioria das contas, a URL é https://www.planradar.com/mcp. Contas em outra instância do PlanRadar têm um endereço próprio, então use sempre a URL exibida nesta página.

Conectar seu aplicativo de IA

Todos os aplicativos de IA se conectam da mesma forma: você adiciona o PlanRadar com a URL do seu servidor MCP, faz login com o seu usuário do PlanRadar e confirma na página do PlanRadar.

Quando o aplicativo de IA perguntar como autenticar, escolha OAuth 2.0 with Dynamic Client Registration e deixe client ID e client secret em branco. O PlanRadar registra o aplicativo para você.

Se a sua empresa gerencia o aplicativo de IA para você, um administrador desse aplicativo pode precisar permitir ou adicionar o PlanRadar primeiro. Cada aba informa quando.

O que a página do PlanRadar mostra

Antes que um aplicativo de IA receba acesso, o PlanRadar mostra o que ele poderá fazer. Leia antes de clicar em Conectar:

• Pode visualizar: Seus tickets, projetos, planos, formulários, arquivos e relatórios.
• Pode executar: por exemplo, crie e atualize tickets e comentários e adicione arquivos à seção Documentos.
• Não pode: Excluir qualquer coisa.

A página também informa para onde vão os seus dados: o que o aplicativo de IA lê é enviado à empresa responsável por ele e processado lá. Por exemplo, o que o ChatGPT lê é enviado à OpenAI.

Se o PlanRadar não listar o aplicativo de IA, a página o marca como Não verificado pelo PlanRadar. Conecte apenas aplicativos em que você confia. O Claude Code e o Codex rodam no seu próprio computador, por isso sempre exibem essa marcação.

O que o aplicativo de IA pode fazer

O aplicativo de IA trabalha com os mesmos dados que você vê no PlanRadar, nos projetos dos quais você é membro.

Ele pode ler:

• Seus projetos e uma visão geral do status de cada projeto
• Tickets: pesquisá-los, ler seus detalhes, histórico e anexos, ver o que mudou desde uma data e resumi-los
• Formulários (tipos de ticket) e os usuários de um projeto
• Documentos: listar e pesquisar arquivos, ler o texto de um arquivo e obter um link de download
• Localizações e plantas
• Pedidos de aprovação
• Relatórios de projeto: listá-los e lê-los
• O cronograma (somente leitura)

Ele pode alterar:

• Criar e atualizar tickets, incluindo respostas de checklists
• Adicionar comentários a tickets
• Atribuir tickets
• Criar projetos, formulários e visualizações de filtro
• Adicionar arquivos à seção Documentos
• Convidar pessoas para a sua conta por e-mail. Elas entram como usuários internos
• Exportar tickets em PDF ou Excel, com um link de download

Ele não pode excluir nada.

O que você pode fazer com ele

Como o aplicativo de IA vê todos os seus projetos de uma vez, você pode fazer perguntas que exigiriam muitos cliques no PlanRadar. Pergunte com suas próprias palavras, no seu próprio idioma. Por exemplo:

Obter respostas de todos os seus projetos

• "Qual subcontratado tem mais tickets atrasados em todos os meus projetos?"
• "Faça uma tabela com uma linha por projeto: tickets abertos, tickets atrasados e o próximo marco do cronograma."
• "O que mudou nos tickets dos meus projetos desde segunda-feira?"

Escrever relatórios e atualizações

• "Resuma o progresso do Edifício B nesta semana para o incorporador."
• "Em que pé está o Edifício A, o que está atrasado e o que impede a conclusão? Escreva como um resumo curto para a diretoria."
• "Escreva uma atualização de status para o comprador do Apartamento 24. Omita os nomes internos."
• "Descreva nossos formulários, seus campos e status como um guia curto para novos mestres de obras."

Comparar e verificar

• "Compare o relatório semanal da semana passada com o desta semana e liste o que mudou."
• "Leia os dois relatórios de inspeção elétrica em Documentos e associe cada defeito a um ticket. Liste os defeitos que ainda não têm ticket."

Atualizar tickets pelo chat

• "Coloque o ticket 4 como Resolvido, adicione um comentário de que a mola aérea da porta foi substituída e mude o prazo para sexta-feira."
• "Crie um ticket no Edifício B: falta selagem corta-fogo no shaft R3, nível 3, prazo na próxima sexta-feira."

Combinar com o seu aplicativo de IA

• Use os recursos do próprio aplicativo de IA: "Mostre os tickets atrasados por subcontratado em um gráfico de barras", "Exporte o resultado como arquivo do Excel", "Transforme este resumo em um PDF".
• Combine o PlanRadar com outros conectores que a sua empresa já usa nesse aplicativo de IA, por exemplo o SharePoint: "Compare os tickets abertos do Edifício B com a lista de defeitos no SharePoint."

Pontos de atenção

• O aplicativo de IA não pode excluir nada.
• O cronograma é somente leitura. O aplicativo de IA não pode mover nem alterar tarefas do cronograma.
• O aplicativo de IA convida pessoas para a sua conta, não para um projeto específico. Adicioná-las a um projeto e definir sua função e permissões é feito no PlanRadar.
• Novos formulários criados pelo chat só podem ter campos simples: texto curto, texto longo, data, sim/não e usuário. Adicione checklists e listas no PlanRadar.
• Ele não pode criar um link direto para a posição de um ticket em uma planta.
• Arquivos enviados pelo chat podem ter até 25 MB por envio.
• Cada conexão pode enviar um número limitado de solicitações por minuto. Acima disso, o aplicativo de IA recebe "Too many requests on this connection. Retry in N seconds."
• Os links de download expiram: após 15 minutos para documentos e arquivos de tickets, 60 minutos para exportações de tickets e relatórios de projeto, e 2 horas para plantas. Peça um novo link ao aplicativo de IA se algum parar de funcionar.
• As respostas dependem do aplicativo de IA que você usa. Confira os números importantes no PlanRadar antes de agir com base neles.

Desconectar um aplicativo de IA

Você pode desconectar o seu próprio aplicativo de IA a qualquer momento. Ele perde o acesso na hora, e você pode conectá-lo novamente depois.

Para desconectar um aplicativo de IA:

1. Clique em Configurações
2. Clique em Perfil
3. Clique em Aplicativos de IA conectados
4. Clique em Desconectar ao lado do aplicativo
5. Clique em Desconectar para confirmar

Solução de problemas