--- title: Use the InfluxDB 3 MCP server description: Use the InfluxDB Model Context Protocol (MCP) server to interact with and manage InfluxDB Cloud Dedicated using natural language with LLM agents to query and analyze data, manage databases and more. Query InfluxDB Cloud Dedicated documentation from your IDE using the InfluxDB documentation Model Context Protocol (MCP) server. url: https://docs.influxdata.com/influxdb3/cloud-dedicated/admin/mcp-server/ estimated_tokens: 7646 product: InfluxDB Cloud Dedicated version: cloud-dedicated --- # Use the InfluxDB 3 MCP server InfluxDB provides two Model Context Protocol (MCP) servers for integrating with AI assistants: - [Manage your InfluxDB instance with the database MCP server](#manage-your-influxdb-instance-with-the-database-mcp-server) - [Query documentation from your IDE](#query-documentation-from-your-ide) ## Manage your InfluxDB instance with the database MCP server The **InfluxDB database MCP server** lets you interact with InfluxDB Cloud Dedicated using natural language with large language model (LLM) agents. It enables database management, token handling, and SQL query generation in plain English—no coding required. This section walks you through configuring your LLM agent to run and use the InfluxDB database MCP server to interact with your InfluxDB Cloud Dedicated cluster . ### Prerequisites - Node.js v18+ *(if using `npx` to run the MCP server)* - Docker *(if using Docker to run the MCP server)* - A running and reachable InfluxDB Cloud Dedicated cluster . - Valid InfluxDB Cloud Dedicated [management and database tokens](/influxdb3/cloud-dedicated/admin/tokens/) - *(Optional)* An LLM assistant like Claude Desktop, ChatGPT Desktop, etc. ### Configure the database MCP server Use environment variables to configure the InfluxDB 3 MCP server and connect it to your InfluxDB Cloud Dedicated cluster . Set the following environment variables when you start the MCP server: #### Required InfluxDB connection variables - **INFLUX\_DB\_PRODUCT\_TYPE**: `cloud-dedicated` - **INFLUX\_DB\_ACCOUNT\_ID**: Your InfluxDB Cloud Dedicated [account ID](/influxdb3/cloud-dedicated/admin/account/) - **INFLUX\_DB\_CLUSTER\_ID**: Your InfluxDB Cloud Dedicated [cluster ID](/influxdb3/cloud-dedicated/admin/clusters/) - **INFLUX\_DB\_TOKEN**: An InfluxDB Cloud Dedicated [database token](/influxdb3/cloud-dedicated/admin/tokens/database/) - **INFLUX\_DB\_MANAGEMENT\_TOKEN**: An InfluxDB Cloud Dedicated [management token](/influxdb3/cloud-dedicated/admin/tokens/management/) #### Optional tokens You can include one or both of `INFLUX_DB_TOKEN` and `INFLUX_DB_MANAGEMENT_TOKEN`, but omitting either limits the type of operations your LLM agents can perform on your InfluxDB Cloud Dedicated cluster. ### Configure your LLM agent to run the database MCP server To run the MCP server, use either Node.js and `npm` or Docker. Some LLM agents, like [Claude Desktop](https://claude.ai/download), start, run, and connect to the MCP server for you. The following instructions show how to configure **Claude Desktop** to use the InfluxDB database MCP server. **Node.js:** 1. Clone the [influxdata/influxdb3\_mcp\_server repository](https://github.com/influxdata/influxdb3_mcp_server) from GitHub. 2. Navigate to the `influxdb3_mcp_server` project directory: ```bash cd influxdb3_mcp_server/ ``` 3. Install dependencies: ```bash npm install ``` 4. Build the MCP server: ```bash npm run build ``` This builds the files necessary to run the MCP server and stores them in `./build`. The `./build/index.js` file starts the MCP server. #### Configure your LLM Agent to use the Node.js-based MCP server In **Claude Desktop**, go to **Settings** > **Developer** and edit your configuration. Enter the following JSON configuration: ```json { "mcpServers": { "influxdb": { "command": "node", "args": ["/path/to/influxdb3_mcp_server/build/index.js"], "env": { "INFLUX_DB_PRODUCT_TYPE": "cloud-dedicated", "INFLUX_DB_CLUSTER_ID": "DEDICATED_CLUSTER_ID", "INFLUX_DB_ACCOUNT_ID": "DEDICATED_ACCOUNT_ID", "INFLUX_DB_TOKEN": "DEDICATED_DATABASE_TOKEN", "INFLUX_DB_MANAGEMENT_TOKEN": "DEDICATED_MANAGEMENT_TOKEN" } } } } ``` Replace the following: - `path/to`: The absolute path to your `influxdb3_mcp_server` project directory. - `DEDICATED_ACCOUNT_ID`: Your InfluxDB Cloud Dedicated account ID - `DEDICATED_CLUSTER_ID`: Your InfluxDB Cloud Dedicated cluster ID - `DEDICATED_DATABASE_TOKEN`: A [database token](/influxdb3/cloud-dedicated/admin/tokens/database/) with permissions that grant access to all databases you would like your LLM agent to be able to write data to and query data from - `DEDICATED_MANAGEMENT_TOKEN`: A [management token](/influxdb3/cloud-dedicated/admin/tokens/management/) that lets your LLM agent perform administrative tasks on your InfluxDB Cloud Dedicated cluster **Docker:** #### Configure your LLM Agent to use the Docker-based MCP server In **Claude Desktop**, go to **Settings** > **Developer** and edit your configuration. Enter the following JSON configuration: ```json { "mcpServers": { "influxdb": { "command": "docker", "args": [ "run", "--rm", "--interactive", "--env", "INFLUX_DB_PRODUCT_TYPE", "--env", "INFLUX_DB_ACCOUNT_ID", "--env", "INFLUX_DB_CLUSTER_ID", "--env", "INFLUX_DB_TOKEN", "--env", "INFLUX_DB_MANAGEMENT_TOKEN", "influxdata/influxdb3-mcp-server" ], "env": { "INFLUX_DB_PRODUCT_TYPE": "cloud-dedicated", "INFLUX_DB_ACCOUNT_ID": "DEDICATED_ACCOUNT_ID", "INFLUX_DB_CLUSTER_ID": "DEDICATED_CLUSTER_ID", "INFLUX_DB_TOKEN": "DEDICATED_DATABASE_TOKEN", "INFLUX_DB_MANAGEMENT_TOKEN": "DEDICATED_MANAGEMENT_TOKEN" } } } } ``` Replace the following: - `DEDICATED_ACCOUNT_ID`: Your InfluxDB Cloud Dedicated account ID - `DEDICATED_CLUSTER_ID`: Your InfluxDB Cloud Dedicated cluster ID - `DEDICATED_DATABASE_TOKEN`: A [database token](/influxdb3/cloud-dedicated/admin/tokens/database/) with permissions that grant access to all databases you would like your LLM agent to be able to write data to and query data from - `DEDICATED_MANAGEMENT_TOKEN`: A [management token](/influxdb3/cloud-dedicated/admin/tokens/management/) that lets your LLM agent perform administrative tasks on your InfluxDB Cloud Dedicated cluster ### Supported features Once connected, you can use your LLM agent to perform tasks on your InfluxDB Cloud Dedicated cluster , including: - Create, update, and delete databases - List tables and inspect schemas - Create and manage tokens - Query data without writing SQL or InfluxQL - Check server health and connection status #### Examples of supported prompts > “List all tables in the `production` database.” > > “Create a read-only token for the `metrics` database.” > > “Analyze last week’s sensor data for anomalies.” > > “Create a new database called `iot_sensors` with a 30-day retention policy.” > > “Show me the schema for the `sensor_data` table.” ## Query documentation from your IDE The **InfluxDB documentation MCP server** lets AI tools and agents search InfluxDB InfluxDB Cloud Dedicated documentation directly from your development environment. Use it to find answers, code examples, and configuration details without leaving your IDE. ### Why use the documentation MCP server? When you connect the documentation MCP server to your AI coding assistant, the assistant can search InfluxDB and related tool documentation to answer your questions with accurate, up-to-date information. Instead of switching to a browser or guessing at syntax, you can ask questions in your IDE and get responses grounded in official documentation. **Common use cases:** - Get help writing queries, client library code, or CLI commands - Look up configuration options and environment variables - Find code examples for specific tasks - Troubleshoot errors with documentation-backed answers ### Install the documentation MCP server The documentation MCP server is a hosted service—you don’t need to install or run anything locally. Add the server URL to your AI assistant’s MCP configuration. On first use, you’ll be prompted to sign in with a Google or GitHub account. This authentication is used only for rate limiting—no personal data is collected. **MCP server URL:** ```text https://influxdb-docs.mcp.kapa.ai ``` The server uses SSE (Server-Sent Events) transport. #### Configure your AI assistant to use the documentation MCP server The following instructions show how to configure popular AI assistants to use the InfluxDB documentation MCP server. **Claude Desktop:** In **Claude Desktop**, go to **Settings** > **Developer** and edit your configuration. Add the following JSON configuration: ```json { "mcpServers": { "influxdb-docs": { "url": "https://influxdb-docs.mcp.kapa.ai" } } } ``` Save the file and restart Claude Desktop for the changes to take effect. **ChatGPT Desktop:** In **ChatGPT Desktop**, go to **Settings** > **Integrations** > **Enable MCP** and add a new server. Add the following JSON configuration: ```json { "mcpServers": { "influxdb-docs": { "url": "https://influxdb-docs.mcp.kapa.ai", "transport": "sse" } } } ``` Save the configuration and restart ChatGPT Desktop. **GitHub Copilot (VS Code):** In **VS Code**, configure GitHub Copilot to use the MCP server: 1. Create or edit `.vscode/mcp.json` in your workspace or project directory 2. Add the following configuration: ```json { "servers": { "influxdb-docs": { "type": "http", "url": "https://influxdb-docs.mcp.kapa.ai" } } } ``` 3. Restart or reload VS Code 4. Open the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`) 5. Run **MCP: List Servers** to verify the server is registered The InfluxDB documentation MCP server will now be available through GitHub Copilot Chat. **Cursor:** In **Cursor**, add the MCP server configuration to your MCP settings file. 1. Open **Settings** and navigate to **MCP Servers** 2. Click **Add MCP Server** or edit the configuration file directly 3. Add the following configuration to `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (global): ```json { "mcpServers": { "influxdb-docs": { "url": "https://influxdb-docs.mcp.kapa.ai", "transport": "streamableHttp" } } } ``` Save the file and restart Cursor. **OpenCode:** In **OpenCode**, configure the MCP server in your configuration file: 1. Create or edit `opencode.json` (or `opencode.jsonc`) in your workspace 2. Add the following configuration: ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "influxdb-docs": { "type": "remote", "url": "https://influxdb-docs.mcp.kapa.ai", "enabled": true } } } ``` 3. Start OpenCode and use the `/init` command to verify the MCP server is accessible The InfluxDB documentation search tools will be available in your OpenCode sessions. ### Authentication and rate limits When you connect to the documentation MCP server for the first time, a sign-in window opens where you can choose to authenticate with a **Google** or **GitHub** account. The hosted MCP server uses your account only to generate a stable, opaque user ID for rate limiting—no personal data is collected: - **Google**: Requests only the `openid` scope. Does not request `email` or `profile` scopes—your name, email address, and other personal data are not collected. - **GitHub**: Requests no OAuth scopes. With no scopes requested, GitHub grants read-only access to public profile information only. The server does not access repositories, organizations, email addresses, or other GitHub data. The anonymous user ID enforces per-user rate limits to prevent abuse: - **40 requests** per user per hour - **200 requests** per user per day If you sign in with Google, the consent screen may display “Associate you with your personal info on Google.” This is Google’s generic wording for the `openid` scope—it means the app can recognize that the same Google account is signing in again. It does not grant access to your email, name, contacts, or other data. ### Search documentation with the MCP tool The documentation MCP server exposes a semantic search tool: ```text search_influxdb_knowledge_sources ``` This tool lets AI agents perform semantic retrieval over InfluxDB documentation and related knowledge sources. **What the tool does:** - Searches all InfluxDB documentation for a given query - Returns the most relevant chunks in descending order of relevance - Each chunk is a self-contained snippet from a single documentation page **Response format:** Each result includes: - `source_url`: URL of the original documentation page - `content`: The chunk content in Markdown ![MCP tool search results showing InfluxDB documentation](/img/influxdb3/core-mcp-influxdb3-plugin.png) ### Use the documentation MCP server After you install the documentation MCP server, your AI assistant can search InfluxDB documentation to help you with tasks. Ask questions naturally—the assistant uses the MCP server to find relevant documentation and provide accurate answers. #### Example prompts > “How do I write data to InfluxDB using Python?” > > “What’s the syntax for a SQL query with a WHERE clause in InfluxDB?” > > “Show me how to configure Telegraf to collect CPU metrics.” > > “What environment variables does the InfluxDB CLI use?” > > “How do I create a database token with read-only permissions?” #### Related - [InfluxDB 3 MCP Server GitHub Repository](https://github.com/influxdata/influxdb3_mcp_server)