Connecting to Luce MCP
How to connect Claude, Claude Code, Cursor, ChatGPT, and other MCP clients to the Luce AI server
All MCP clients connect to Luce through the same endpoint. Authentication happens automatically via OAuth — a browser window opens for you to log in, no API keys needed.
Authentication
Luce uses OAuth 2.1. On first connect, your client will open a browser window where you log in (or sign up) and click Allow to grant access. Tokens are managed automatically.
Connection Details
| Field | Value |
|---|---|
| Transport | Streamable HTTP |
| Endpoint | https://mcp.luce.sh/mcp |
| Auth | OAuth 2.1 (automatic, browser-based) |
Client Configuration
Verifying the Connection
Once connected, test with a simple tool call:
list_projectsYou should receive a JSON array of your projects. If you see an authentication error, disconnect and reconnect the MCP server in your client to re-trigger the OAuth flow.
Available Resources
In addition to tools, the Luce MCP server exposes two read-only resources that clients can access:
| Resource URI | Description |
|---|---|
luce://workflows | Full list of available workflow types with descriptions and parameters |
luce://credit-costs | Credit cost table for each workflow type |
MCP clients that support resource reading (such as Claude Desktop) will automatically discover these. You can also reference them when deciding which workflow to launch.
Next Steps
- Quickstart — create your first project and run a workflow
- Workflow Guide — understand the workflow system and dependencies
- MCP Tools Reference — browse all 37 tools by category