> ## Documentation Index
> Fetch the complete documentation index at: https://www.getsoundlink.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Cursor

> Install the Soundlink Cursor plugin and connect with an API key.

The Soundlink Cursor plugin calls the hosted MCP server at `https://api.getsoundlink.com/mcp`. Access is read-only. Auth is an API key — Cursor stores it for you after you paste it.

## 1. Create an API key

Go to [Settings → Developer → API keys](https://getsoundlink.com/settings/developer). Create a key with `campaigns:read`, `metrics:read`, `soundlinks:read`, and `wallet:read`. Add `pixels:read` if you need `get_pixels`. Copy the `sk_` secret once — you cannot reveal it again.

Details: [Authentication](https://www.getsoundlink.com/docs/authentication.md).

## 2. Install the plugin

Cursor loads a local plugin from `~/.cursor/plugins/local`. Clone the official connectors repo and copy the plugin files into that path:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
git clone https://github.com/Fan-ID/soundlink-mcp-connectors.git
rm -rf ~/.cursor/plugins/local/soundlink
mkdir -p ~/.cursor/plugins/local/soundlink/.cursor-plugin
cp soundlink-mcp-connectors/.cursor-plugin/plugin.json ~/.cursor/plugins/local/soundlink/.cursor-plugin/
cp soundlink-mcp-connectors/mcp.json ~/.cursor/plugins/local/soundlink/
cp -R soundlink-mcp-connectors/skills ~/.cursor/plugins/local/soundlink/
```

Reload the window (**Developer: Reload Window**). Open **Customize**, turn on the `soundlink` server, open **Configure**, and paste the API key. Do not put the key in the repo.

> [!NOTE]
>
> On Enterprise, local plugins stay hidden until an admin enables **Allow Local
> Plugin Imports** under **Dashboard → Settings → Security & Identity →
> Marketplace and Plugins**.

## 3. Check the connection

Ask Cursor to call `ping`. A working credential returns `{"status":"ok"}`. Then ask for a campaign list. For the full tool list and scopes, see the [MCP overview](https://www.getsoundlink.com/docs/mcp-server.md#tools).

## Manual JSON fallback

To wire Cursor without the plugin, open **Cursor Settings → MCP → Add new global MCP server** and use the API key JSON on [Other clients](https://www.getsoundlink.com/docs/mcp-other-clients.md).

## Next

[MCP overview](https://www.getsoundlink.com/docs/mcp-server.md) · [Claude](https://www.getsoundlink.com/docs/mcp-claude.md) · [Other clients](https://www.getsoundlink.com/docs/mcp-other-clients.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.