Saltar al contenido principal

Connect Flowpos to Claude Desktop

Before you start​

  • Claude Desktop must be installed (download here)
  • This works on Mac and Windows only — not on iPhone, iPad, or Android

Step 1 — Install Node.js​

Node.js is a small program that Claude needs to connect to Flowpos.

Mac: Download and install from nodejs.org — click the LTS button.

Windows: Same — download the LTS installer from nodejs.org and run it.

After installing, you don't need to open or use Node.js — it just needs to be on your computer.

Step 2 — Get your Flowpos token​

  1. Log into your Flowpos dashboard
  2. Go to Settings → AI Assistant
  3. Click Generate Token and copy it — it's a long string of letters and numbers

Step 3 — Open the Claude Desktop config file​

Mac:

  1. Open Claude Desktop
  2. In the top menu bar, click Claude → Settings
  3. Click the Developer tab
  4. Click Edit Config

Windows:

  1. Open Claude Desktop
  2. Click the ☰ menu (top left) → Settings
  3. Click the Developer tab
  4. Click Edit Config

This opens a file called claude_desktop_config.json in a text editor (Notepad on Windows, TextEdit on Mac).

Step 4 — Add Flowpos to the config​

You'll see some text already in the file. You need to add the Flowpos section inside "mcpServers": { }.

If the file looks like this (no mcpServers yet):

{
  "mcpServers": {}
}

Replace it with:

{
  "mcpServers": {
    "Flowpos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.flowpos.app/mcp",
        "--header",
        "Authorization: Bearer PASTE_YOUR_TOKEN_HERE"
      ]
    }
  }
}

If the file already has other servers, add the Flowpos block inside the existing mcpServers section.

Replace PASTE_YOUR_TOKEN_HERE with the token you copied in Step 2.

Save the file.

Step 5 — Restart Claude Desktop​

Fully quit Claude Desktop (don't just close the window):

  • Mac: Right-click the Claude icon in the Dock → Quit
  • Windows: Right-click the Claude icon in the system tray (bottom right) → Exit

Reopen Claude Desktop. You should now see a 🔨 hammer icon in the chat input — that means Flowpos is connected.

Something not working?​

  • Double-check the token was pasted correctly with no extra spaces
  • Make sure you saved the file before restarting
  • Contact Flowpos support at support@flowpos.app

Advanced: If you use nvm (Node Version Manager)​

If you manage Node.js through nvm, Claude Desktop may not find the right version automatically. You'll see an error in the logs mentioning a Node version mismatch or a syntax error.

Fix: Find your active Node path and hardcode it in the config.

  1. Open Terminal and run:

    which npx

    It will return something like:

    /Users/yourname/.nvm/versions/node/v22.13.1/bin/npx

  2. Copy that full path and use it as the command in your config, and add an env block to make sure the same Node version is used throughout:

{
  "mcpServers": {
    "Flowpos": {
      "command": "/Users/yourname/.nvm/versions/node/v22.13.1/bin/npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.flowpos.app/mcp",
        "--header",
        "Authorization: Bearer PASTE_YOUR_TOKEN_HERE"
      ],
      "env": {
        "PATH": "/Users/yourname/.nvm/versions/node/v22.13.1/bin:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin"
      }
    }
  }
}

Replace /Users/yourname/.nvm/versions/node/v22.13.1 with the actual path returned by which npx.