MCP Server
Como configurar e utilizar o servidor MCP do OpsScript para integrar a plataforma com clientes de inteligência artificial
O MCP Server do OpsScript é um servidor dedicado que implementa o protocolo Model Context Protocol (MCP), permitindo que clientes de inteligência artificial acessem e operem todos os recursos da plataforma através de ferramentas padronizadas. Com mais de 200 ferramentas disponíveis, é possível gerenciar chamados, projetos, sprints, usuários e muito mais diretamente a partir do seu assistente de IA favorito.
O MCP é um padrão aberto para conectar sistemas de IA a ferramentas e fontes de dados externas de forma segura e estruturada.
O que é o Model Context Protocol (MCP)
O Model Context Protocol é um padrão aberto que define como sistemas de IA se conectam a ferramentas externas. Em vez de cada ferramenta implementar sua própria forma de comunicação com assistentes de IA, o MCP estabelece um protocolo comum que qualquer cliente compatível pode utilizar.
Na prática, isso significa que ao configurar o MCP Server do OpsScript, você pode utilizar qualquer cliente MCP (Claude Desktop, Cursor, VS Code, entre outros) para interagir com a plataforma por linguagem natural.
O MCP Server funciona como um serviço independente que traduz comandos de clientes de IA em operações reais no OpsScript. A autenticação é feita através de tokens pessoais, garantindo que cada operação respeite as permissões do usuário autenticado.
Ferramentas disponíveis
O MCP Server expõe mais de 200 ferramentas organizadas nas seguintes categorias:
| Categoria | Ferramentas | Exemplos |
|---|---|---|
| Chamados | 19 | Criar, listar, atualizar, arquivar chamados; assumir; registro de tempo |
| Prioridades | 4 | Listar, criar, atualizar prioridades |
| Status | 4 | Listar, criar, atualizar status |
| Tipos de Chamado | 4 | Listar, criar, atualizar tipos |
| Comentários | 5 | Criar, listar, atualizar comentários |
| Anexos | 6 | Upload, download, listar anexos |
| Tempo | 3 | Registrar, atualizar, remover tempo |
| Projetos | 6 | CRUD de projetos |
| Sprints | 12 | CRUD de sprints, adicionar chamados, relatórios |
| Checklists | 5 | CRUD de itens de checklist |
| Tags | 4 | CRUD de tags |
| Usuários | 13 | CRUD, convites, notificações, busca |
| Organizações | 11 | CRUD, documentação, configurações |
| Grupos | 7 | CRUD, adicionar/remover membros |
| Autenticação | 20 | Login, cargos, permissões |
| Tokens Pessoais | 5 | CRUD, validação |
| Webhooks | 9 | CRUD, eventos, retry |
| Integrações | 15 | Providers, triggers, broadcasting |
| Analytics | 22 | Métricas de chamados, SLA, horas por agente |
| Assinatura | 17 | Planos e assinatura |
| Faturamento | 5 | Faturas e cobrança |
| Perfil | 14 | Imagem, preferências, integrações pessoais |
| Convites | 2 | Envio e gestão de convites |
| Verificação | 2 | Validações de conta |
Conectando ao MCP Server
O MCP Server é executado como um serviço independente e é compatível com qualquer cliente MCP. A autenticação é feita por tokens pessoais do OpsScript ou credenciais de API.
Pré-requisitos
- Conta ativa no OpsScript com as permissões desejadas
- Um cliente MCP compatível (Claude Desktop, Cursor, VS Code, etc.)
- URL do servidor MCP (fornecida pelo administrador ou configurada via variável de ambiente)
Configuração
Gere um token pessoal no OpsScript
Acesse Configurações → Tokens de acesso (API) no OpsScript. Clique para abrir o modal Novo Personal Token, preencha a Descrição (por exemplo, "MCP Server") e, opcionalmente, uma Data de Expiração; em seguida clique em Criar Token. Copie o token gerado imediatamente, pois ele não será exibido novamente. O token herda as permissões da sua conta — não há escopos separados.
Configure o cliente MCP com a URL e o token
No seu cliente MCP, adicione uma nova conexão de servidor. Informe a URL do MCP Server do OpsScript e o token pessoal gerado no passo anterior. Cada cliente possui sua própria interface de configuração; consulte a documentação do cliente para detalhes específicos.
Comece a utilizar as ferramentas do OpsScript
Após a configuração, as ferramentas do OpsScript estarão disponíveis no seu assistente de IA. Você pode começar a interagir com a plataforma por linguagem natural, como "crie um chamado de incidente com prioridade alta" ou "liste os sprints ativos do projeto X".
O token pessoal possui as mesmas permissões da sua conta de usuário. Armazene-o em local seguro e nunca o compartilhe. Caso suspeite de comprometimento, revogue o token imediatamente em Configurações → Tokens de acesso (API) e gere um novo.
Prompts guiados
O MCP Server disponibiliza 18 prompts guiados que facilitam a interação com as ferramentas. Esses prompts fornecem contexto e estrutura para que o assistente de IA execute operações complexas de forma precisa:
manage_tickets-- Gerenciamento completo de chamadosmanage_ticket_priorities-- Configuração de prioridades de chamadomanage_ticket_statuses-- Configuração de status de chamadomanage_ticket_types-- Configuração de tipos de chamadomanage_ticket_comments-- Operações com comentários de chamadomanage_ticket_attachments-- Gerenciamento de anexos de chamadomanage_ticket_agent_time-- Registro e controle de tempo do agentemanage_projects-- Operações com projetosmanage_users-- Gestão de usuários e convitesmanage_organizations-- Administração de organizaçõesmanage_tags-- Gestão de tagsmanage_groups-- Administração de grupos e membrosmanage_sprints-- Controle de sprints e planejamentomanage_checklists-- Controle de checklists em chamadosmanage_webhooks-- Configuração de webhooksmanage_integrations-- Gerenciamento de integraçõesmanage_subscriptions-- Controle de assinaturas e planosmanage_personal_tokens-- Gestão de tokens de acesso (API)
Ao utilizar um cliente de IA como o Claude Desktop, mencione o nome do prompt guiado para obter melhores resultados. Por exemplo, diga "use manage_tickets para listar os chamados abertos" em vez de simplesmente "liste os chamados".
Casos de uso
Automação de chamados via IA
Crie, atualize e gerencie chamados diretamente pelo seu assistente de IA. Ideal para operações repetitivas como criação de chamados a partir de templates, atualização em lote de status e atribuição automática de responsáveis.
Relatórios e analytics por linguagem natural
Solicite relatórios e métricas em linguagem natural. O assistente de IA utiliza as ferramentas de analytics do MCP Server para consultar dados e apresentar resultados formatados, sem necessidade de navegar por painéis de relatórios.
Gestão de projetos e sprints
Gerencie projetos, sprints e planejamento sem sair do seu cliente de IA. Adicione tickets a sprints, atualize prazos, consulte o progresso e gere relatórios de sprint diretamente pela conversa.
Operações em lote
Execute operações em massa através de instruções simples. Por exemplo, "mova todos os chamados de prioridade baixa do projeto X para o backlog" ou "atribua todos os incidentes sem responsável ao agente Y".
Todas as operações realizadas pelo MCP Server respeitam as permissões do usuário autenticado pelo token. Não é possível executar ações além do que a conta do usuário permite.