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.
Recurso/Função
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 agir sobre sua infraestrutura 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. Quando você adiciona o servidor, o assistente pede que você faça 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/mcpPor 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
- Abra o ChatGPT. Seu plano deve suportar conectores MCP personalizados.
- Vá para Configurações → Aplicativos Conectados, ou use o menu "Conectar".
- Selecione Adicionar Servidor MCP.
- Insira
https://api.getprimo.com/mcp. - Faça login com sua conta de TI do Factorial quando a página OAuth abrir.
- Autorize a conexão.
Sugestões para tentar:
- "Liste todos os dispositivos gerenciados no Factorial IT"
- "Mostre-me os funcionários que se juntaram este mês"
- "Quais tickets estão atualmente pendentes?"
Como usar: Claude Desktop
- Abra o aplicativo Claude Desktop.
- Vá para Configurações → Desenvolvedor → Servidores MCP.
- Clique em Adicionar Servidor.
- Dê um nome (por exemplo, "Factorial IT") e insira
https://api.getprimo.com/mcp. - Complete o login OAuth com sua conta de TI do Factorial.
- Salve e reconecte. As ferramentas de TI do Factorial agora aparecem na caixa de ferramentas do Claude.
Como usar: Cursor
- Abra as configurações do Cursor.
- Vá para Servidores MCP.
- Adicione um servidor com a URL
https://api.getprimo.com/mcp. - Complete o login OAuth com sua conta de TI do Factorial. O assistente do Cursor pode 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 usa a empresa escolhida em Empresa MCP Padrão. Você a encontra na aba Empresas da Minha conta, que só aparece quando você pertence a duas ou mais empresas.
Quando nenhum padrão está definido, adicione o parâmetro x-company-id à URL:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_IDOs parâmetros podem ser combinados:
https://api.getprimo.com/mcp?x-company-id=YOUR_COMPANY_ID&readOnly=falsePara 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 só vê as ferramentas que seu papel permite. Ele é 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 no 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, apagar (⚠️), 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 desvinculações | — |
| 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, equipamento 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 permitem | 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 desfeitas: apagar 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 em somente leitura. Adicione
readOnly=falsesomente quando você realmente precisar que o assistente mude as coisas. - Feche tickets em vez de excluí-los. Excluir remove o ticket e suas tarefas para sempre.
- Verifique novamente antes de um apagamento. O assistente pode apagar dispositivos em modo de escrita, e um apagamento não pode ser desfeito.
-
Defina uma empresa padrão se você gerencia várias. Isso evita a necessidade de adicionar
x-company-ida cada URL e evita respostas do inquilino errado. - Conceda o papel correto. O assistente só recebe as ferramentas que seu papel permite, então o acesso é limitado pelas mesmas regras que o console.
Solução de Problemas e FAQ
Soluçã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 em seu assistente.
- A autenticação falha. Finalize o login OAuth quando o assistente pedir. 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 da Minha conta, ou adicione o parâmetro
x-company-idà URL. -
O assistente não pode mudar nada. A conexão é somente leitura por padrão. Reconecte-se com
readOnly=false.
FAQ
-
Preciso de uma chave de API?
Não. Você faz login com sua conta de TI do Factorial através do OAuth.
-
O assistente pode fazer alterações imediatamente?
Não. Ele começa em modo somente leitura. O acesso de escrita requer a URLreadOnly=false.
-
O assistente verá tudo no console?
Não. Ele só vê as ferramentas que seu papel permite.
-
Onde encontro meu ID de inquilino?
Liste suas empresas através da API, ou verifique a URL no console.
-
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.