Skip to content
Stepwik

Developers

Cursor

Connect Stepwik MCP in Cursor with mcp.json and an API key.

Connect Stepwik to Cursor so Agent can search labs, draft private content, and open Studio URLs.

Steps

  1. Create an API key

    Create an API key in Studio and copy the secret.

  2. Open mcp.json

    Open or create ~/.cursor/mcp.json.

  3. Paste the config

    Paste the config below and replace stepwik_<id>_<secret> with your real key.

  4. Reload MCP

    Reload MCP in Cursor Settings → MCP (toggle the server off/on).

Config path

text
~/.cursor/mcp.json

Config

json
{
  "mcpServers": {
    "stepwik": {
      "url": "https://mcp.stepwik.com/mcp",
      "headers": {
        "stepwik-api-key": "stepwik_<id>_<secret>"
      }
    }
  }
}

Multi-workspace (optional)

json
{
  "mcpServers": {
    "stepwik-organization": {
      "url": "https://mcp.stepwik.com/mcp?account=organization",
      "headers": {
        "stepwik-api-key": "stepwik_<org_key>"
      }
    },
    "stepwik-personal": {
      "url": "https://mcp.stepwik.com/mcp?account=personal",
      "headers": {
        "stepwik-api-key": "stepwik_<personal_key>"
      }
    }
  }
}

Verify

Ask Agent: “Who am I authenticated as in Stepwik?” You should get account / org context from whoami.

Image preview

Scroll to zoom · Drag to pan · Double-click to toggle · Esc to close