Connecting to Claude

This page is the technical setup guide for using Fluent with Claude Desktop and Claude Code.

If you want the plain-language overview first, start here:

• Using Fluent with AI Apps

Today, the documented path is Fluent OSS. Fluent Cloud setup docs will be published when the cloud product is ready.

Claude Desktop

Fluent OSS

1. Generate the config automatically:

npm run scaffold:mcp -- --client claude --track oss \
  --base-url http://127.0.0.1:8788

2. Or write the config directly to a file:

npm run scaffold:mcp -- --client claude --track oss \
  --base-url http://127.0.0.1:8788 \
  --out ~/.claude/fluent.mcp.json

3. The generated config includes your bearer token (resolved from ~/.fluent/):

{
  "mcpServers": {
    "fluent": {
      "url": "http://127.0.0.1:8788/mcp",
      "headers": {
        "Authorization": "Bearer <your-oss-token>"
      }
    }
  }
}

4. Restart Claude Desktop to pick up the new server.

Claude Code

Fluent OSS

npm run scaffold:mcp -- --client claude --track oss \
  --base-url http://127.0.0.1:8788

Verifying the Connection

Once connected, ask Claude:

"What are my Fluent capabilities?"

Claude will call fluent_get_capabilities and show you:

• Contract version
• Available, enabled, and ready domains
• Onboarding state
• Profile summary
• Tool discovery hints

First Use

If no domains are enabled yet:

"Enable the meals domain"

Claude will call fluent_enable_domain, begin onboarding, and walk you through setting your preferences. The same flow works for Health and Style.

Troubleshooting

Tools not appearing

• Reconnect the MCP server in Claude settings
• Verify Fluent is running: curl http://127.0.0.1:8788/health
• Check your bearer token is correct

Stale tools after endpoint change

If you change the Fluent endpoint:

1. Reconnect the MCP server
2. Re-authorize if prompted
3. Remove stale credentials for the old endpoint if Claude keeps showing the previous tool set