Setup by IDE

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

---

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.