Taufinity Studio

Appearance

Connect Cursor to Taufinity Studio ​

Cursor speaks remote MCP natively. After installing, Cursor's chat can call Taufinity tools directly — query dashboards, run BigQuery insights, look up knowledge files — without leaving the IDE.

30-second TL;DR ​

  1. Obtain your bearer token from Studio → Settings → API Keys.
  2. Add the server entry to ~/.cursor/mcp.json (see Installation).
  3. Restart Cursor, open chat, ask "list my Taufinity sites".

Prerequisites ​

  • Cursor version 0.42 or later. Check via Cursor → Help → About.
  • The taufinity CLI signed in:
bash
taufinity version
taufinity auth login

Installation ​

Option 1: One-command install

taufinity mcp install --client cursor

Config file location

  • macOS: ~/.cursor/mcp.json (user) or <project>/.cursor/mcp.json (project)
  • Linux: ~/.cursor/mcp.json (user) or <project>/.cursor/mcp.json (project)
  • Windows: %USERPROFILE%\.cursor\mcp.json (user) or <project>\.cursor\mcp.json (project)

Option 2: Manual install — paste this snippet

{
  "mcpServers": {
    "taufinity": {
      "type": "http",
      "url": "https://studio.taufinity.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TAUFINITY_TOKEN>"
      }
    }
  }
}

Manual config ​

Edit (or create) ~/.cursor/mcp.json for user scope, or <project>/.cursor/mcp.json for project scope:

json
{
  "mcpServers": {
    "taufinity-studio": {
      "type": "http",
      "url": "https://studio.taufinity.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TAUFINITY_TOKEN"
      }
    }
  }
}

Get your token from Studio → Settings → API Keys or with taufinity auth token (if the CLI is installed).

Verify it works ​

Verify it works

Restart Cursor, open chat, ask "list my Taufinity sites".

In Cursor's chat panel you'll see a tool-use chip when Taufinity tools are called.

Available tools ​

Same ~70 tools as Claude Code. See the Claude Code page for the full list.

Troubleshooting ​

SymptomCauseFix
Cursor doesn't show the Taufinity serverConfig in wrong scope (user vs project)Confirm which file Cursor is reading; the install command supports --scope project
tools/list 401Token expiredRe-run taufinity auth login, restart Cursor
Cursor 0.41 or earlier doesn't support remote MCPOutdated CursorUpdate Cursor to 0.42+

FAQ ​

Project scope vs user scope? Project scope (<project>/.cursor/mcp.json) keeps the config inside the repo — committable to git so the whole team gets the same MCP config. User scope (~/.cursor/mcp.json) applies to all your Cursor projects. Use project scope when different repos point at different Studio orgs.

Token in committed config? No. The install command writes a placeholder; the actual token is read from your user-scope taufinity CLI config. If you commit the project file to git, only the placeholder ships.

See also ​