Cursor

Cursor reads MCP servers from project config at .cursor/mcp.json, or from global config at ~/.cursor/mcp.json. Merge Fluos with any servers you already have — do not replace the file.

One-prompt setup

Paste this into Cursor:

Connect this Cursor project to the Fluos Video MCP.

Create or update .cursor/mcp.json with this server, preserving every existing MCP entry:
{
  "mcpServers": {
    "fluos": {
      "url": "https://www.fluos.io/api/v1/mcp/app",
      "auth": {
        "CLIENT_ID": "vZg47Po1X1v3rHtU"
      }
    }
  }
}

After saving, verify that Fluos appears in Cursor Settings > Tools & MCP. If browser OAuth is required, pause and tell me what to approve. Once connected, use Fluos to list my workspaces.

Manual fallback

Project config (.cursor/mcp.json) or global config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "fluos": {
      "url": "https://www.fluos.io/api/v1/mcp/app",
      "auth": {
        "CLIENT_ID": "vZg47Po1X1v3rHtU"
      }
    }
  }
}

Then:

1. Save the file.
2. Open Cursor Settings → Tools & MCP.
3. Enable fluos.
4. Complete the browser sign-in.

auth.CLIENT_ID is Fluos's public Clerk OAuth client. There is no client secret.

Verify

Fluos should appear under Tools & MCP as an enabled HTTP server. Ask Cursor to list your Fluos workspaces. If that fails with 401, reopen Tools & MCP and finish OAuth.

Optional: Docs MCP

Add a second entry. Keep fluos for video work:

{
  "mcpServers": {
    "fluos": {
      "url": "https://www.fluos.io/api/v1/mcp/app",
      "auth": {
        "CLIENT_ID": "vZg47Po1X1v3rHtU"
      }
    },
    "fluos-docs": {
      "url": "https://www.fluos.io/api/v1/mcp"
    }
  }
}

No login on fluos-docs. That server cannot create videos. See Docs MCP.

If it will not connect

• Confirm the URL is /api/v1/mcp/app, not the public docs server.
• If the agent overwrote other MCP entries, restore them and merge only the fluos key.
• Free plans receive PLAN_REQUIRED. See OAuth and access.
• Reload the Cursor window if Fluos does not appear after saving.

Next: run a first video.