Skip to main content

ChatGPT

Configure the ChatGPT desktop app to access your Netdata observability data through MCP.

Transport Support​

The ChatGPT desktop app adds custom MCP servers from its settings, with these transports:

TransportSupportNetdata VersionNotes
Streamable HTTP✅ Fully Supportedv2.7.2+Netdata Cloud MCP, or a Netdata Agent or Parent directly
stdio✅ Fully Supportedv2.6.0+Launch Netdata through nd-mcp

Prerequisites​

  1. ChatGPT desktop app installed
  2. One of:
    • Netdata Cloud account with a Paid plan, nodes claimed to Netdata Cloud, and an API token with scope:mcp (create one)
    • Netdata Agent or Parent v2.6.0 or later, reachable from the computer running ChatGPT, and its MCP API key (find your Netdata MCP API key). Prefer a Netdata Parent for visibility across all its nodes.

Add Netdata to ChatGPT​

Open Settings → Plugins → MCPs, then Add and choose to connect a custom MCP. The Connect to a custom MCP form opens.

Netdata Cloud MCP​

Connect to all your Netdata Cloud nodes through a single endpoint, with no local setup, bridges or firewall changes.

FieldValue
Namenetdata-cloud
TypeStreamable HTTP
URLhttps://app.netdata.cloud/api/v1/mcp
Bearer token env varthe name of an environment variable holding your Netdata Cloud API token, for example NETDATA_CLOUD_TOKEN

Instead of an environment variable, you can add a header under Headers: key Authorization, value Bearer YOUR_NETDATA_CLOUD_API_TOKEN. The environment variable keeps the token out of the app's settings.

Select Save. For more details, see Netdata Cloud MCP.

Local Agent or Parent: Streamable HTTP (Netdata v2.7.2+)​

FieldValue
Namenetdata
TypeStreamable HTTP
URLhttp://YOUR_NETDATA_IP:19999/mcp
Bearer token env varthe name of an environment variable holding your Netdata MCP API key, for example ND_MCP_BEARER_TOKEN

Use https:// when the Agent or Parent is served over TLS.

Local Agent or Parent: stdio bridge (all Netdata versions)​

FieldValue
Namenetdata
TypeSTDIO
Command/usr/sbin/nd-mcp
Argumentsws://YOUR_NETDATA_IP:19999/mcp
Environment variablesND_MCP_BEARER_TOKEN = your Netdata MCP API key

The bridge reads the API key from the ND_MCP_BEARER_TOKEN environment variable.

Environment Variables​

The app reads environment variables when it starts. Set the variable in the environment the ChatGPT desktop app is launched from, then restart the app. If the app cannot see the variable, use the Headers option instead.

Using Netdata in ChatGPT​

Ask about your systems, applications and network in plain language:

Which nodes have the highest CPU utilization right now?
Show me anomalies across my database servers in the last hour.
What changed on the web servers before the latency spike at 14:00?

Troubleshooting​

Netdata does not appear in ChatGPT​

  • Check that the server is listed and enabled under Settings → Plugins → MCPs
  • Restart the ChatGPT desktop app after changing environment variables

Authentication errors​

  • Netdata Cloud: the API token must have scope:mcp
  • Agent or Parent: each Agent and Parent has its own MCP API key; use the key of the node in the URL
  • Agent or Parent: verify the Netdata Agent is claimed to Netdata Cloud
  • Check that the environment variable named in Bearer token env var is set for the app

Connection errors​

  • Test that Netdata is reachable: curl http://YOUR_NETDATA_IP:19999/api/v3/info
  • Check that firewalls allow the connection to port 19999

Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.