NoirAI MCP Server

A Model Context Protocol (MCP) server that provides seamless access to NoirAI observability data through AI assistants and LLMs. Query metrics, traces, logs, alerts, dashboards, and services using natural language.

📖 Full Documentation

Table of Contents

• Connect to noirai.cloud
• Self-Hosted Installation
• Connect to Self-Hosted NoirAI
• What Can You Do With It?
• Available Tools
• Environment Variables
• Claude Desktop Extension
• Architecture
• Contributing

Fork status

This repository is a NoirAI-branded fork of SigNoz/signoz-mcp-server. Tool names use the noirai_* prefix. Configure with NOIRAI_URL and NOIRAI_API_KEY (SIGNOZ_URL / SIGNOZ_API_KEY remain supported for compatibility).

Connect to NoirAI Cloud

Connect your AI tool to noirai.cloud's hosted MCP server. No installation is required; just add the hosted MCP URL and authenticate.

https://mcp.<region>.noirai.cloud/mcp

Make sure you select the correct region that matches your noirai.cloud account. Using the wrong region will result in authentication failures.

Find your region under Settings → Ingestion in NoirAI, or see the noirai.cloud region reference.

One-Click Install Links

GitHub does not reliably make custom-protocol links like cursor:// and vscode: clickable in README rendering.

Use the documentation page for one-click install buttons:

• Open one-click install links for Cursor
• Open one-click install links for VS Code

If you prefer, use the manual configuration examples below in this README.

Cursor

Manual Configuration

Add this configuration to .cursor/mcp.json:

{
  "mcpServers": {
    "NoirAI": {
      "url": "https://mcp.<region>.noirai.cloud/mcp"
    }
  }
}

Need help? See the Cursor MCP docs.

VS Code / GitHub Copilot

Manual Configuration

Add this configuration to .vscode/mcp.json:

{
  "servers": {
    "NoirAI": {
      "type": "http",
      "url": "https://mcp.<region>.noirai.cloud/mcp"
    }
  }
}

Need help? See the VS Code MCP docs.

Claude Desktop

Add noirai.cloud as a custom connector in Claude Desktop:

1. Open Claude Desktop.
2. Go to Settings → Developer (or Features, depending on your version).
3. Click Add Custom Connector or Add Remote MCP Server.
4. Enter your NoirAI MCP URL: https://mcp.<region>.noirai.cloud/mcp

When prompted, complete the authentication flow.

Claude Code

Run this command to add the hosted NoirAI MCP Server:

claude mcp add --scope user --transport http NoirAI https://mcp.<region>.noirai.cloud/mcp

After configuring the MCP server, authenticate in a terminal:

claude /mcp

Select the NoirAI server and complete the authentication flow.

OpenAI Codex

Run this command to add the hosted NoirAI MCP Server:

codex mcp add NoirAI --url https://mcp.<region>.noirai.cloud/mcp

Or add this configuration to config.toml:

[mcp_servers.NoirAI]
url = "https://mcp.<region>.noirai.cloud/mcp"

After adding the se

... View full README on GitHub