MCP Server

O MCP Server do OpsScript expõe a plataforma como ferramentas padronizadas do Model Context Protocol (MCP). Qualquer cliente de IA compatível — Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI e outros — passa a consultar e operar o OpsScript em linguagem natural: "quais alertas críticos estão disparando?", "abra um chamado de incidente e me atribua", "o que tem no sprint atual?", "quanto de CPU o deployment X usa?".

Cada ação roda com a sua conta e as suas permissões: a IA nunca faz mais do que você mesmo poderia fazer na interface.

Endereço do servidorCopy Anchor Link

Configuração rápida por clienteCopy Anchor Link

Em todos os casos o fluxo é o mesmo: adicione a URL, o cliente abre o OpsScript no navegador, você entra, escolhe a organização e clica em Autorizar. Nenhum token é copiado manualmente.

claude mcp add --transport http opsscript https://mcp.opsscript.io/mcp
# na primeira chamada: /mcp → opsscript → Authenticate

{
  "mcpServers": {
    "opsscript": { "url": "https://mcp.opsscript.io/mcp" }
  }
}

{
  "servers": {
    "opsscript": { "type": "http", "url": "https://mcp.opsscript.io/mcp" }
  }
}

{
  "mcpServers": {
    "opsscript": { "serverUrl": "https://mcp.opsscript.io/mcp" }
  }
}

gemini mcp add --transport http opsscript https://mcp.opsscript.io/mcp

{
  "mcpServers": {
    "opsscript": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.opsscript.io/mcp"]
    }
  }
}

Alternativa: token pessoal (sem OAuth)Copy Anchor Link

Para automações ou clientes sem login pelo navegador, gere um token em Configurações → Tokens de acesso (API) (escopos de chamados, comentários, tempo e anexos) e envie-o no header X-OpsScript-Token:

{
  "mcpServers": {
    "opsscript": {
      "url": "https://mcp.opsscript.io/mcp",
      "headers": { "X-OpsScript-Token": "ops_pat_..." }
    }
  }
}

O que a IA pode fazerCopy Anchor Link

São 86 ferramentas, organizadas por domínio. Leituras são list_*/get_*; escritas ficam agrupadas em manage_<recurso> com um parâmetro action (ex.: manage_project com create, update ou delete).

Limites de caracteresCopy Anchor Link

As ferramentas aplicam os mesmos limites de caracteres da API (ex.: assunto do chamado com 200, comentário com 20.000). Texto acima do limite retorna erro GEN_019 com o campo e o máximo permitido, para a IA ajustar e reenviar.

Buscar na documentação: search_docsCopy Anchor Link

A ferramenta search_docs (em lançamento) busca na documentação oficial e devolve links das páginas relevantes. Útil para a IA responder dúvidas de uso citando a fonte. A lista completa de páginas também está em /docs/llms.txt.

Economizando contexto: filter e fieldsCopy Anchor Link

Toda ferramenta aceita dois parâmetros opcionais que a IA usa para devolver só o necessário:

• filter — expressão regular (sem distinção de maiúsculas) testada em cada item da lista; só os que casam voltam.
• fields — campos a manter em cada item, separados por vírgula (aceita um nível com ponto, ex.: status.name).

Uma lista filtrada volta como { total, matched, items, … }. Em pedidos amplos ("liste todos os workloads do cluster"), sugira à IA filtrar: "mostre só os deployments com CrashLoop, campos nome, namespace e restarts".

Exemplos de conversaCopy Anchor Link

Quais alertas críticos estão disparando agora? Agrupe por cluster.

Abra um chamado de incidente "API fora do ar em produção", prioridade urgente,
me atribua e inicie o timer.

Coloque os chamados #1042, #1043 e #1050 no sprint atual com 2h cada
e atribua ao João.

O webhook do Grafana não está abrindo chamados. Veja os últimos eventos
da política e me diga o motivo.

No cluster prod, crie uma regra que alerte quando um pod reiniciar
mais de 3 vezes em 10 minutos, severidade warning.

Permissões, sessão e errosCopy Anchor Link

• Permissões: a ferramenta só executa o que o seu cargo permite na organização escolhida no consentimento. Para atuar em outra organização, reconecte e escolha-a — ou informe organization_id nas ferramentas que aceitam.
• Sessão OAuth: fica ativa enquanto você usar o MCP (renovação automática em segundo plano). Nova autorização só após 30 dias sem uso, ao atingir o limite de 30 dias da autorização, ou se o acesso for revogado/assinatura bloqueada.
• Revogar: desconecte o servidor no cliente MCP. Para tokens pessoais, revogue em Configurações → Tokens de acesso (API).

Veja tambémCopy Anchor Link