Setup by IDE

Connect the Luciq MCP Server to Cursor, Claude Code, Claude Desktop, VS Code, or any MCP client. OAuth handles authentication for you.

Connect Luciq MCP to your IDE. OAuth handles authentication automatically - just add the server URL and approve access in your browser.

Your dashboard has the latest setup instructions. Go to Account Management > Luciq MCP in your Luciq dashboard for per-client setup guides tailored to your account, including a one-click Connect option for Cursor.

Server URL

https://api.luciq.ai/api/mcp

---

Cursor

Create or edit ~/.cursor/mcp.json with the following configuration:

{
  "mcpServers": {
    "luciq": {
      "url": "https://api.luciq.ai/api/mcp"
    }
  }
}

Or use the Connect button on your dashboard's Luciq MCP settings page to open Cursor and install the Luciq MCP server directly.

Cursor Connect button on the Luciq MCP dashboard

---

Claude Code

Run the following command in your terminal:

claude mcp add --transport http luciq https://api.luciq.ai/api/mcp

The OAuth flow will open your browser automatically for authorization.

---

VS Code / GitHub Copilot

Open Command Palette (Cmd+Shift+P) > MCP: Add Server > select HTTP > paste the server URL:

https://api.luciq.ai/api/mcp

---

Claude Desktop

Copy the configuration below into your claude_desktop_config.json file:

{
  "mcpServers": {
    "luciq": {
      "url": "https://api.luciq.ai/api/mcp"
    }
  }
}

Config file location:

Platform	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Prefer a connector over a config file? You can add Luciq to the Claude apps as a custom connector, including provisioning it for your whole organization in one step. See Set Up the Claude Connector.

---

Other MCP Clients

Any client that supports the MCP standard can connect to Luciq. Add the server URL as a remote MCP server in your client's settings:

https://api.luciq.ai/api/mcp

Your client will initiate a connection and open an OAuth authorization in your browser. Log in with your Luciq account and grant access.

---

Verifying Your Connection

After setup, try this prompt in your IDE:

"List my applications"

If you see your Luciq apps listed, you're connected and ready to go.

If the connection isn't working, check the FAQ & Troubleshooting page for common issues and IDE-specific fixes.

---

Using Token-Based Auth Instead of OAuth

If you're in an environment where interactive OAuth isn't practical (CI/CD pipelines, remote terminals over SSH, automated workflows), you can use token-based authentication. See Authentication & Security for setup instructions.