ServiceNow Incidents MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ServiceNow Incidents MCP list open high-priority incidents"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ServiceNow Incidents MCP
Servidor Python/FastMCP para consultar, criar e atualizar incidentes pela Table API do ServiceNow. Executa localmente via stdio, com uma instância e uma identidade por processo.
Instalação e execução
Requisitos: Python 3.12+ e uv.
uv sync --lockedCrie um .env na raiz usando .env.example como referência e preencha as credenciais.
O arquivo .env está ignorado pelo Git. Também é possível fornecer variáveis de ambiente,
que têm precedência sobre o arquivo. Execute a partir da raiz:
uv run --locked servicenow-mcp
# Alternativa:
uv run --locked python -m servicenow_mcpO processo aguarda mensagens MCP em stdin; não é um terminal interativo nem um servidor HTTP. O cliente MCP normalmente inicia e encerra esse processo. Logs usam stderr, reservando stdout para o protocolo. Não há banco de dados ou persistência local de incidentes.
Related MCP server: ServiceNow MCP Server
Configuração
Variável | Uso |
| Origem HTTPS, por exemplo |
|
|
| Usuário de integração, obrigatório para Basic |
| Senha, obrigatória para Basic |
| Token de acesso já obtido, obrigatório para Bearer |
| Timeout por operação de rede, padrão 30; maior que 0 e até 300 |
Bearer não obtém nem renova tokens. Após substituir um token expirado na configuração,
reinicie o processo MCP. A conta precisa de acesso REST e das ACLs adequadas à tabela
incident e aos campos usados. Não existe uma lista universal de papéis para todas as
instâncias; confirme com o administrador no REST API Explorer.
TLS permanece validado. Redirecionamentos e proxies de ambiente são desabilitados. Esta versão usa conexão direta à instância; ambientes que exigem proxy ou CA corporativa precisam de configuração adicional no cliente HTTP.
Cliente MCP com configuração JSON
Exemplo para clientes que aceitam mcpServers. Substitua os caminhos absolutos; use o
caminho de uv retornado por command -v uv quando o aplicativo não herdar seu PATH.
O .env é carregado do diretório informado em --directory.
{
"mcpServers": {
"servicenow": {
"command": "/caminho/absoluto/para/uv",
"args": [
"--directory", "/caminho/absoluto/mcp-server-servicenow",
"run", "--locked", "servicenow-mcp"
]
}
}
}Ferramentas
Ferramenta | Argumentos |
|
|
|
|
|
|
|
|
|
|
identifier aceita sys_id hexadecimal de 32 caracteres ou número INC seguido de dígitos.
A busca por número é exata; antes de alterar, o servidor resolve o número para sys_id.
Números inexistentes ou ambíguos geram erro, sem escrita.
Exemplos de argumentos de chamadas MCP:
{"query": "active=true^priority=1^ORDERBYsys_id", "limit": 20, "offset": 0}{"identifier": "INC0010001", "fields": ["number", "short_description", "state", "description"]}{
"short_description": "VPN indisponível",
"fields": {"description": "Falha ao conectar à rede interna", "impact": "2", "urgency": "2"}
}{"identifier": "INC0010001", "fields": {"urgency": "1", "u_external_reference": "SUP-123"}}{"identifier": "INC0010001", "text": "Investigação em andamento.", "field": "work_notes"}Campos de escrita aceitam valores escalares JSON ou null, cuja interpretação é da API.
Referências, como caller_id, assigned_to e assignment_group, usam sys_id, não nomes.
Campos number e sys_* são protegidos. Não envie short_description também dentro de
fields ao criar. Campos desconhecidos, obrigatórios e personalizados são tratados pelas
regras da instância; confira a resposta, pois a plataforma pode ignorar campos não reconhecidos.
Campos omitidos não são enviados no PATCH. Estados não são traduzidos ou fixados pelo servidor.
Para resolver um incidente, envie em update_incident o state e os demais campos exigidos
pela sua instância. Campos de journal acrescentam entradas; a consulta do incidente não é
uma API de histórico completo de comentários. A visibilidade de comments e work_notes
depende da configuração local do ServiceNow.
Resultados e paginação
As operações individuais retornam o objeto result da API, sem converter strings numéricas,
booleanos ou referências. São solicitados valores internos (sysparm_display_value=false)
e referências sem links. get_incident retorna os campos acessíveis por padrão; a listagem
seleciona sys_id, number, short_description, state, priority, assigned_to,
assignment_group e sys_updated_on. Use fields para mudar essa seleção.
{"records": [], "limit": 20, "offset": 0, "total": 45, "next_offset": 20}total vem de X-Total-Count; next_offset usa o link next ou o total informado.
As ACLs podem produzir páginas curtas ou vazias antes do fim. Sem metadados de paginação,
next_offset=null significa que a próxima página é desconhecida; o cliente pode consultar
explicitamente offset + limit. Não há busca automática de todas as páginas.
A consulta padrão ordena por sys_id; ao passar query, inclua ordenação para percorrer
resultados de forma previsível. Alterações concorrentes na tabela podem afetar a paginação.
query é uma encoded query nativa, não SQL. A API pode ignorar partes inválidas de filtros
conforme a configuração da instância. Valide filtros no REST API Explorer; esta ferramenta
não valida o dicionário de campos da instância e consultas não autorizam alterações em lote.
Falhas
Erros MCP distinguem configuração, validação local, HTTP 400/401/403/404/409/422/429/5xx, timeout, falha de conexão e respostas inesperadas. Corpos de erro remotos, credenciais e conteúdo dos incidentes não são incluídos nos logs. Não há tentativas automáticas, inclusive para escritas: em caso de timeout, falha de conexão ou erro 5xx, consulte o incidente antes de repetir para evitar incidentes ou comentários duplicados.
Desenvolvimento e testes
uv run --locked ruff check .
uv run --locked ruff format --check .
uv run --locked pytest
uv buildO pacote está dividido em configuração, cliente HTTP, serviço de incidentes e registro MCP
em src/servicenow_mcp. Os testes usam transporte HTTP simulado e cliente FastMCP em memória;
o teste stdio inicia um subprocesso real e verifica descoberta e validação local sem acessar
uma instância. Não precisa de credenciais reais para executar os testes.
Validação real: configure uma instância de desenvolvimento, conecte o cliente MCP, consulte um incidente conhecido e crie/atualize um incidente de teste com as ferramentas. Essa etapa exige credenciais e autorização para os registros envolvidos; não é executada pela suíte.
Não inclui exclusões, anexos, outros módulos ServiceNow, transporte HTTP remoto ou renovação OAuth. Nenhuma configuração ou ACL é alterada na instância pelo projeto.
Referências analisadas
A referência consultada é da família Australia. O projeto usa /api/now/table/incident
(versão padrão da instância); compatibilidade com customizações deve ser verificada localmente.
Available Tools
5 toolsadd_incident_commentA
Adiciona comentário (comments) ou nota interna (work_notes), com seleção obrigatória.
A visibilidade segue a configuração da instância. Repetir pode duplicar a entrada.
Inputs: text (required), field (required), identifier (required). Returns: object
create_incidentA
Cria incidente; fields aceita description, impact, urgency, caller_id e campos u_*.
Referências devem usar sys_id. Campos extras obrigatórios dependem da instância. Não permite number ou sys_*. Não repita automaticamente após falha de comunicação.
Inputs: short_description (required), fields. Returns: object
get_incidentARead-only
Obtém um incidente por sys_id ou número INC; fields limita os campos retornados.
Inputs: identifier (required), fields. Returns: object
list_incidentsARead-only
Lista incidentes com encoded query ServiceNow, campos e paginação explícita.
Exemplo de query: active=true^priority=1^ORDERBYsys_id. Páginas vazias podem ocorrer por ACL; use next_offset/total quando disponíveis.
Inputs: limit, query, fields, offset. Returns: limit, total, offset, records, +1 more
update_incidentBDestructive
Altera apenas os campos fornecidos via PATCH, incluindo campos personalizados.
Exige fields não vazio. Não permite number ou sys_*. Para resolução, envie state e os campos exigidos pela instância; não há conversão automática de nomes de estados.
Inputs: fields (required), identifier (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct action and resource: listing, fetching, creating, updating, and commenting on incidents. The add_incident_comment tool is clearly separated from update_incident by its specific purpose of adding comments or work notes.
Tool names consistently follow a verb_noun pattern: list_incidents, get_incident, create_incident, update_incident, add_incident_comment. The only mild deviation is the wider verb 'add' for comments, but it still fits the convention.
Five tools is well-scoped for a ServiceNow incidents server, covering the core incident workflow without unnecessary bloat. Each tool earns its place and the count is appropriate for the domain.
The server provides solid lifecycle coverage with list, get, create, update, and comment operations. Missing delete is acceptable for incident management, though there is no direct way to retrieve existing comments/work notes, which is a minor gap.
Maintenance
Related MCP Connectors
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
Manage incidents and on-call: list/create/update incidents, who is on call, on-call overrides.
Read incidents, services, teams, on-call schedules; acknowledge, resolve and note incidents.
Manage incident alerts, events, and workflows with custom automations
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceEnables Claude to interact with ServiceNow instances through the ServiceNow API. Supports comprehensive ServiceNow operations including incident management, service catalog management, change requests, user management, and workflow automation through natural language.82MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to interact with ServiceNow instances for incident management, service catalog operations, change requests, knowledge base management, user administration, and agile project workflows through various authentication methods.MIT
- AlicenseCqualityDmaintenanceEnables Claude to interact with ServiceNow instances to manage incidents, service catalogs, workflows, and knowledge bases through the ServiceNow API. It supports comprehensive operations including record querying, script execution, and user management using various authentication methods.66MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with ServiceNow instances for data retrieval, record management, and workflow execution via the ServiceNow API.MIT