Connecting to Claude Desktop

Edge MCP access is available on the Edge plan.

Flux exposes an MCP server at https://fluxgraph.app/mcp. Once connected, Claude Desktop can query your post history, run the scoring model against a draft, look up prospect briefs, and manage your research streams — all in natural language.

What you'll need

An Edge plan subscription
Claude Desktop installed (macOS or Windows)
A Flux API key (generated from Settings)

Setup

1. Generate an API key

Go to Settings → API Keys and click Generate. The key is shown exactly once — copy it immediately. Keys start with flux_. You can revoke and regenerate at any time; revoking a key doesn't affect your Flux data.

2. Edit your Claude Desktop config

Open the Claude Desktop config file:

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

Add the flux server block inside mcpServers:

{
  "mcpServers": {
    "flux": {
      "type": "http",
      "url": "https://fluxgraph.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key you copied from Settings.

3. Restart Claude Desktop

Fully quit and relaunch Claude Desktop — it picks up new MCP servers on boot. In the chat composer you should see a tools indicator showing flux is connected.

4. Verify it's working

Ask Claude: "List my tracked LinkedIn profiles." It will call list_profiles and return the profiles wired to your account. If that works, all other tools are available.

What Claude can do with Flux

Once connected, you can ask Claude to:

Analyze your post history and engagement trends
Score a draft before you publish it
Find posts similar to a topic you're writing about
Research a LinkedIn profile or prospect before reaching out
Pull recent posts from a research stream
Manage collections and audience segments
Check your credit balance and usage

Most analytics tools are free. Tools that call external APIs (LinkedIn lookups, suggest_angles, save_post, stream runs, constellation mapping) consume credits.

Tips

For Claude Code: Use the one-liner instead of editing the config file manually:

claude mcp add --transport http --scope user flux \
  https://fluxgraph.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

For Cursor or Zed: Drop the same JSON block into a .mcp.json file at the root of your project, or into the client's MCP config directory.

Scope your queries to a profile first. Ask list_profiles to get your profile IDs, then reference them in subsequent questions. This makes Claude's tool calls faster and more accurate.

The API key authenticates the request — only your data is accessible. No other user's data can be reached with your key.

Troubleshooting

Claude says it can't find the Flux tools. Make sure you fully quit and relaunched Claude Desktop (not just closed the window). Check that the config file is valid JSON.

401 error. Your key is missing, malformed, or was revoked. Generate a new key from Settings → API Keys.

402 insufficient_credits. A tool you asked Claude to run costs credits and your balance is too low. Ask Claude to run get_cost_estimate before expensive operations, or check your balance with get_credit_balance.

For the full list of available tools and their inputs, see MCP / API Access.

On this page