Voltar

Conecte um assistente de IA ao servidor Primo MCP

O servidor Primo MCP permite que assistentes de IA, como ChatGPT, Claude ou Cursor, trabalhem com seus dados de TI do Factorial. Use-o quando quiser perguntar ou gerenciar seus dispositivos, funcionários e tickets em linguagem simples a partir do assistente que você já utiliza.


 

Funcionalidade

Visão Geral

O MCP (Modelo de Protocolo de Contexto) é um padrão aberto. Ele permite que um assistente de IA se conecte diretamente a ferramentas e dados externos, incluindo os de TI do Factorial.

Uma vez conectado, seu assistente pode ler e atuar sobre seu ambiente de TI quando você pedir: listar dispositivos, encontrar funcionários, gerenciar acessórios, abrir tickets e mais.

O que você precisa:

  • Uma conta de TI do Factorial com acesso ao espaço de trabalho da sua empresa.
  • Um assistente de IA que suporte MCP, como ChatGPT, Claude ou Cursor.

O login utiliza OAuth. Ao adicionar o servidor, o assistente te direciona para fazer login com sua conta de TI do Factorial. Nenhuma chave de API é necessária.

 

URL do Servidor

O servidor está disponível em:

https://api.getprimo.com/mcp

Por padrão, a conexão é somente leitura: o assistente pode visualizar os dados, mas não pode alterá-los.

Para acesso de escrita (abrir tickets, atualizar acessórios e assim por diante), use esta URL em vez disso:

https://api.getprimo.com/mcp?readOnly=false

 

Como usar: ChatGPT

  1. Abra o ChatGPT. Seu plano deve suportar conectores MCP personalizados.
  2. Vá para Configurações → Aplicativos Conectados, ou use o menu "Conectar".
  3. Selecione Adicionar Servidor MCP.
  4. Insira https://api.getprimo.com/mcp.
  5. Faça login com sua conta de TI do Factorial quando a página do OAuth abrir.
  6. Autorize a conexão.

Exemplos de perguntas para tentar:

  • "Liste todos os dispositivos gerenciados no Factorial IT"
  • "Mostre-me os funcionários que entraram este mês"
  • "Quais tickets estão atualmente pendentes?"

 

Como usar: Claude Desktop

  1. Abra o aplicativo Claude Desktop.
  2. Vá para Configurações → Desenvolvedor → Servidores MCP.
  3. Clique em Adicionar Servidor.
  4. Nomeie-o (por exemplo, "Factorial IT") e insira https://api.getprimo.com/mcp.
  5. Complete o login do OAuth com sua conta de TI do Factorial.
  6. Salve e reconecte. As ferramentas de TI do Factorial agora aparecem na caixa de ferramentas do Claude.

 

Como usar: Cursor

  1. Abra as configurações do Cursor.
  2. Vá para Servidores MCP.
  3. Adicione um servidor com a URL https://api.getprimo.com/mcp.
  4. Complete o login do OAuth com sua conta de TI do Factorial. O assistente do Cursor poderá então usar as ferramentas de TI do Factorial.

 

Como usar: outros assistentes

Qualquer aplicativo que siga o padrão MCP pode se conectar. Aponte para https://api.getprimo.com/mcp e faça login com sua conta de TI do Factorial através do OAuth.

 

Várias empresas em uma conta

Se sua conta puder acessar mais de um inquilino, o servidor usará a empresa escolhida em Empresa MCP Padrão. Você a encontra na aba Empresas de Minha conta, que só aparece quando você pertence a duas ou mais empresas.

Quando nenhum padrão estiver definido, adicione o parâmetro x-company-id à URL:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID

Os parâmetros podem ser combinados:

https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=false

Para obter seu ID de inquilino, liste suas empresas através da API ou verifique a URL no console.

 

O que o assistente pode fazer

O assistente vê apenas as ferramentas que seu papel permite. Ele está limitado a operações de leitura até que você se conecte com readOnly=false.

Categoria Operações de leitura Operações de escrita
Acessórios Listar e visualizar acessórios e seus campos personalizados Criar, atualizar, atribuir e arquivar acessórios; definir valores de campos personalizados
Administradores Listar os administradores da empresa Enviar e-mail para os administradores da empresa
Agentes de IA Listar agentes e suas execuções; ler o relatório e a transcrição de uma execução Criar um agente personalizado; substituir as instruções de um agente
Dashboards de IA Visualizar um dashboard e suas instruções Recompor um dashboard; substituir suas instruções
Ferramentas de IA Visualizar as ferramentas de IA encontradas em dispositivos, as descobertas de risco e as configurações das ferramentas de IA Aprovar ou bloquear ferramentas de IA; atualizar as configurações
Uso de IA Visualizar o uso de crédito de IA da empresa —
Perfis de Faturamento Listar perfis de faturamento —
Catálogo Pesquisar o catálogo e visualizar produtos, favoritos, países de envio e endereços da empresa; visualizar as políticas de equipamentos e compras Fixar e desfixar favoritos; atualizar e publicar as políticas de equipamentos e compras
Empresa Visualizar a empresa e seu relatório de métricas —
Conformidade Listar e pesquisar alertas de conformidade com seu contexto de remediação; visualizar regras de alerta, configurações e a política de remediação Criar e atualizar regras de alerta; atualizar as configurações; atualizar, publicar e despublicar a política de remediação
Campos Personalizados Listar e visualizar campos personalizados Criar, atualizar e arquivar campos personalizados
Grupos de Dispositivos Listar e visualizar grupos de dispositivos e o que os utiliza; verificar um alvo antes de criar um grupo Criar, atualizar e excluir grupos de dispositivos
Dispositivos Pesquisar, contar e visualizar dispositivos com suas atividades, comandos MDM, contas locais e campos personalizados; exportar dispositivos e inventário como CSV Criar, atualizar e excluir dispositivos; bloquear, desbloquear, limpar (⚠️), reiniciar, aposentar e desinscrever; mover para estoque ou em uso; executar um script; reenviar um perfil; definir tags e valores de campos personalizados
Funcionários Listar, pesquisar e visualizar funcionários e seus campos personalizados Criar, atualizar, ocultar e revelar funcionários; enviar um pedido de inscrição; definir valores de campos personalizados
Base de Conhecimento Listar e visualizar itens da base de conhecimento Criar, atualizar, publicar, despublicar e excluir itens
Controles MDM Listar, visualizar e navegar pelo catálogo de tipos; listar os controles que se aplicam a um dispositivo Criar, atualizar, excluir e atualizar tags
Offboarding Listar e visualizar desligamentos —
Onboarding Listar e visualizar integrações e as configurações de integração Criar, completar e ignorar integrações; executar as etapas de funcionário, conta de e-mail, equipamentos e SaaS; atualizar as configurações
Pedidos Listar e visualizar pedidos e seus campos personalizados Criar pedidos e pedidos de equipamentos; definir valores de campos personalizados
SaaS Listar e visualizar SaaS, seus problemas e as identidades de cada funcionário; visualizar o que as regras concedem Provisionar, desprovisionar, criar, vincular, arquivar e excluir identidades; redefinir uma senha; gerenciar grupos, funções, licenças e unidades organizacionais; atualizar contratos, proprietários, status de aprovação e regras
Scripts Listar scripts salvos e suas execuções, com o resultado em cada dispositivo Executar um script em um alvo
Envios Listar e visualizar envios Criar um envio
Software Visualizar o catálogo de software, o software em um dispositivo, status de instalação e logs, e vulnerabilidades CVE Instalar, desinstalar, atualizar e excluir software; atualizar scripts de instalação; sincronizar o catálogo ou um dispositivo
Tarefas Listar tarefas Criar e agendar tarefas; atualizar seu status e responsável
Tickets Listar, contar e visualizar tickets com seus assinantes; listar tags de tickets Criar e excluir tickets; adicionar comentários; atualizar status, prioridade, responsável e agente de IA; gerenciar assinantes, objetos vinculados e tags de tickets

Tenha cuidado com o modo de escrita. Algumas ações não podem ser revertidas: limpar um dispositivo, excluir permanentemente uma identidade SaaS com seu histórico ou excluir um ticket junto com suas tarefas. Se você quiser manter o histórico de um ticket, peça ao assistente para fechá-lo em vez de excluí-lo.


 

Dicas e Melhores Práticas

  • Comece somente leitura. Adicione readOnly=false apenas quando realmente precisar que o assistente faça alterações.
  • Feche tickets em vez de excluí-los. Excluir remove o ticket e suas tarefas para sempre.
  • Verifique duas vezes antes de limpar. O assistente pode limpar dispositivos em modo de escrita, e uma limpeza não pode ser desfeita.
  • Defina uma empresa padrão se você gerenciar várias. Isso evita a necessidade de adicionar x-company-id a cada URL e evita respostas do inquilino errado.
  • Conceda o papel correto. O assistente só obtém as ferramentas que seu papel permite, portanto, o acesso é limitado pelas mesmas regras do console.

 

Resolução de Problemas e FAQ

Resolução de Problemas

  • A URL mostra "404 Não Encontrado" em um navegador. Isso é esperado. O servidor não é uma página da web; é um endpoint para assistentes de IA. Adicione-o como um servidor MCP no seu assistente.
  • A autenticação falha. Termine o login do OAuth quando o assistente solicitar. Sua conta de TI do Factorial deve estar ativa e ter acesso à empresa que você deseja consultar.
  • O assistente mostra dados da empresa errada. Defina Empresa MCP Padrão na aba Empresas de Minha conta, ou adicione o parâmetro x-company-id à URL.
  • O assistente não consegue alterar nada. A conexão é somente leitura por padrão. Reconecte com readOnly=false.

 

FAQ

  1. Preciso de uma chave de API?
    Não. Você faz login com sua conta de TI do Factorial através do OAuth.
     
  2. O assistente pode fazer alterações imediatamente?
    Não. Ele começa em modo somente leitura. O acesso de escrita requer a URL readOnly=false.
     
  3. O assistente verá tudo no console?
    Não. Ele só vê as ferramentas que seu papel permite.
     
  4. Onde encontro meu ID de inquilino?
    Liste suas empresas através da API ou verifique a URL no console.
     
  5. Quem eu contato para ajuda com a configuração?
    Entre em contato com o suporte de TI do Factorial ou use o chat no aplicativo. A documentação da API está em api.getprimo.com/apidoc.

Este artigo foi útil?

Give feedback about this article

Não consegue encontrar o que procura?

A nossa equipe de atendimento ao cliente está aqui para ajudar.

Contato

Knowledge Base Software powered by Helpjuice

class="shortcode_"