Cursor + Knowi MCP Setup

Connect Cursor to Knowi's MCP server. Once connected, you can query data, manage dashboards, create reports, and more - directly from Cursor's AI chat.

Prerequisites

  • Cursor with MCP support (v0.45+)
  • Knowi account with AI Agents enabled

Option A: OAuth Browser Auth (Recommended)

The easiest way to connect ? no token copy/paste needed.

  1. Open Cursor > Settings > Cursor Settings.
  2. Click Tools & Integrations, then New MCP Server.
  3. Paste the following into the mcp.json file:

    {
      "mcpServers": {
        "knowi": {
          "url": "https://www.knowi.com/api/2.0/mcp"
        }
      }
    }
    
  4. Save. The first time you use the connection, Cursor will open your browser to sign in to Knowi and authorize access.

Instance URL: Use the URL that matches your Knowi deployment:

  • Knowi Cloud (default): https://www.knowi.com
  • EU Cloud: https://eu.knowi.com
  • On-Premise: Your on-premise Knowi URL (e.g. https://knowi.yourcompany.com)

Option B: Manual Token

If you prefer to manage the token manually:

  1. Log into Knowi. Navigate to Settings > AI Settings.
  2. Under MCP Token, select a token expiry and click Generate Token. Copy the token.
  3. In Cursor, open Settings > Tools & Integrations > New MCP Server and paste:

    {
      "mcpServers": {
        "knowi": {
          "url": "https://www.knowi.com/api/2.0/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_MCP_TOKEN"
          }
        }
      }
    }
    
  4. Replace YOUR_MCP_TOKEN with the token and save.

Verify

In Cursor's chat panel, switch to Agent mode and ask:

"What Knowi tools are available?"

You should see the full list of Knowi tools including knowi_do, knowi_ask, knowi_list_dashboards, and others.

Usage

Once connected, use Agent mode in Cursor's chat to interact with Knowi:

"Show me my Knowi dashboards"
"Ask Knowi: what were our top customers by revenue last month?"
"Export Knowi dashboard 67890 to PDF"

Cursor will prompt you to approve each tool call. You can click Allow once or Allow always for trusted tools.

Troubleshooting

Server shows red status

  1. Verify your token is valid:

    curl -H "Authorization: Bearer YOUR_MCP_TOKEN" \
      https://www.knowi.com/api/2.0/mcp/tools
    
  2. Check that the Knowi instance is reachable from your machine.

  3. Click the refresh icon next to the server entry.

"Permission denied" errors

Verify the user whose token you are using has access to the requested resources in Knowi.

Token expired

Generate a new token from Settings > AI Settings > MCP Token, then update the token in Cursor's mcp.json.

For full tool documentation, see MCP Server.